o aĎi @sdZddlmZddlmZddlmZddlmZddl m Z ddl m Z dd l mZmZmZmZmZdd lmZdd lmZdd lmZdd lmZmZmZmZddlmZm Z m!Z!ddl"m#Z#ddl$m%Z%m&Z&m'Z'm(Z(ddl)m*Z*erddl+m,Z,ddlm-Z-e*dZ.ee.Z/ee.Z0e#e1e2e#Z3e e.Z4e5e6e!dde!dddZ7e5dde De7BZ8dZ9e5dZ:eZ;dZddd?dde6ddDdd?dde6dd DZ@d!ZAed"d#d\d]d+d,ZB - $ d^d_d1d2ZCedd#d`d5d6ZDed7d#dad9d:ZEdbd=d>ZFdcddd?d@ZGdAd7ddBdedFdGZH HdfdAddIdgdLdMZI HdfdAddIdgdNdOZJ HdfdAddIdgdPdQZKdhdRdSZLdHd7ddTdUdidZd[ZMd-S)ja This is a python implementation of wcwidth() and wcswidth(). https://github.com/jquast/wcwidth from Markus Kuhn's C code, retrieved from: http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c This is an implementation of wcwidth() and wcswidth() (defined in IEEE Std 1002.1-2001) for Unicode. http://www.opengroup.org/onlinepubs/007904975/functions/wcwidth.html http://www.opengroup.org/onlinepubs/007904975/functions/wcswidth.html In fixed-width output devices, Latin characters all occupy a single "cell" position of equal width, whereas ideographic CJK characters occupy two such cells. Interoperability between terminal-line applications and (teletype-style) character terminals using the UTF-8 encoding requires agreement on which character should advance the cursor by how many cell positions. No established formal standards exist at present on which Unicode character shall occupy how many cell positions on character terminals. These routines are a first attempt of defining such behavior based on simple rules applied to data provided by the Unicode Consortium. For some graphical characters, the Unicode standard explicitly defines a character-cell width via the definition of the East Asian FullWidth (F), Wide (W), Half-width (H), and Narrow (Na) classes. In all these cases, there is no ambiguity about which width a terminal shall use. For characters in the East Asian Ambiguous (A) class, the width choice depends purely on a preference of backward compatibility with either historic CJK or Western practice. Choosing single-width for these characters is easy to justify as the appropriate long-term solution, as the CJK practice of displaying these characters as double-width comes from historic implementation simplicity (8-bit encoded characters were displayed single-width and 16-bit ones double-width, even for Greek, Cyrillic, etc.) and not any typographic considerations. Much less clear is the choice of width for the Not East Asian (Neutral) class. Existing practice does not dictate a width for any of these characters. It would nevertheless make sense typographically to allocate two character cells to characters such as for instance EM SPACE or VOLUME INTEGRAL, which cannot be represented adequately with a single-width glyph. The following routines at present merely assign a single-cell width to all neutral characters, in the interest of simplicity. This is not entirely satisfactory and should be reconsidered before establishing a formal standard in this area. At the moment, the decision which Not East Asian (Neutral) characters should be represented by double-width glyphs cannot yet be answered by applying a simple rule from the Unicode database content. Setting up a proper standard for the behavior of UTF-8 character terminals will require a careful analysis not only of each Unicode character, but also of each presentation form, something the author of these routines has avoided to do so far. http://www.unicode.org/unicode/reports/tr11/ Latest version: http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c ) annotations) lru_cache) TYPE_CHECKING)bisearch)iter_graphemes) CATEGORY_MC) _SGR_PATTERN_SGR_STATE_DEFAULT_sgr_state_update_sgr_state_is_active_sgr_state_to_sequence)VS16_NARROW_TO_WIDE)WIDE_EASTASIAN) ZERO_WIDTH) ILLEGAL_CTRL VERTICAL_CTRLHORIZONTAL_CTRLZERO_WIDTH_CTRL) ISC_CONSONANTEXTENDED_PICTOGRAPHICGRAPHEME_REGIONAL_INDICATOR)AMBIGUOUS_EASTASIAN)ZERO_WIDTH_PATTERNCURSOR_LEFT_SEQUENCECURSOR_RIGHT_SEQUENCEINDETERMINATE_EFFECT_SEQUENCE) list_versions)Iterator)Literalccs,|]\}}t||dD]}|Vq qdS)rN)range).0lohicpr&K/home/jeff/fluffinator/venv/lib/python3.10/site-packages/wcwidth/wcwidth.py ks  r()ii)iM i iM i iM i iM i iM i iDiiĨiiFiii5iMiBiii?ii9ii?cc|]}t|VqdSNchrr"cr&r&r'r( ccr+r,r-r/r&r&r'r(r1)rrrrrwcwidthwcswidthwidthiter_sequencesljustrjustcenterclipstrip_sequences_wcmatch_version_wcversion_valuei)maxsizeautowcstrunicode_versionambiguous_widthintreturncCs|rt|nd}d|krdkrdS|r|dks'd|kr%dkr)dSndSt|tr0dSt|tr7dS|dkrBt|trBdSdS)a* Given one Unicode codepoint, return its printable length on a terminal. :param wc: A single Unicode character. :param unicode_version: Ignored. Retained for backwards compatibility. .. deprecated:: 0.3.0 Only the latest Unicode version is now shipped. :param ambiguous_width: Width to use for East Asian Ambiguous (A) characters. Default is ``1`` (narrow). Set to ``2`` for CJK contexts where ambiguous characters display as double-width. See :ref:`ambiguous_width` for details. :returns: The width, in cells, necessary to display the character of Unicode string character, ``wc``. Returns 0 if the ``wc`` argument has no printable effect on a terminal (such as NUL '\0'), -1 if ``wc`` is not printable, or has an indeterminate effect on the terminal, such as a control character. Otherwise, the number of column positions the character occupies on a graphic terminal (1 or 2) is returned. See :ref:`Specification` for details of cell measurement. rr2rr5r )ord _bisearch_ZERO_WIDTH_TABLE_WIDE_EASTASIAN_TABLE_AMBIGUOUS_TABLE)rCrErFucsr&r&r'r6s  r6Npwcsn int | Nonecs\|dur|r|rt|Sdkrtnfdd}|dur$t|n|}d}d}d}d} d} d} ||kr%||} t| } | d kr^| rJ|d7}n|d|krW|d 7}d} n|d7}d} q2| d krz|dkrz|tt||td 7}d}|d7}q2| d kr| tvrd}|d}|dkrt||tvr|d7}|d8}|dkrt||tvs|d dkr|d7}| } q2ntd| krtdkrnn | t vr|d7}q2| rt| t r|}| } d} d} |d7}q2|| }|dkr|S|dkr| r|d7}d} |}| } d} n|dkrt| t rd}d}d} d} n| t v} ||7}|d7}||ks7| r,|d7}|S)a8 Given a unicode string, return its printable length on a terminal. :param pwcs: Measure width of given unicode string. :param n: When ``n`` is None (default), return the length of the entire string, otherwise only the first ``n`` characters are measured. Better to use string slicing capability, ``wcswidth(pwcs[:n])``, instead, for performance. This argument is a holdover from the POSIX function for matching signatures. Be careful that ``n`` is at grapheme boundaries. :param unicode_version: Ignored. Retained for backwards compatibility. .. deprecated:: 0.3.0 Only the latest Unicode version is now shipped. :param ambiguous_width: Width to use for East Asian Ambiguous (A) characters. Default is ``1`` (narrow). Set to ``2`` for CJK contexts. :returns: The width, in cells, needed to display the first ``n`` characters of the unicode string ``pwcs``. Returns ``-1`` for C0 and C1 control characters! See :ref:`Specification` for details of cell measurement. Nrc t|dSNrBr6r0rFr&r' zwcswidth..rr Fi rJ9.0.0T) isascii isprintablelenr6rKrLr_REGIONAL_INDICATOR_SET_FITZPATRICK_RANGE_EMOJI_ZWJ_SET_ISC_CONSONANT_TABLE_CATEGORY_MC_TABLE_ISC_VIRAMA_SET)rQrRrErF_wcwidthend total_widthidxlast_measured_idxlast_measured_ucslast_was_viramaconjunct_pendingcharrP ri_beforejwcwr&rXr'r7s$      Pr7 ver_stringtuple[int, ...]cCsttt|d}|S)aZ Integer-mapped value of given dotted version string. .. deprecated:: 0.3.0 This function is no longer used internally by wcwidth but is retained for API compatibility with external tools. :param ver_string: Unicode version string, of form ``n.n.n``. :returns: tuple of digit tuples, ``tuple(int, [...])``. .)tuplemaprGsplit)rtretvalr&r&r'r@{s r@ given_versioncCstS)a Return the supported Unicode version level. .. deprecated:: 0.3.0 This function now always returns the latest version. This function is no longer used internally by wcwidth but is retained for API compatibility with external tools. :param given_version: Ignored. Any value is accepted for compatibility. :returns: The latest unicode version string. )_LATEST_VERSION)r|r&r&r'r?sr?textIterator[tuple[str, bool]]ccsd}t|}d}||krJ||}|dkrB||kr"|||dfVt||}|r6|dfV|}n |dfV|d7}|}n|d7}||ks ||krY||ddfVdSdS)a Iterate through text, yielding segments with sequence identification. This generator yields tuples of ``(segment, is_sequence)`` for each part of the input text, where ``is_sequence`` is ``True`` if the segment is a recognized terminal escape sequence. :param text: String to iterate through. :returns: Iterator of (segment, is_sequence) tuples. .. versionadded:: 0.3.0 Example:: >>> list(iter_sequences('hello')) [('hello', False)] >>> list(iter_sequences('\x1b[31mred')) [('\x1b[31m', True), ('red', False)] >>> list(iter_sequences('\x1b[1m\x1b[31m')) [('\x1b[1m', True), ('\x1b[31m', True)] rFTrN)rarmatchgroupri)r~rktext_len segment_startrprr&r&r'r9s*   r9cCstt|t|dS)z Fast path for width() with control_codes='ignore'. Strips escape sequences and control characters, then measures remaining text. rX)r7r> translate_CONTROL_CHAR_TABLE)r~rFr&r&r'_width_ignored_codess rparse) control_codestabsizerFr$Literal['parse', 'strict', 'ignore']rcs|r |r t|S|dkr2t|tkr2d|vr2d|vr2d|vr2d|vs0t|s2t|s2d}|dkr;t|S|dk}d}d}d}d }d } d } d } t|} d krWtnfd d} || kr7||}|dkrt ||}|r| }|rt |rt d|t |}|r|t| d pd 7}nt |}|rtd|t| d pd }|}n|d 7}t||}q]|tvr|rt dt|dd||d 7}q]|tvr|rt dt|dd||d 7}q]|tvr#|dkr|dkr||||7}n|dkr|dkr|d 8}n|dkrd}t||}|d 7}q]|dkrE| r0|d 7}n|d | kr>|d7}d } n|d 7}d } q]|tvrO|d 7}q]t|}|dkry||d krttt||tdrt|d 7}t||}|d 7}q]|dkr|tvrd}|d }|dkrt||tvr|d 7}|d 8}|dkrt||tvs|dd kr|} |d 7}q]ntd|krtd krnn | tvr|d 7}q]| rt|tr|}|} d } d} |d 7}q]| |}|dkr| r|d 7}d } ||7}t||}|}|} d } n|dkr+t|tr+|d 7}t||}d }d } d } n|tv} |d 7}|| ksb| rC|d 7}t||}|S)u Return printable width of text containing many kinds of control codes and sequences. Unlike :func:`wcswidth`, this function handles most control characters and many popular terminal output sequences. Never returns -1. :param text: String to measure. :param control_codes: How to handle control characters and sequences: - ``'parse'`` (default): Track horizontal cursor movement from BS ``\b``, CR ``\r``, TAB ``\t``, and cursor left and right movement sequences. Vertical movement (LF, VT, FF) and indeterminate sequences are zero-width. Never raises. - ``'strict'``: Like parse, but raises :exc:`ValueError` on control characters with indeterminate results of the screen or cursor, like clear or vertical movement. Generally, these should be handled with a virtual terminal emulator (like 'pyte'). - ``'ignore'``: All C0 and C1 control characters and escape sequences are measured as width 0. This is the fastest measurement for text already filtered or known not to contain any kinds of control codes or sequences. TAB ``\t`` is zero-width; for tab expansion, pre-process: ``text.replace('\t', ' ' * 8)``. :param tabsize: Tab stop width for ``'parse'`` and ``'strict'`` modes. Default is 8. Must be positive. Has no effect when ``control_codes='ignore'``. :param ambiguous_width: Width to use for East Asian Ambiguous (A) characters. Default is ``1`` (narrow). Set to ``2`` for CJK contexts. :returns: Maximum cursor position reached, "extent", accounting for cursor movement sequences present in ``text`` according to given parameters. This represents the rightmost column the cursor reaches. Always a non-negative integer. :raises ValueError: If ``control_codes='strict'`` and control characters with indeterminate effects, such as vertical movement or clear sequences are encountered, or on unexpected C0 or C1 control code. Also raised when ``control_codes`` is not one of the valid values. .. versionadded:: 0.3.0 Examples:: >>> width('hello') 5 >>> width('コンニチハ') 10 >>> width('\x1b[31mred\x1b[0m') 3 >>> width('\x1b[31mred\x1b[0m', control_codes='ignore') # same result (ignored) 3 >>> width('123\b4') # backspace overwrites previous cell (outputs '124') 3 >>> width('abc\t') # tab caused cursor to move to column 8 8 >>> width('1\x1b[10C') # '1' + cursor right 10, cursor ends on column 11 11 >>> width('1\x1b[10C', control_codes='ignore') # faster but wrong in this case 1 r  rignorestrictrr[r FrcrTrUrVrWrXr&r'rYArZzwidth..z*Indeterminate cursor sequence at position zIllegal control character z#xz at position zVertical movement character u‍rJr\r]r^T)r_r`ra_WIDTH_FAST_PATH_MIN_LENrsearchrrr6rrrr ValueErrorrGmaxrirrKrrrrLrrbrcrdrerfrg)r~rrrFr current_col max_extentrkrlrmrnrorrhrprseqrightleftrPrqrrwr&rXr'r8sB                   $     r8 rrF dest_widthfillcharcCsB|r |r t|}nt|||d}td||}|||S)u) Return text left-justified in a string of given display width. :param text: String to justify, may contain terminal sequences. :param dest_width: Total display width of result in terminal cells. :param fillchar: Single character for padding (default space). Must have display width of 1 (not wide, not zero-width, not combining). Unicode characters like ``'·'`` are acceptable. The width is not validated. :param control_codes: How to handle control sequences when measuring. Passed to :func:`width` for measurement. :param ambiguous_width: Width to use for East Asian Ambiguous (A) characters. Default is ``1`` (narrow). Set to ``2`` for CJK contexts. :returns: Text padded on the right to reach ``dest_width``. .. versionadded:: 0.3.0 Example:: >>> wcwidth.ljust('hi', 5) 'hi ' >>> wcwidth.ljust('\x1b[31mhi\x1b[0m', 5) '\x1b[31mhi\x1b[0m ' >>> wcwidth.ljust('\U0001F468\u200D\U0001F469\u200D\U0001F467', 6) '👨‍👩‍👧 ' rrr_r`rar8rr~rrrrF text_width padding_cellsr&r&r'r: !  r:cCsB|r |r t|}nt|||d}td||}|||S)u) Return text right-justified in a string of given display width. :param text: String to justify, may contain terminal sequences. :param dest_width: Total display width of result in terminal cells. :param fillchar: Single character for padding (default space). Must have display width of 1 (not wide, not zero-width, not combining). Unicode characters like ``'·'`` are acceptable. The width is not validated. :param control_codes: How to handle control sequences when measuring. Passed to :func:`width` for measurement. :param ambiguous_width: Width to use for East Asian Ambiguous (A) characters. Default is ``1`` (narrow). Set to ``2`` for CJK contexts. :returns: Text padded on the left to reach ``dest_width``. .. versionadded:: 0.3.0 Example:: >>> wcwidth.rjust('hi', 5) ' hi' >>> wcwidth.rjust('\x1b[31mhi\x1b[0m', 5) ' \x1b[31mhi\x1b[0m' >>> wcwidth.rjust('\U0001F468\u200D\U0001F469\u200D\U0001F467', 6) ' 👨‍👩‍👧' rrrrr&r&r'r;rr;c Csf|r |r t|}nt|||d}td||}|d||@d@}||}|||||S)u Return text centered in a string of given display width. :param text: String to center, may contain terminal sequences. :param dest_width: Total display width of result in terminal cells. :param fillchar: Single character for padding (default space). Must have display width of 1 (not wide, not zero-width, not combining). Unicode characters like ``'·'`` are acceptable. The width is not validated. :param control_codes: How to handle control sequences when measuring. Passed to :func:`width` for measurement. :param ambiguous_width: Width to use for East Asian Ambiguous (A) characters. Default is ``1`` (narrow). Set to ``2`` for CJK contexts. :returns: Text padded on both sides to reach ``dest_width``. For odd-width padding, the extra cell goes on the right (matching Python's :meth:`str.center` behavior). .. versionadded:: 0.3.0 Example:: >>> wcwidth.center('hi', 6) ' hi ' >>> wcwidth.center('\x1b[31mhi\x1b[0m', 6) ' \x1b[31mhi\x1b[0m ' >>> wcwidth.center('\U0001F468\u200D\U0001F469\u200D\U0001F467', 6) ' 👨‍👩‍👧 ' rrrJrr) r~rrrrFr total_paddingleft_pad right_padr&r&r'r<!s$ r<cCs td|S)a Return text with all terminal escape sequences removed. Unknown or incomplete ESC sequences are preserved. :param text: String that may contain terminal escape sequences. :returns: The input text with all escape sequences stripped. .. versionadded:: 0.3.0 Example:: >>> strip_sequences('\x1b[31mred\x1b[0m') 'red' >>> strip_sequences('hello') 'hello' >>> strip_sequences('\x1b[1m\x1b[31mbold red\x1b[0m text') 'bold red text' r*)rsub)r~r&r&r'r>Ps r>T)rrrF propagate_sgrstartrirboolcCst|d}||kr dS|r|r|||S|r!d|vr!d}d}|r't}g} d} d} | t|kr6|| } | |krE|durE| dkrEn| dkrlt|| } rl| }|rbt|rbt ||}n| || } q-| dkrz| | | d7} q-| dkr|dkr| || |}| |kr|| kr|krnn | d|r|dur|}| d7} | |ksn| | | d7} q-t t || d }t||d }|dkr|| kr|krnnR| |nL| |kr| ||kr| ||r|dur|}| |7} n0| |kr&| ||kr&| |t|| |t|| |r!|dur!|}| |7} n| |7} | t|7} | t|ks4d| }|durTt|}rK||}t|rT|d 7}|S) u6 Clip text to display columns ``(start, end)`` while preserving all terminal sequences. This function extracts a substring based on visible column positions rather than character indices. Terminal escape sequences are preserved in the output since they have zero display width. If a wide character (width 2) would be split at either boundary, it is replaced with ``fillchar``. TAB characters (``\t``) are expanded to spaces up to the next tab stop, controlled by the ``tabsize`` parameter. Other cursor movement characters (backspace, carriage return) and cursor movement sequences are passed through unchanged as zero-width. :param text: String to clip, may contain terminal escape sequences. :param start: Absolute starting column (inclusive, 0-indexed). :param end: Absolute ending column (exclusive). :param fillchar: Character to use when a wide character must be split at a boundary (default space). Must have display width of 1. :param tabsize: Tab stop width (default 8). Set to 0 to pass tabs through as zero-width (preserved in output but don't advance column position). :param ambiguous_width: Width to use for East Asian Ambiguous (A) characters. Default is ``1`` (narrow). Set to ``2`` for CJK contexts. :param propagate_sgr: If True (default), SGR (terminal styling) sequences are propagated. The result begins with any active style at the start position and ends with a reset sequence if styles are active. :returns: Substring of ``text`` spanning display columns ``(start, end)``, with all terminal sequences preserved and wide characters at boundaries replaced with ``fillchar``. SGR (terminal styling) sequences are propagated by default. The result begins with any active style and ends with a reset:: >>> clip('\x1b[1;34mHello world\x1b[0m', 6, 11) '\x1b[1;34mworld\x1b[0m' Set ``propagate_sgr=False`` to disable this behavior. .. versionadded:: 0.3.0 .. versionchanged:: 0.5.0 Added ``propagate_sgr`` parameter (default True). Example:: >>> clip('hello world', 0, 5) 'hello' >>> clip('中文字', 0, 3) # Wide char split at column 3 '中 ' >>> clip('a\tb', 0, 10) # Tab expanded to spaces 'a b' rr*rFNrrr)rrXz)rr_r`r rarrrr r appendrinextrr8minjoinr r )r~rrirrrFrsgr_at_clip_startsgroutputcolrkrprrnext_tabgraphemerresultprefixr&r&r'r=gs A             "   @  r=)rBr)rCrDrErDrFrGrHrG)NrBr) rQrDrRrSrErDrFrGrHrG)rtrDrHru)r|rDrHrD)r~rDrHr)r)r~rDrFrGrHrG) r~rDrrrrGrFrGrHrG)r) r~rDrrGrrDrrrFrGrHrD)r~rDrHrD)r~rDrrGrirGrrDrrGrFrGrrrHrD)N__doc__ __future__r functoolsrtypingrrrLrrtable_mcr sgr_stater r r r r table_vs16r table_wider table_zerorrrrrrtable_graphemerrrtable_ambiguousrescape_sequencesrrrrunicode_versionsrcollections.abcrrr}rMrNriterrOrf frozensetr!rbrdrcrgrerrD maketransrr__all__r6r7r@r?r9rr8r:r;r<r>r=r&r&r&r's ?              4     4v,, /