Gecko [ tsuru-no-tsurugi.tokyo ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-12-31 20:40
__init__.py	5.67 KB	-rw-r--r--	2025-09-23 04:44
__main__.py	8.6 KB	-rw-r--r--	2025-09-23 04:44
_cell_widths.py	9.86 KB	-rw-r--r--	2025-09-23 04:44
_emoji_codes.py	136.95 KB	-rw-r--r--	2025-09-23 04:44
_emoji_replace.py	1.04 KB	-rw-r--r--	2025-09-23 04:44
_extension.py	265 B	-rw-r--r--	2025-09-23 04:44
_inspect.py	7.27 KB	-rw-r--r--	2025-09-23 04:44
_log_render.py	3.15 KB	-rw-r--r--	2025-09-23 04:44
_loop.py	1.21 KB	-rw-r--r--	2025-09-23 04:44
_lru_cache.py	1.22 KB	-rw-r--r--	2025-09-23 04:44
_palettes.py	6.9 KB	-rw-r--r--	2025-09-23 04:44
_pick.py	423 B	-rw-r--r--	2025-09-23 04:44
_ratio.py	5.34 KB	-rw-r--r--	2025-09-23 04:44
_spinners.py	25.9 KB	-rw-r--r--	2025-09-23 04:44
_stack.py	351 B	-rw-r--r--	2025-09-23 04:44
_timer.py	417 B	-rw-r--r--	2025-09-23 04:44
_windows.py	2.02 KB	-rw-r--r--	2025-09-23 04:44
_wrap.py	1.76 KB	-rw-r--r--	2025-09-23 04:44
abc.py	890 B	-rw-r--r--	2025-09-23 04:44
align.py	10.18 KB	-rw-r--r--	2025-09-23 04:44
ansi.py	6.52 KB	-rw-r--r--	2025-09-23 04:44
bar.py	3.19 KB	-rw-r--r--	2025-09-23 04:44
box.py	8.86 KB	-rw-r--r--	2025-09-23 04:44
cells.py	4.18 KB	-rw-r--r--	2025-09-23 04:44
color.py	16.88 KB	-rw-r--r--	2025-09-23 04:44
color_triplet.py	1.03 KB	-rw-r--r--	2025-09-23 04:44
columns.py	6.96 KB	-rw-r--r--	2025-09-23 04:44
console.py	79.33 KB	-rw-r--r--	2025-09-23 04:44
constrain.py	1.26 KB	-rw-r--r--	2025-09-23 04:44
containers.py	5.37 KB	-rw-r--r--	2025-09-23 04:44
control.py	5.17 KB	-rw-r--r--	2025-09-23 04:44
default_styles.py	7.44 KB	-rw-r--r--	2025-09-23 04:44
diagnose.py	183 B	-rw-r--r--	2025-09-23 04:44
emoji.py	2.44 KB	-rw-r--r--	2025-09-23 04:44
errors.py	642 B	-rw-r--r--	2025-09-23 04:44
file_proxy.py	1.58 KB	-rw-r--r--	2025-09-23 04:44
filesize.py	2.45 KB	-rw-r--r--	2025-09-23 04:44
highlighter.py	4.78 KB	-rw-r--r--	2025-09-23 04:44
json.py	4.93 KB	-rw-r--r--	2025-09-23 04:44
jupyter.py	2.95 KB	-rw-r--r--	2025-09-23 04:44
layout.py	13.72 KB	-rw-r--r--	2025-09-23 04:44
live.py	13.39 KB	-rw-r--r--	2025-09-23 04:44
live_render.py	3.58 KB	-rw-r--r--	2025-09-23 04:44
logging.py	10.61 KB	-rw-r--r--	2025-09-23 04:44
markup.py	7.87 KB	-rw-r--r--	2025-09-23 04:44
measure.py	5.13 KB	-rw-r--r--	2025-09-23 04:44
padding.py	4.85 KB	-rw-r--r--	2025-09-23 04:44
pager.py	838 B	-rw-r--r--	2025-09-23 04:44
palette.py	3.32 KB	-rw-r--r--	2025-09-23 04:44
panel.py	8.43 KB	-rw-r--r--	2025-09-23 04:44
pretty.py	31.81 KB	-rw-r--r--	2025-09-23 04:44
progress.py	35.08 KB	-rw-r--r--	2025-09-23 04:44
progress_bar.py	7.58 KB	-rw-r--r--	2025-09-23 04:44
prompt.py	11.04 KB	-rw-r--r--	2025-09-23 04:44
protocol.py	1.37 KB	-rw-r--r--	2025-09-23 04:44
region.py	166 B	-rw-r--r--	2025-09-23 04:44
repr.py	4.21 KB	-rw-r--r--	2025-09-23 04:44
rule.py	4.1 KB	-rw-r--r--	2025-09-23 04:44
scope.py	2.78 KB	-rw-r--r--	2025-09-23 04:44
screen.py	1.55 KB	-rw-r--r--	2025-09-23 04:44
segment.py	23.36 KB	-rw-r--r--	2025-09-23 04:44
spinner.py	4.21 KB	-rw-r--r--	2025-09-23 04:44
status.py	4.32 KB	-rw-r--r--	2025-09-23 04:44
style.py	25.85 KB	-rw-r--r--	2025-09-23 04:44
styled.py	1.23 KB	-rw-r--r--	2025-09-23 04:44
syntax.py	26.36 KB	-rw-r--r--	2025-09-23 04:44
table.py	35.9 KB	-rw-r--r--	2025-09-23 04:44
tabulate.py	1.66 KB	-rw-r--r--	2025-09-23 04:44
terminal_theme.py	1.42 KB	-rw-r--r--	2025-09-23 04:44
text.py	43.38 KB	-rw-r--r--	2025-09-23 04:44
theme.py	3.54 KB	-rw-r--r--	2025-09-23 04:44
themes.py	102 B	-rw-r--r--	2025-09-23 04:44
traceback.py	25.33 KB	-rw-r--r--	2025-09-23 04:44
tree.py	8.91 KB	-rw-r--r--	2025-09-23 04:44

Rename

from functools import lru_cache
import re
from typing import Dict, List

from ._cell_widths import CELL_WIDTHS
from ._lru_cache import LRUCache

# Regex to match sequence of the most common character ranges
_is_single_cell_widths = re.compile("^[\u0020-\u006f\u00a0\u02ff\u0370-\u0482]*$").match

def cell_len(text: str, _cache: Dict[str, int] = LRUCache(1024 * 4)) -> int:
    """Get the number of cells required to display text.

Args:
        text (str): Text to display.

Returns:
        int: Get the number of cells required to display text.
    """

if _is_single_cell_widths(text):
        return len(text)
    else:
        cached_result = _cache.get(text, None)
        if cached_result is not None:
            return cached_result
        _get_size = get_character_cell_size
        total_size = sum(_get_size(character) for character in text)
        if len(text) <= 64:
            _cache[text] = total_size
    return total_size

@lru_cache(maxsize=4096)
def get_character_cell_size(character: str) -> int:
    """Get the cell size of a character.

Args:
        character (str): A single character.

Returns:
        int: Number of cells (0, 1 or 2) occupied by that character.
    """
    if _is_single_cell_widths(character):
        return 1

return _get_codepoint_cell_size(ord(character))

@lru_cache(maxsize=4096)
def _get_codepoint_cell_size(codepoint: int) -> int:
    """Get the cell size of a character.

Args:
        character (str): A single character.

Returns:
        int: Number of cells (0, 1 or 2) occupied by that character.
    """

_table = CELL_WIDTHS
    lower_bound = 0
    upper_bound = len(_table) - 1
    index = (lower_bound + upper_bound) // 2
    while True:
        start, end, width = _table[index]
        if codepoint < start:
            upper_bound = index - 1
        elif codepoint > end:
            lower_bound = index + 1
        else:
            return 0 if width == -1 else width
        if upper_bound < lower_bound:
            break
        index = (lower_bound + upper_bound) // 2
    return 1

def set_cell_size(text: str, total: int) -> str:
    """Set the length of a string to fit within given number of cells."""

if _is_single_cell_widths(text):
        size = len(text)
        if size < total:
            return text + " " * (total - size)
        return text[:total]

if not total:
        return ""
    cell_size = cell_len(text)
    if cell_size == total:
        return text
    if cell_size < total:
        return text + " " * (total - cell_size)

start = 0
    end = len(text)

# Binary search until we find the right size
    while True:
        pos = (start + end) // 2
        before = text[: pos + 1]
        before_len = cell_len(before)
        if before_len == total + 1 and cell_len(before[-1]) == 2:
            return before[:-1] + " "
        if before_len == total:
            return before
        if before_len > total:
            end = pos
        else:
            start = pos

# TODO: This is inefficient
# TODO: This might not work with CWJ type characters
def chop_cells(text: str, max_size: int, position: int = 0) -> List[str]:
    """Break text in to equal (cell) length strings."""
    _get_character_cell_size = get_character_cell_size
    characters = [
        (character, _get_character_cell_size(character)) for character in text
    ][::-1]
    total_size = position
    lines: List[List[str]] = [[]]
    append = lines[-1].append

pop = characters.pop
    while characters:
        character, size = pop()
        if total_size + size > max_size:
            lines.append([character])
            append = lines[-1].append
            total_size = size
        else:
            total_size += size
            append(character)
    return ["".join(line) for line in lines]

if __name__ == "__main__":  # pragma: no cover

print(get_character_cell_size("😽"))
    for line in chop_cells("""这是对亚洲语言支持的测试。面对模棱两可的想法，拒绝猜测的诱惑。""", 8):
        print(line)
    for n in range(80, 1, -1):
        print(set_cell_size("""这是对亚洲语言支持的测试。面对模棱两可的想法，拒绝猜测的诱惑。""", n) + "|")
        print("x" * n)