Gecko [ www.jobworksschool.com ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-08-05 17:02
__init__.py	5.92 KB	-rw-r--r--	2024-03-04 23:07
__main__.py	8.14 KB	-rw-r--r--	2024-03-04 23:07
_cell_widths.py	9.97 KB	-rw-r--r--	2024-03-04 23:07
_emoji_codes.py	136.95 KB	-rw-r--r--	2024-03-04 23:07
_emoji_replace.py	1.04 KB	-rw-r--r--	2024-03-04 23:07
_export_format.py	2.08 KB	-rw-r--r--	2024-03-04 23:07
_extension.py	241 B	-rw-r--r--	2024-03-04 23:07
_fileno.py	799 B	-rw-r--r--	2024-03-04 23:07
_inspect.py	9.47 KB	-rw-r--r--	2024-03-04 23:07
_log_render.py	3.14 KB	-rw-r--r--	2024-03-04 23:07
_loop.py	1.21 KB	-rw-r--r--	2024-03-04 23:07
_null_file.py	1.35 KB	-rw-r--r--	2024-03-04 23:07
_palettes.py	6.9 KB	-rw-r--r--	2024-03-04 23:07
_pick.py	423 B	-rw-r--r--	2024-03-04 23:07
_ratio.py	5.33 KB	-rw-r--r--	2024-03-04 23:07
_spinners.py	19.45 KB	-rw-r--r--	2024-03-04 23:07
_stack.py	351 B	-rw-r--r--	2024-03-04 23:07
_timer.py	417 B	-rw-r--r--	2024-03-04 23:07
_win32_console.py	22.25 KB	-rw-r--r--	2024-03-04 23:07
_windows.py	1.86 KB	-rw-r--r--	2024-03-04 23:07
_windows_renderer.py	2.69 KB	-rw-r--r--	2024-03-04 23:07
_wrap.py	3.32 KB	-rw-r--r--	2024-03-04 23:07
abc.py	878 B	-rw-r--r--	2024-03-04 23:07
align.py	10.08 KB	-rw-r--r--	2024-03-04 23:07
ansi.py	6.74 KB	-rw-r--r--	2024-03-04 23:07
bar.py	3.19 KB	-rw-r--r--	2024-03-04 23:07
box.py	10.53 KB	-rw-r--r--	2024-03-04 23:07
cells.py	4.67 KB	-rw-r--r--	2024-03-04 23:07
color.py	17.8 KB	-rw-r--r--	2024-03-04 23:07
color_triplet.py	1.03 KB	-rw-r--r--	2024-03-04 23:07
columns.py	6.96 KB	-rw-r--r--	2024-03-04 23:07
console.py	96.78 KB	-rw-r--r--	2024-03-04 23:07
constrain.py	1.26 KB	-rw-r--r--	2024-03-04 23:07
containers.py	5.37 KB	-rw-r--r--	2024-03-04 23:07
control.py	6.45 KB	-rw-r--r--	2024-03-04 23:07
default_styles.py	7.86 KB	-rw-r--r--	2024-03-04 23:07
diagnose.py	924 B	-rw-r--r--	2024-03-04 23:07
emoji.py	2.41 KB	-rw-r--r--	2024-03-04 23:07
errors.py	642 B	-rw-r--r--	2024-03-04 23:07
file_proxy.py	1.64 KB	-rw-r--r--	2024-03-04 23:07
filesize.py	2.45 KB	-rw-r--r--	2024-03-04 23:07
highlighter.py	9.36 KB	-rw-r--r--	2024-03-04 23:07
json.py	4.9 KB	-rw-r--r--	2024-03-04 23:07
jupyter.py	3.15 KB	-rw-r--r--	2024-03-04 23:07
layout.py	13.62 KB	-rw-r--r--	2024-03-04 23:07
live.py	13.94 KB	-rw-r--r--	2024-03-04 23:07
live_render.py	3.57 KB	-rw-r--r--	2024-03-04 23:07
logging.py	11.61 KB	-rw-r--r--	2024-03-04 23:07
markdown.py	25.55 KB	-rw-r--r--	2024-03-04 23:07
markup.py	8.23 KB	-rw-r--r--	2024-03-04 23:07
measure.py	5.18 KB	-rw-r--r--	2024-03-04 23:07
padding.py	4.84 KB	-rw-r--r--	2024-03-04 23:07
pager.py	828 B	-rw-r--r--	2024-03-04 23:07
palette.py	3.21 KB	-rw-r--r--	2024-03-04 23:07
panel.py	10.45 KB	-rw-r--r--	2024-03-04 23:07
pretty.py	34.97 KB	-rw-r--r--	2024-03-04 23:07
progress.py	58.3 KB	-rw-r--r--	2024-03-04 23:07
progress_bar.py	7.97 KB	-rw-r--r--	2024-03-04 23:07
prompt.py	11.03 KB	-rw-r--r--	2024-03-04 23:07
protocol.py	1.33 KB	-rw-r--r--	2024-03-04 23:07
py.typed	0 B	-rw-r--r--	2024-03-04 23:07
region.py	166 B	-rw-r--r--	2024-03-04 23:07
repr.py	4.32 KB	-rw-r--r--	2024-03-04 23:07
rule.py	4.48 KB	-rw-r--r--	2024-03-04 23:07
scope.py	2.76 KB	-rw-r--r--	2024-03-04 23:07
screen.py	1.54 KB	-rw-r--r--	2024-03-04 23:07
segment.py	23.64 KB	-rw-r--r--	2024-03-04 23:07
spinner.py	4.24 KB	-rw-r--r--	2024-03-04 23:07
status.py	4.32 KB	-rw-r--r--	2024-03-04 23:07
style.py	26.44 KB	-rw-r--r--	2024-03-04 23:07
styled.py	1.21 KB	-rw-r--r--	2024-03-04 23:07
syntax.py	34.54 KB	-rw-r--r--	2024-03-04 23:07
table.py	38.71 KB	-rw-r--r--	2024-03-04 23:07
terminal_theme.py	3.29 KB	-rw-r--r--	2024-03-04 23:07
text.py	46.19 KB	-rw-r--r--	2024-03-04 23:07
theme.py	3.69 KB	-rw-r--r--	2024-03-04 23:07
themes.py	102 B	-rw-r--r--	2024-03-04 23:07
traceback.py	28.84 KB	-rw-r--r--	2024-03-04 23:07
tree.py	8.89 KB	-rw-r--r--	2024-03-04 23:07

Rename

from __future__ import annotations

import re
from functools import lru_cache
from typing import Callable

from ._cell_widths import CELL_WIDTHS

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

@lru_cache(4096)
def cached_cell_len(text: str) -> int:
    """Get the number of cells required to display text.

This method always caches, which may use up a lot of memory. It is recommended to use
    `cell_len` over this method.

Args:
        text (str): Text to display.

Returns:
        int: Get the number of cells required to display text.
    """
    _get_size = get_character_cell_size
    total_size = sum(_get_size(character) for character in text)
    return total_size

def cell_len(text: str, _cell_len: Callable[[str], int] = cached_cell_len) -> 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 len(text) < 512:
        return _cell_len(text)
    _get_size = get_character_cell_size
    total_size = sum(_get_size(character) for character in text)
    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.
    """
    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:
        codepoint (int): Codepoint of a 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 total <= 0:
        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

def chop_cells(
    text: str,
    width: int,
) -> list[str]:
    """Split text into lines such that each line fits within the available (cell) width.

Args:
        text: The text to fold such that it fits in the given width.
        width: The width available (number of cells).

Returns:
        A list of strings such that each string in the list has cell width
        less than or equal to the available width.
    """
    _get_character_cell_size = get_character_cell_size
    lines: list[list[str]] = [[]]

append_new_line = lines.append
    append_to_last_line = lines[-1].append

total_width = 0

for character in text:
        cell_width = _get_character_cell_size(character)
        char_doesnt_fit = total_width + cell_width > width

if char_doesnt_fit:
            append_new_line([character])
            append_to_last_line = lines[-1].append
            total_width = cell_width
        else:
            append_to_last_line(character)
            total_width += cell_width

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)