cellstr 0.2.1__py3-none-any.whl

cellstr/_props.py

@@ -0,0 +1,61 @@
+"""Lookup of the embedded Unicode properties: width class, grapheme and emoji data."""
+
+from __future__ import annotations
+
+from bisect import bisect_right
+
+from ._ucd_data import (
+    EMOJI_BIT,
+    EXT_PICT_BIT,
+    GCB_NAMES,
+    INCB_SHIFT,
+    MODIFIER_BIT,
+    RUNS,
+    UNICODE_VERSION,
+    WIDTH_SHIFT,
+)
+
+__all__ = [
+    "AMBIGUOUS",
+    "EMOJI_BIT",
+    "EXT_PICT_BIT",
+    "GCB",
+    "INCB_SHIFT",
+    "MODIFIER_BIT",
+    "UNICODE_VERSION",
+    "WIDTH_SHIFT",
+    "prop",
+]
+
+GCB = {name: index for index, name in enumerate(GCB_NAMES)}
+AMBIGUOUS = 3
+
+
+def _decode(runs: str) -> tuple[list[int], list[int]]:
+    """Expand the run tokens into parallel lists of run starts and property codes."""
+    starts: list[int] = []
+    codes: list[int] = []
+    position = 0
+    for token in runs.split():
+        starts.append(position)
+        codes.append(int(token[:3], 36))
+        position += int(token[3:], 36)
+    if position != 0x110000:
+        raise RuntimeError("embedded Unicode tables do not cover the code space")
+    return starts, codes
+
+
+_STARTS, _CODES = _decode(RUNS)
+_LATIN = tuple(_CODES[bisect_right(_STARTS, cp) - 1] for cp in range(0x300))
+
+
+def prop(cp: int) -> int:
+    """Return the packed property code of code point ``cp``.
+
+    Bits 0-3 hold Grapheme_Cluster_Break (an index into ``GCB_NAMES``), bit 4 is
+    Extended_Pictographic, bits 5-6 Indic_Conjunct_Break, bit 7 Emoji, bit 8
+    Emoji_Modifier and bits 9-10 the width class (0 zero, 1 narrow, 2 wide, 3 ambiguous).
+    """
+    if cp < 0x300:
+        return _LATIN[cp]
+    return _CODES[bisect_right(_STARTS, cp) - 1]

cellstr/_truncate.py

@@ -0,0 +1,130 @@
+"""Width-aware truncation with a suffix at the end, start or middle, and exact fitting."""
+
+from __future__ import annotations
+
+from typing import Literal, NamedTuple
+
+from ._cells import check_tabsize, expand_tabs
+from ._ops import cell_slice, center, check_fill, ljust, rjust, splice
+from ._width import check_ambiguous, text_width
+
+Position = Literal["end", "start", "middle"]
+Align = Literal["left", "right", "center"]
+_POSITIONS = ("end", "start", "middle")
+_ALIGNS = ("left", "right", "center")
+
+
+class Truncation(NamedTuple):
+    """The outcome of ``truncate_detailed``.
+
+    ``text`` is the result, ``width`` the cells it occupies, ``original_width`` the cells
+    the input occupied and ``truncated`` whether anything was cut.
+    """
+
+    text: str
+    width: int
+    original_width: int
+    truncated: bool
+
+
+def truncate_detailed(
+    text: str,
+    width: int,
+    suffix: str = "...",
+    *,
+    position: Position = "end",
+    ambiguous: int = 1,
+    tabsize: int | None = None,
+) -> Truncation:
+    """Shorten ``text`` to at most ``width`` cells and report what happened.
+
+    ``position`` says where the cut goes: ``"end"`` keeps the start, ``"start"`` keeps
+    the end (log tails, right-aligned numbers) and ``"middle"`` keeps both ends (paths,
+    identifiers), giving the odd cell to the left part. The suffix marks the cut. When
+    the suffix alone would not fit, the text is cut to ``width`` with no suffix. Grapheme
+    clusters are never split, so a wide character at the cut may leave the result one
+    cell short. Every escape sequence in the text is kept once, in place; the suffix is
+    inserted as given and must not contain tabs or line breaks.
+
+    >>> truncate_detailed("hello world", 8)
+    Truncation(text='hello...', width=8, original_width=11, truncated=True)
+    """
+    if width < 0:
+        raise ValueError(f"width must be non-negative, not {width}")
+    if position not in _POSITIONS:
+        raise ValueError(f"position must be one of {', '.join(_POSITIONS)}, not {position!r}")
+    if any(ch in suffix for ch in "\t\n\r"):
+        raise ValueError("suffix must not contain tabs or line breaks")
+    check_ambiguous(ambiguous)
+    tabsize = check_tabsize(tabsize)
+    if tabsize is not None:
+        text = expand_tabs(text, tabsize, ambiguous=ambiguous)
+    total = text_width(text, ambiguous)
+    if total <= width:
+        return Truncation(text, total, total, False)
+    room = width - text_width(suffix, ambiguous)
+    if room < 0:  # no room for the suffix: hard cut, and a middle cut becomes an end cut
+        suffix, room = "", width
+        position = "start" if position == "start" else "end"
+    if position == "end":
+        cut = cell_slice(text, 0, room, ambiguous=ambiguous) + suffix
+    elif position == "start":
+        cut = suffix + cell_slice(text, total - room, ambiguous=ambiguous)
+    else:
+        head = (room + 1) // 2
+        cut = splice(text, head, total - (room - head), suffix, ambiguous)
+    return Truncation(cut, text_width(cut, ambiguous), total, True)
+
+
+def truncate(
+    text: str,
+    width: int,
+    suffix: str = "...",
+    *,
+    position: Position = "end",
+    ambiguous: int = 1,
+    tabsize: int | None = None,
+) -> str:
+    """Shorten ``text`` to at most ``width`` cells, marking the cut with ``suffix``.
+
+    ``text`` is returned unchanged when it already fits; with ``tabsize`` set its tabs
+    are expanded first. See ``truncate_detailed`` for the cut positions and the rules.
+
+    >>> truncate("hello world", 8), truncate("/usr/local/lib/python", 12, position="middle")
+    ('hello...', '/usr/...thon')
+    """
+    return truncate_detailed(
+        text, width, suffix, position=position, ambiguous=ambiguous, tabsize=tabsize
+    ).text
+
+
+def fit(
+    text: str,
+    width: int,
+    *,
+    align: Align = "left",
+    suffix: str = "...",
+    position: Position = "end",
+    fillchar: str = " ",
+    ambiguous: int = 1,
+    tabsize: int | None = None,
+) -> str:
+    """Return ``text`` truncated or padded to exactly ``width`` cells: one table cell.
+
+    Long text is cut as ``truncate`` does, short text is padded as ``ljust``, ``rjust``
+    or ``center`` do, depending on ``align``. When a wide character at the cut leaves the
+    result one cell short, padding fills it, so columns always line up.
+
+    >>> fit("\\u4f60\\u597d\\u4e16\\u754c", 5, suffix="") == "\\u4f60\\u597d "
+    True
+    >>> fit("42", 5, align="right")
+    '   42'
+    """
+    if align not in _ALIGNS:
+        raise ValueError(f"align must be one of {', '.join(_ALIGNS)}, not {align!r}")
+    check_fill(fillchar, check_ambiguous(ambiguous))
+    cut = truncate_detailed(
+        text, width, suffix, position=position, ambiguous=ambiguous, tabsize=tabsize
+    ).text
+    pad = {"left": ljust, "right": rjust, "center": center}[align]
+    return pad(cut, width, fillchar, ambiguous=ambiguous)

cellstr/_ucd_data.py

@@ -0,0 +1,31 @@
+"""Index of the generated Unicode property data."""
+
+# Generated by scripts/gen_ucd_tables.py from data/ucd/. Do not edit.
+
+from __future__ import annotations
+
+from ._ucd_part1 import RUNS as _R0
+
+UNICODE_VERSION = "18.0.0"
+GCB_NAMES = (
+    "Other",
+    "CR",
+    "LF",
+    "Control",
+    "Extend",
+    "ZWJ",
+    "Regional_Indicator",
+    "Prepend",
+    "SpacingMark",
+    "L",
+    "V",
+    "T",
+    "LV",
+    "LVT",
+)
+EXT_PICT_BIT = 16
+INCB_SHIFT = 5
+EMOJI_BIT = 128
+MODIFIER_BIT = 256
+WIDTH_SHIFT = 9
+RUNS = _R0

cellstr/_ucd_part1.py

@@ -0,0 +1,166 @@
+"""Run-length property data, part 1."""
+
+# Generated by scripts/gen_ucd_tables.py from data/ucd/. Do not edit.
+
+RUNS = (
+    "003a 0021 0032 0011 003i 0e83 0hs1 0e86 0hs1 0e85 0hsa 0e81x 003x 0e81 16o1 0e82 16o1 "
+    "0e82 16o2 0i81 16o1 0e82 16r1 1ao1 0e81 16o5 0e81 16o5 0e81 16o4 0e86 16o1 0e89 16o1 "
+    "0e86 16o2 0e85 16o4 0e84 16o1 0e81 16o3 0e81 16o2 0e82 16o1 0e81 16o2 0e83 16o4 0e81 "
+    "16o1 0e81 16o1 0e82 16o1 0e8f 16o1 0e81 16o1 0e87 16o1 0e8a 16o2 0e83 16o1 0e85 16o3 "
+    "0e84 16o1 0e86 16o4 0e81 16o1 0e83 16o4 0e81 16o1 0e84 16o2 0e8i 16o2 0e83 16o1 0e82q "
+    "16o1 0e81 16o1 0e81 16o1 0e81 16o1 0e81 16o1 0e81 16o1 0e81 16o1 0e81 16o1 0e838 16o1 "
+    "0e8f 16o1 0e82q 16o1 0e82 16o1 0e81 16o3 0e81 16o1 0e82 16o1 0e87 16o4 0e81 16o1 0e81 "
+    "16o1 0e8w 02s34 0e8x 16oh 0e81 16o7 0e87 16oh 0e81 16o7 0e81j 16o1 0e8e 16o1s 0e81 16o1 "
+    "0e81d 02s7 0e87b 02s19 0e81 02s1 0e81 02s2 0e81 02s2 0e81 02s3 0e81i 0076 0e8a 02sb "
+    "0e81 0031 0e81a 02sl 0e8g 02s1 0e82t 02s7 0071 0e81 02s6 0e82 02s2 0e81 02s4 0e8x 0071 "
+    "0e81 02s1 0e8u 02sr 0e82j 02sb 0e81m 02s9 0e89 02s1 0e8o 02s4 0e81 02s9 0e81 02s3 0e81 "
+    "02s5 0e817 02s3 0e81g 0072 0e85 02s9 0e816 02so 0071 02sw 0eg1 0e8h 0g011 02s1 0eg1 "
+    "02s1 0e81 0eg3 02s8 0eg4 0101 0eg2 0e81 02s7 0g08 0e82 02s2 0e8k 0g08 0e81 02s1 0eg2 "
+    "0e8h 0g0k 0e81 0g07 0e81 0g01 0e83 0g04 0e82 02s1 0e81 0h01 0eg2 02s4 0e82 0eg2 0e82 "
+    "0eg2 0101 0e89 0h01 0e84 0g02 0e81 0g01 0e82 02s2 0e8c 0g02 0e8c 02s1 0e82 02s2 0eg1 "
+    "0e81k 02s1 0e81 0eg3 02s2 0e84 02s2 0e82 02s3 0e83 02s1 0e8u 02s2 0e83 02s1 0e8b 02s2 "
+    "0eg1 0e8h 0g0k 0e81 0g07 0e81 0g02 0e81 0g05 0e82 02s1 0e81 0eg3 02s5 0e81 02s2 0eg1 "
+    "0e81 0eg2 0101 0e8k 02s2 0e8l 0g01 02s6 0e81 02s1 0eg2 0e8h 0g0k 0e81 0g07 0e81 0g02 "
+    "0e81 0g05 0e82 02s1 0e81 0h01 02s1 0eg1 02s4 0e82 0eg2 0e82 0eg2 0101 0e85 02s4 0h01 "
+    "0e84 0g02 0e81 0g01 0e82 02s2 0e8d 0g01 0e8g 02s1 0e81n 0h01 0eg1 02s1 0eg2 0e83 0eg3 "
+    "0e81 0eg3 02s1 0e89 0h01 0e814 02s1 0eg3 02s1 0e8g 0g0k 0e81 0g0g 0e82 02s1 0e81 02s3 "
+    "0eg4 0e81 02s3 0e81 02s3 0101 0e87 02s2 0e81 0g03 0e87 02s2 0e8t 02s1 0eg2 0e81k 02s1 "
+    "0e81 0eg1 02s1 0h01 0eg1 0h01 0eg2 0e81 02s1 0h02 0e81 0h02 02s2 0e87 0h02 0e8b 02s2 "
+    "0e8f 0eg1 0e8c 02s2 0eg2 0e8h 0g012 02s2 0e81 0h01 0eg2 02s4 0e81 0eg3 0e81 0eg3 0101 "
+    "0ef1 0e88 0h01 0e8a 02s2 0e8t 02s1 0eg2 0e81y 02s1 0e84 0h01 0eg2 02s3 0e81 02s1 0e81 "
+    "0eg7 0h01 0e8i 0eg2 0e81p 02s1 0e81 0eg1 02s7 0e8c 02s8 0e82q 02s1 0e81 0eg1 02s9 0e8b "
+    "02s7 0e821 02s2 0e8r 02s1 0e81 02s1 0e81 02s1 0e84 0eg2 0e81d 02se 0eg1 02s5 0e81 02s2 "
+    "0e85 02sb 0e81 02s10 0e89 02s1 0e81l 0g017 0e82 02s4 0eg1 02s6 0e81 0101 02s1 0eg2 02s2 "
+    "0g01 0e8g 0g06 0eg2 02s2 0g04 02s3 0g01 0e83 0g02 0e87 0g03 02s4 0g0d 02s1 0e81 0eg1 "
+    "02s2 0e86 02s1 0g01 0e8e 02s1 0e82q 0sp2o 00a20 00b2g 0e89p 02s3 0e8qa 02s3 0h01 0e8s "
+    "02s2 0h01 0e8t 02s2 0e8u 02s2 0e8c 0g01g 02s2 0eg1 02s7 0eg8 02s1 0eg2 02s9 0101 02s1 "
+    "0e89 02s1 0e819 02s3 0031 02s1 0e839 02s2 0e8y 02s1 0e83a 02s3 0eg4 02s2 0eg3 0e84 0eg2 "
+    "02s1 0eg6 02s3 0e863 02s2 0eg2 02s1 0e84 0g01h 0eg1 02s1 0eg1 02s7 0e81 0101 0e81 02s1 "
+    "0e82 02s8 0eg6 02sa 0e82 02s1 0e81c 02s1t 0e8f 02s4 0eg1 0e86 0g02 0e86 0g0x 02s1 0h01 "
+    "02s5 0h01 02s1 0h01 0eg4 02s1 0h01 0f81 0g08 0e8u 02s9 0e8c 02s2 0eg1 0g0u 0eg1 02s4 "
+    "0eg2 02s2 0h01 0101 02s2 0g02 0e8b 0g03 0e814 02s1 0eg1 02s2 0eg3 02s1 0eg1 02s3 0h02 "
+    "0e81c 0eg8 02s8 0eg2 02s2 0e848 02s3 0e81 02sd 0eg1 02s7 0e84 02s1 0e86 02s1 0f42 0eg1 "
+    "02s2 0e85i 02s1s 0e8ej 0031 0041 02t1 0032 16o1 0e82 16o4 0e81 16o2 0e82 16o2 0e82 16o3 "
+    "0e81 16o4 0eb2 0035 0e81 16o1 0e81 16o2 0e81 16o1 0e85 16o1 0i81 0e81 16o1 0e8a 0i81 "
+    "0e8m 0035 0eb1 003a 0e84 16o1 0e8a 16o1 0e81 16o4 0e813 16o1 0e8z 02sx 0e8i 16o1 0e81 "
+    "16o1 0e83 16o1 0e89 16o1 0e82 16o1 0e8a 16o1 1ao1 0e83 16o1 0e84 16o1 0e8d 0i81 0e8p "
+    "16o2 0e86 16o4 0e81 16oc 0e84 16oa 0e8f 16o1 0e86 16o4 1ao6 0e8f 0i82 0e8d 16o2 0e8o "
+    "16o1 0e81 16o1 0e8i 16o1 0e8o 16o1 0e81 16o2 0e83 16o2 0e82 16o1 0e83 16o1 0e81 16o1 "
+    "0e83 16o1 0e84 16o1 0e82 16o4 0e82 16o1 0e81 16o1 0e81 16o6 0e81 16o1 0e85 16o4 0e84 "
+    "16o2 0e8a 16o1 0e83 16o1 0e85 16o1 0e8d 16o2 0e82 16o4 0e82 16o2 0e82 16o2 0e8i 16o2 "
+    "0e82 16o2 0e8d 16o1 0e83 16o1 0e8b 16o1 0e8p 16o1 0e82a 16o1 0e87 0wg2 0e8c 0i81 0sg2 "
+    "0e84k 0i81 0e8p 0wg4 0i83 0wg1 0i82 0wg1 0e84 0i83 0e82t 16o2q 1ao1 16o13 0e81 16o2p "
+    "0e84 16o10 0e8c 16og 0e82 16o4 0e8a 16o2 0e81 16o7 0i82 0e86 16o2 0e82 1ao1 16o1 0e84 "
+    "16o2 0e82 1ao1 16o1 0e84 16o3 0e82 16o1 0e82 16o4 0e8g 16o4 0e89 16o1 0e8b 0i82 0wg2 "
+    "0e81 0i85 16o2 0e82 16o1 0e84 1ao1 16o1 0e81 0i81 0e82 0wg2 0e82 0i81 0e83 16o1 0i81 "
+    "16o1 0e81 0i81 0e81 0i82 0e82 0i81 0e83 0i81 0e83 0i82 0sg8 0i83 0e85 1ao1 0e81 1ao1 "
+    "0e85 0wgc 0e8b 0i81 1ao1 16o1 0e81 1ao1 16o1 1ao1 0i81 16o1 1ao1 16o2 0e81 16o2 0e81 "
+    "16o1 0e8b 0i81 0e82 0i81 0wg1 0e8a 0sg6 0e82 0i81 0wg1 0i84 0e81 0i81 0e81 0i82 0e81 "
+    "16o2 0i81 0wg1 0e85 0i81 0e82 0wg2 0e84 0i82 0e8b 0wg2 16o1 0e84 0wg2 16o2 1ao1 16o5 "
+    "0wg1 1ao1 16o1 1ao1 16o1 1ao1 0wg1 16od 0e81 16o1 0e84 16o1 1ao1 0wg1 16o5 1ao2 0wg2 "
+    "1ao1 0wg1 16o1 1ao3 0wg1 16o2 0wg1 16o2 0e82 0i81 0e82 0wg1 0e82 0i82 0wg2 0i82 0e81 "
+    "0i81 0e82 0i81 0e81 0i81 0e81 0i81 0e86 0i81 0e83 0i81 0e86 0wg1 0e8a 0i82 0e88 16o1 "
+    "0e86 0i81 0e82 0i81 0e84 0wg1 0e81 0wg1 0e84 0wg3 0e81 0wg1 0e8b 0i82 0e8h 16oa 0e8l "
+    "0wg3 0e89 0i81 0e8e 0wg1 0e8e 0wg1 0e8ac 0i82 0e8cv 0i83 0e8j 0wg2 0e81f 0wg1 0e84 0wg1 "
+    "16o4 0e8b9 02s3 0e83x 02s1 0e82o 02sw 0e83k 0sgq 0e81 0sg2h 0e8c 0sg5y 0e8q 0sg1m 02s4 "
+    "0v82 0wg1 0sgc 0wg1 0sg1 0e82 0sg2e 0e82 02s2 0sg2t 0e85 0sg17 0e81 0sg2m 0e81 0sg2e "
+    "0e89 0sg1c 0e81 0sg14 16o8 0sg1z 0wg1 0sg1 0wg1 0sgmib 0e83 0sg1j 0e8bs 02s4 0e81 02sa "
+    "0e8w 02s2 0e828 02s2 0e87k 02s1 0e83 02s1 0e84 02s1 0e8n 0eg2 02s2 0eg1 0e84 02s1 0e82b "
+    "0eg2 0e81e 0egg 02s2 0e8q 02si 0e8d 02s1 0e812 02s8 0e8p 02sb 0eg1 0h01 0e8c 0spt 0e83 "
+    "02s3 0eg1 0e85 0g03 0e83 0g010 02s1 0eg2 02s4 0eg2 02s2 0eg2 0f81 0e8v 0g05 02s1 0e81 "
+    "0g09 0e8a 0g05 0e816 02s6 0eg2 02s2 0eg2 02s2 0e8c 02s1 0e88 02s1 0eg1 0e8i 0g0g 0e81 "
+    "0g03 0e86 0g01 0e81 02s1 0e81 0g02 0e81c 02s1 0e81 02s3 0e82 02s2 0e85 02s2 0e81 02s1 "
+    "0e8u 0g0b 0eg1 02s2 0eg2 0e85 0eg1 0101 0e85l 0g0r 0e88 0eg2 02s1 0eg2 02s1 0eg2 0e81 "
+    "0eg1 02s1 0e8i 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 "
+    "0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str 0ss1 0str "
+    "0ss1 0str 0e8c 00an 0004 00b1d 0004 0e81kw 16o4xs 0sge8 0e8u 02s1 0e8kh 02sg 0sga 0e86 "
+    "02sg 0sgz 0e81 0sgj 0e81 0sg4 0e843 0031 0e81 0sg2o 0e81p 0h02 0e81s 0sg7 0e89 0eb9 "
+    "0033 0e81 16o1 0e8e7 02s1 0e86a 02s1 0e845 02s5 0e81ad 0g01 02s3 0e81 02s2 0e85 02s4 "
+    "0g04 0e81 0g03 0e81 0g0t 0e82 02s3 0e84 0101 0e84l 02s2 0e8fx 02s4 0e81t 02s5 0e88t "
+    "02s2 0e8u 02s5 0e8w 02sg 0e81y 02sb 0e81d 02s4 0e83e 0eg1 02s1 0eg1 0e81h 02sf 0e815 "
+    "02s1 0e82 02s2 0e8a 02s3 0eg1 0e819 0eg3 02s4 0eg2 02s2 0e82 0071 0e84 02s1 0e8a 0071 "
+    "0e81e 02s3 0g010 02s5 0eg1 02s6 0101 02s1 0e8f 0g01 0eg2 0g01 0e817 02s1 0e8c 02s2 0eg1 "
+    "0e81c 0eg3 02s9 0eg1 0h01 0e81 0ef2 0e85 02s4 0e81 0eg1 02s1 0e82k 0eg3 02s3 0eg2 02s1 "
+    "0h01 02s2 0e86 02s1 0e82 02s1 0e84d 02s1 0eg3 02s8 0e8l 02s2 0eg2 0e81j 02s2 0e81 0h01 "
+    "0eg1 02s1 0eg4 0e82 0eg2 0e82 0eg2 0h01 0e89 0h01 0e8a 0eg2 0e82 02s7 0e83 02s5 0e8b "
+    "0g0a 0e81 0g01 0e82 0g01 0e81 0g012 0e82 0h01 0eg2 02s6 0e81 0h01 0e82 0h01 0e81 0h03 "
+    "0eg1 0e81 0eg2 02s1 0h01 0101 0ef1 02s1 0e8e 02s2 0e82a 0eg3 02s8 0eg2 02s3 0eg1 02s1 "
+    "0e8n 02s1 0e829 0h01 0eg2 02s6 0eg1 02s1 0eg2 0h01 0eg1 02s2 0eg1 02s2 0e86j 0h01 0eg2 "
+    "02s4 0e82 0eg4 02s2 0eg1 02s2 0e8r 02s2 0e82a 0eg3 02s8 0eg2 02s1 0eg1 02s2 0e82y 02s1 "
+    "0eg1 02s1 0eg2 02s6 0h01 02s1 0e82t 02s1 0eg1 02s1 0e82 02s4 0eg1 02s5 0e874 0eg3 02s9 "
+    "0eg1 02s2 0e85h 0g07 0e82 0g01 0e82 0g08 0e81 0g02 0e81 0g0o 0h01 0eg5 0e81 0eg2 0e82 "
+    "02s2 0h01 0101 0ef1 0eg1 0ef1 0eg1 02s1 0e83x 0eg3 02s4 0e82 02s2 0eg4 02s1 0e83 0eg1 "
+    "0e8r 0g01 02sa 0g014 02s6 0eg1 0f41 02s4 0e88 0101 0e88 0g01 02s6 0eg2 02s3 0g014 0ef6 "
+    "02sd 0eg1 02s1 0101 0e834 0g01 0e82d 02s1 0eg1 02s3 0eg1 02s1 0eg1 0e85j 0eg1 02s7 0e81 "
+    "02s6 0eg1 02s1 0e82a 02sm 0e81 0eg1 02s7 0eg1 02s2 0eg1 02s2 0e83e 02s6 0e83 02s1 0e81 "
+    "02s2 0e81 02s7 0ef1 02s1 0e81u 0eg5 0e81 02s2 0e81 0eg2 02s1 0eg1 02s1 0e82g 02s1 0g01 "
+    "0e875 02s2 0eg2 0e89 02s2 0ef1 0eg1 0g0d 0e81 0g0y 0eg2 02s5 0e83 0eg2 02s1 0h01 0101 "
+    "0e8n 02s1 0e8445 003g 02s1 0e86 02sf 0e88ug 02sc 0eg3 02s3 0e81xc 02s5 0e81n 02s7 0e8fg "
+    "0ei1 0e83 0ei4 0e8dg 02s1 0e81 0eg1j 0e87 02s4 0e825 0sg4 02s1 0e8b 0v82 0sg5 0e89 "
+    "0sg5p7 0e810 0sgy 0e82n 0sg37 0e8d 0sgpe 0e8e 0sg1f 0e85y5 0sg4 0e81 0sg7 0e81 0sg2 "
+    "0e81 0sg89 0e89 0sg1 0e8t 0sg3 0e82 0sg1 0e8e 0sg5 0e87 0sgb0 0e81wh 02s2 0e81 0034 "
+    "0e83mk 02s1a 0e82 02sn 0e8dc 02s2 0e81o 0h02 02s3 0e83 0h06 0038 02s8 0e82 02s7 0e8u "
+    "02s4 0e844 02s3 0e8b 0h03 0e88 02s2 0e82 0h01 0e8w 0h02 0e83i 0sg2f 0e89 0sgn 0e81ah "
+    "02s1j 0e84 02s1e 0e88 02s1 0e8e 02s1 0e8m 02s5 0e81 02sf 0e811s 02s7 0e81 02sh 0e82 "
+    "02s7 0e81 02s2 0e81 02s5 0e82s 02s1 0e84g 02s7 0e8af 02s1 0e81p 02s4 0e8e4 02s4 0e872 "
+    "02s2 0e86r 02s1 0e82 02s1 0e87 02s2 0e85 02s1 0e8d6 02s7 0e831 02s7 0e81bt 0wg1 0e813 "
+    "0eo4 0e82s 0eoc 0e8f 0eo2 0e8f 0eo1 0e8e 0wg1 0eo1 0e811 0eoa 16ob 0e85 16ou 0e82 16o1m "
+    "0e86 1ao2 16oc 1ao2 16oe 0wg1 16o2 0wga 16oi 0e81 0sg1 0eo1j 0hyq 0sg1 0wg2 0eod 0sga "
+    "0wg1 0sgk 0wg1 0sg2 0wg9 0sg1 0eo4 0sg9 0eo7 0wg2 0eoe 0sg6 0eo4a 0wgx 0i81 0e82 0i89 "
+    "0wg9 0i81 0wg1y 0i81 0wgm 0e82 0i82 0e81 0i83 0e82 0i82 0wg17 0i84 0wg5 0i8c 0wgh 0e82 "
+    "0i81 0wg1 0i81 0e81 0i81 0wg3 15w5 0wg1r 0i81 0wg1 0i81 0wg57 0i81 0e81 0wg1r 0e8b 0i82 "
+    "0wg4 0e81 0wgo 0e87 0i82 0e82 0i87 0wg1 0e8c 0i81 0e82 0i84 0e82 0i81 0e84 0wg2 0e8d "
+    "0wg1 0i81 0e82 0i81 0e88 0i82 0e89 0i81 0e85 0i83 0e8c 0i83 0e88 0i83 0e82 0i81 0e81 "
+    "0i81 0e84 0i81 0e86 0i81 0e83 0i81 0e86 0i81 0wg2d 0e81c 0wg1y 0e85 0i81 0wg1 0i83 0wg3 "
+    "0e82 0wg5 0eo2 0wg4 0i86 0e83 0i81 0e81 0wg2 0eo3 0i81 0e82 0i81 0wg9 0eo3 0e862 0sg1 "
+    "0e81 0eo4 0wgc 0eo4 0wg1 0e8r 0eo4 0e81k 0eo8 0e8a 0eo6 0e814 0eo8 0e8u 0eo2 0e8c 0eo4 "
+    "0e82 0eoe 0e89 0eo13 0e8c 0wg1b 0e81 0wga 0e81 0wg55 0e82g 0eo8 0e8e 0eo2 0wgd 0eo3 "
+    "0wg1z 0eo1 0wg1 0eo3 0wgi 0eo1 0wgd 0eo3 0wgc 0eo5 0e874 0eose 0e82 0sg1eke 0e82 "
+    "0sg1eke 0e8e1oi 0eb1 0031 0ebu 02s2o 0eb3k 02s6o 0eb2s0 0e81beo 16o1eke 0e82 16o1eke "
+    "0e82 "
+)

cellstr/_width.py

@@ -0,0 +1,111 @@
+"""Display width of code points, grapheme clusters and whole strings."""
+
+from __future__ import annotations
+
+from ._ansi import segments
+from ._graphemes import grapheme_ends
+from ._props import AMBIGUOUS, EMOJI_BIT, EXT_PICT_BIT, GCB, MODIFIER_BIT, WIDTH_SHIFT, prop
+
+_RI = GCB["Regional_Indicator"]
+_VS15 = "\ufe0e"
+_VS16 = "\ufe0f"
+_ZWJ = "\u200d"
+_TAGS = range(0xE0020, 0xE0080)
+
+
+def check_ambiguous(ambiguous: int) -> int:
+    """Return ``ambiguous`` after checking it is 1 or 2."""
+    if type(ambiguous) is not int or ambiguous not in (1, 2):
+        raise ValueError(f"ambiguous must be 1 or 2, not {ambiguous!r}")
+    return ambiguous
+
+
+def code_width(code: int, ambiguous: int) -> int:
+    """Width of a code point from its packed property code."""
+    width = code >> WIDTH_SHIFT
+    return ambiguous if width == AMBIGUOUS else width
+
+
+def char_width(char: str, *, ambiguous: int = 1) -> int:
+    """Display cells a single code point occupies on its own: 0, 1 or 2.
+
+    U+0000, the C0 and C1 controls, DEL, nonspacing and enclosing marks (Mn, Me), format
+    characters (Cf, except SOFT HYPHEN) and Hangul medial vowels and final consonants are
+    zero. East Asian Wide and Fullwidth characters are two. East Asian Ambiguous
+    characters take ``ambiguous`` cells (1 by default, 2 for CJK terminals). Everything
+    else is one. This is Markus Kuhn's wcwidth, except that controls are 0 instead of -1.
+
+    >>> char_width("a"), char_width("\\u4f60"), char_width("\\u0301"), char_width("\\u2500")
+    (1, 2, 0, 1)
+    >>> char_width("\\u2500", ambiguous=2)
+    2
+    """
+    if len(char) != 1:
+        raise ValueError(f"char_width expects a single character, got {len(char)}")
+    return code_width(prop(ord(char)), check_ambiguous(ambiguous))
+
+
+def _emoji_sequence(rest: str) -> bool:
+    """True when ``rest`` (after an emoji base) holds a modifier, a tag or a ZWJ + pictograph."""
+    joined = False
+    for ch in rest:
+        code = prop(ord(ch))
+        if code & MODIFIER_BIT or ord(ch) in _TAGS or (joined and code & EXT_PICT_BIT):
+            return True
+        joined = joined or ch == _ZWJ
+    return False
+
+
+def cluster_width(cluster: str, ambiguous: int) -> int:
+    """Width of one grapheme cluster, without validating the input."""
+    code = prop(ord(cluster[0]))
+    if len(cluster) == 1:
+        return code_width(code, ambiguous)
+    rest = cluster[1:]
+    if code & (EMOJI_BIT | EXT_PICT_BIT) and not code & MODIFIER_BIT:
+        # A variation selector only counts right after the base.
+        if code & EMOJI_BIT and rest[0] in (_VS15, _VS16):
+            return 1 if rest[0] == _VS15 else 2
+        if _emoji_sequence(rest):
+            return 2
+    if code & 0x0F == _RI and prop(ord(rest[0])) & 0x0F == _RI:
+        return 2
+    return sum(code_width(prop(ord(ch)), ambiguous) for ch in cluster)
+
+
+def grapheme_width(cluster: str, *, ambiguous: int = 1) -> int:
+    """Display cells one extended grapheme cluster occupies.
+
+    ``cluster`` must be exactly one cluster, such as an item from ``iter_graphemes``.
+    Emoji sequences draw as a single glyph: an emoji followed by VS16 (U+FE0F), a skin
+    tone modifier, a ZWJ sequence, a tag sequence or a pair of regional indicators (a
+    flag) is two cells, and an emoji followed by VS15 (U+FE0E) is one. Any other cluster
+    is the sum of its code points, which keeps combining marks at zero and conjoining
+    Hangul jamo at the width of the syllable.
+
+    >>> grapheme_width("\\U0001f468\\u200d\\U0001f469\\u200d\\U0001f467")
+    2
+    >>> grapheme_width("\\u2764\\ufe0f"), grapheme_width("\\u2764"), grapheme_width("e\\u0301")
+    (2, 1, 1)
+    """
+    if not cluster or next(grapheme_ends(cluster)) != len(cluster):
+        raise ValueError("grapheme_width expects exactly one grapheme cluster")
+    return cluster_width(cluster, check_ambiguous(ambiguous))
+
+
+def _plain_width(text: str, ambiguous: int) -> int:
+    if text.isascii():
+        return sum(1 for ch in text if " " <= ch <= "~")
+    total = 0
+    start = 0
+    for end in grapheme_ends(text):
+        total += cluster_width(text[start:end], ambiguous)
+        start = end
+    return total
+
+
+def text_width(text: str, ambiguous: int) -> int:
+    """Width of ``text`` with no tab stops to honour; an escape sequence ends a cluster."""
+    if "\x1b" not in text:
+        return _plain_width(text, ambiguous)
+    return sum(_plain_width(s.text, ambiguous) for s in segments(text) if not s.is_escape)

cellstr-0.2.1.dist-info/METADATA

@@ -0,0 +1,144 @@
+Metadata-Version: 2.5
+Name: cellstr
+Version: 0.2.1
+Summary: Display-width aware len, slice, pad and truncate for terminal text: wide CJK, emoji sequences, combining marks and ANSI codes
+Project-URL: Homepage, https://lianes8studio.com
+Project-URL: Repository, https://github.com/JaviLianes8/cellstr
+Project-URL: Issues, https://github.com/JaviLianes8/cellstr/issues
+Project-URL: Changelog, https://github.com/JaviLianes8/cellstr/blob/main/CHANGELOG.md
+Project-URL: LinkedIn, https://www.linkedin.com/in/jlianes/
+Project-URL: Funding, https://buymeacoffee.com/jlianesglrs
+Author-email: Javier Lianes <javier@lianes8studio.com>
+License-Expression: MIT
+License-File: LICENSE
+License-File: LICENSE-UNICODE
+Keywords: ansi,cli,east-asian-width,emoji,grapheme,terminal,truncate,unicode,wcwidth,width
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Terminals
+Classifier: Topic :: Text Processing
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Requires-Dist: wcwidth==0.2.13; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# cellstr
+
+Display-width aware `len`, slicing, padding and truncation for terminal text: East Asian
+wide characters, emoji sequences, combining marks, zero-width characters and ANSI escape
+sequences, measured the way a terminal draws them. Typed, zero dependencies, Unicode 18.0.0.
+
+## Install
+
+```
+pip install cellstr
+```
+
+## Usage
+
+`len`, slicing and `str.ljust` count code points, so they misalign any text that carries
+colour codes, CJK characters, emoji or accents. `cellstr` counts display cells.
+
+```python
+from cellstr import cell_len, cell_slice, fit, ljust, truncate
+
+warn = "\x1b[31mWARN\x1b[0m"  # red "WARN"
+cell_len(warn)  # -> 4
+cell_len("你好")  # -> 4
+cell_len("👨‍👩‍👧")  # -> 2
+cell_len("🇯🇵")  # -> 2
+cell_len("é")  # -> 1
+
+cell_slice(warn, 0, 2)  # -> "\x1b[31mWA\x1b[0m"
+cell_slice("a你b", 0, 2)  # -> "a"
+cell_slice("x👨‍👩‍👧y", 0, 2)  # -> "x"
+
+ljust("你", 4)  # -> "你  "
+truncate("hello world", 8)  # -> "hello..."
+truncate("/usr/local/lib/python", 12, position="middle")  # -> "/usr/...thon"
+fit("张伟张伟", 5, suffix="")  # -> "张伟 "
+```
+
+What it gets right:
+
+- **Grapheme clusters.** A ZWJ family, a skin tone sequence, a flag, a keycap or a letter
+  with accents is one unit: measured once and never split by slicing or truncation.
+- **Escape sequences.** SGR colours, OSC 8 hyperlinks, cursor movement and the other
+  ECMA-48 families count as nothing and are kept in place, so styled text stays styled.
+- **Ambiguous width.** Greek, Cyrillic, box drawing and circled digits are one cell in
+  Western terminals and two in CJK ones. Pass `ambiguous=2` to any function.
+- **Tabs.** Pass `tabsize=8` to measure tab stops; slicing and padding turn tabs into the
+  spaces they cover. `expand_tabs()` does it on its own.
+- **Real Unicode data.** Tables are generated by a committed script from a committed
+  Unicode Character Database snapshot, and the full grapheme break test suite runs.
+
+```python
+from cellstr import cell_len, iter_cells, truncate_detailed
+
+cell_len("αβ─", ambiguous=2)  # -> 6
+cell_len("a\tb", tabsize=8)  # -> 9
+[c.width for c in iter_cells("a你🇯🇵")]  # -> [1, 2, 2]
+truncate_detailed("hello world", 8).truncated  # -> True
+```
+
+Public API: `cell_len`, `char_width`, `grapheme_width`, `iter_graphemes`, `iter_cells`
+(`Cell`), `cell_slice`, `ljust`, `rjust`, `center`, `fit`, `truncate`,
+`truncate_detailed` (`Truncation`), `expand_tabs`, `strip_ansi`, `UNICODE_VERSION`, and
+the `Align` and `Position` literal types. Every function is fully typed and documented.
+
+## Command line
+
+```
+$ printf 'abc\n你好\n' | cellstr measure
+3
+4
+$ printf '/usr/local/lib/python3/site-packages\n' | cellstr truncate 16 --position middle
+/usr/lo...ckages
+$ printf 'id\n12345\n' | cellstr pad 8 --align right
+      id
+   12345
+```
+
+Commands: `measure` (`--max`), `truncate N`, `pad N`, `fit N` and `slice START [STOP]`,
+all with `--ambiguous` and `--tabsize`. `cellstr --help` lists runnable examples.
+
+## Terminals disagree
+
+There is no standard for how many cells a character takes, and terminals differ on
+ambiguous-width characters, emoji ZWJ sequences and variation selectors. `cellstr`
+follows Markus Kuhn's reference `wcwidth` for single code points and
+measures emoji sequences as one glyph, as terminals with grapheme support draw them.
+[GUIDE.md](GUIDE.md) has the exact rules, concrete examples of where terminals differ, a
+recipe for code point by code point measuring, and every difference from the `wcwidth`
+package.
+
+## Why
+
+`wcwidth` measures plain-text width well, but it does not give you a typed, cohesive set
+of string operations: slicing by column that keeps escapes and graphemes intact, padding,
+fitting a table cell and width-aware truncation with a suffix at either end or in the
+middle. `strip-ansi` style tools remove escapes but know nothing about width. `cellstr`
+does all of it in one small, fully typed, zero-dependency package.
+
+## License
+
+MIT. See [LICENSE](LICENSE). The property tables in `src/cellstr/_ucd_*.py` are generated
+from the Unicode Character Database and are covered by the Unicode License v3, see [LICENSE-UNICODE](LICENSE-UNICODE).
+
+## Links
+
+- Website: https://lianes8studio.com
+- GitHub: https://github.com/JaviLianes8
+- LinkedIn: https://www.linkedin.com/in/jlianes/