PHP 8.2.30
Preview: utils.py Size: 2.39 KB
//opt/alt/python313/lib64/python3.13/_pyrepl/utils.py

import re
import unicodedata
import functools

from .types import CharBuffer, CharWidths
from .trace import trace

ANSI_ESCAPE_SEQUENCE = re.compile(r"\x1b\[[ -@]*[A-~]")
ZERO_WIDTH_BRACKET = re.compile(r"\x01.*?\x02")
ZERO_WIDTH_TRANS = str.maketrans({"\x01": "", "\x02": ""})


@functools.cache
def str_width(c: str) -> int:
    if ord(c) < 128:
        return 1
    # gh-139246 for zero-width joiner and combining characters
    if unicodedata.combining(c):
        return 0
    category = unicodedata.category(c)
    if category == "Cf" and c != "\u00ad":
        return 0
    w = unicodedata.east_asian_width(c)
    if w in ("N", "Na", "H", "A"):
        return 1
    return 2


def wlen(s: str) -> int:
    if len(s) == 1 and s != "\x1a":
        return str_width(s)
    length = sum(str_width(i) for i in s)
    # remove lengths of any escape sequences
    sequence = ANSI_ESCAPE_SEQUENCE.findall(s)
    ctrl_z_cnt = s.count("\x1a")
    return length - sum(len(i) for i in sequence) + ctrl_z_cnt


def unbracket(s: str, including_content: bool = False) -> str:
    r"""Return `s` with \001 and \002 characters removed.

    If `including_content` is True, content between \001 and \002 is also
    stripped.
    """
    if including_content:
        return ZERO_WIDTH_BRACKET.sub("", s)
    return s.translate(ZERO_WIDTH_TRANS)


def disp_str(buffer: str) -> tuple[CharBuffer, CharWidths]:
    r"""Decompose the input buffer into a printable variant.

    Returns a tuple of two lists:
    - the first list is the input buffer, character by character;
    - the second list is the visible width of each character in the input
      buffer.

    Examples:
    >>> utils.disp_str("a = 9")
    (['a', ' ', '=', ' ', '9'], [1, 1, 1, 1, 1])
    """
    chars: CharBuffer = []
    char_widths: CharWidths = []

    if not buffer:
        return chars, char_widths

    for c in buffer:
        if c == "\x1a":  # CTRL-Z on Windows
            chars.append(c)
            char_widths.append(2)
        elif ord(c) < 128:
            chars.append(c)
            char_widths.append(1)
        elif unicodedata.category(c).startswith("C"):
            c = r"\u%04x" % ord(c)
            chars.append(c)
            char_widths.append(len(c))
        else:
            chars.append(c)
            char_widths.append(str_width(c))
    trace("disp_str({buffer}) = {s}, {b}", buffer=repr(buffer), s=chars, b=char_widths)
    return chars, char_widths

Directory Contents

Dirs: 1 × Files: 26

Name Size Perms Modified Actions
- drwxr-xr-x 2026-02-10 08:06:26
Edit Download
3.75 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
12.01 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
9.81 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
6.71 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
1.21 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
2.51 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
12.93 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
3.69 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
6.31 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
1.89 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
870 B lrw-r--r-- 2025-12-05 16:06:33
Edit Download
5.68 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
27.06 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
19.75 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
5.66 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
433 B lrw-r--r-- 2026-01-10 10:39:00
Edit Download
354 B lrw-r--r-- 2026-01-10 10:39:00
Edit Download
26.09 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
2.46 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
2.39 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
21.11 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
991 B lrw-r--r-- 2026-01-10 10:39:00
Edit Download
1.80 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
2.12 KB lrw-r--r-- 2026-01-10 10:39:00
Edit Download
925 B lrw-r--r-- 2026-01-10 10:39:00
Edit Download
422 B lrw-r--r-- 2026-01-10 10:39:00
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).