chg8@dZddlmZddlZddlZddlZddlmZddlm Z ddl m Z ddl m Z  dd lmZn#e$r dd lmZYnwxYwejdd kZd Zed ddZddZed dZed dZdS)a 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 )divisionN)VS16_NARROW_TO_WIDE)WIDE_EASTASIAN) ZERO_WIDTH) list_versions) lru_cachecd}t|dz }||ddks|||dkrdS||kr@||zdz}|||dkr|dz}n|||dkr|dz }ndS||k@dS)aJ Auxiliary function for binary search in interval table. :arg int ucs: Ordinal value of unicode character. :arg list table: List of starting and ending ranges of ordinal values, in form of ``[(start, end), ...]``. :rtype: int :returns: 1 if ordinal value ucs is found within lookup table, else 0. rr)len)ucstablelbounduboundmids _/home/jenkins/workspace/simtester-sanitize/venv/lib/python3.11/site-packages/wcwidth/wcwidth.py _bisearchrXsF ZZ!^F U1Xa[C%-"222q F  1$ sA  1WFF 5:a= 1WFF1 F   1i)maxsizeautoc|rt|nd}d|cxkrdkrnndS|r|dksd|cxkrdkrnndSt|}t|t|rdSdt|t|zS)a  Given one Unicode character, return its printable length on a terminal. :param str wc: A single Unicode character. :param str unicode_version: A Unicode version number, such as ``'6.0.0'``. A list of version levels suported by wcwidth is returned by :func:`list_versions`. Any version string may be specified without error -- the nearest matching version is selected. When ``latest`` (default), the highest Unicode version level is used. :return: 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. :rtype: int See :ref:`Specification` for details of cell measurement. r r)ord_wcmatch_versionrrr)wcunicode_versionr_unicode_versions rwcwidthr"ss. #b'''QC  S4q sRxx5C////%/////r'88j!1233q yn-=>?? ??rcd}|t|n|}d}d}d}||kr||}|dkr|dz }|dkrY|rW|tt|}|dkr-|tt |t dz }d}|dz }yt ||} | dkr| S| dkr|}|| z }|dz }||k|S) a Given a unicode string, return its printable length on a terminal. :param str pwcs: Measure width of given unicode string. :param int n: When ``n`` is None (default), return the length of the entire string, otherwise only the first ``n`` characters are measured. This argument exists only for compatibility with the C POSIX function signature. It is suggested instead to use python's string slicing capability, ``wcswidth(pwcs[:n])`` :param str unicode_version: An explicit definition of the unicode version level to use for determination, may be ``auto`` (default), which uses the Environment Variable, ``UNICODE_VERSION`` if defined, or the latest available unicode version, otherwise. :rtype: int :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. Nru‍r u️) rrz9.0.0r)r _wcversion_valuerrrrr") pwcsnr r!endwidthidxlast_measured_charcharwcws rwcswidthr.s,y#d)))aC E C ))Cy 9   1HC  9  !3  '#34D_4U4U#V#V 9,,3'9#:#:>> _wcmatch_version('4.9.9') '4.1.0' >>> _wcmatch_version('8.0') '8.0.0' >>> _wcmatch_version('1') '4.1.0' :param str given_version: given version for compare, may be ``auto`` (default), to select Unicode Version from Environment Variable, ``UNICODE_VERSION``. If the environment variable is not set, then the latest is used. :rtype: str :returns: unicode string, or non-unicode ``str`` type for python 2 when given ``version`` is also type ``str``. c*|S)N)encode)rs rz"_wcmatch_version.. s rr)rrUNICODE_VERSIONlatest)r>r>zUNICODE_VERSION value, {given_version!r}, is invalid. Value should be in form of `integer[.]+', the latest supported unicode version {latest_version!r} has been inferred.) given_versionlatest_versionrzUNICODE_VERSION value, {given_version!r}, is lower than any available unicode version. Returning lowest version level, {earliest_version!r})r?earliest_versionrNFzCode path unreachable)_PY3 isinstancestrlistr3rosenvirongetr;r% ValueErrorwarningswarnformat enumerate IndexErrorr ) r? _return_strunicode_versionsr@ cmp_givenrAcmp_earliest_versionr*r cmp_next_versions rrrsB(=z-==K+ $<$ > > (3Q8H8O8O8Q8QQ!**: ; ;##_ R/0@q0IJJ   R R R)4Q>>.:O:O:Q:Q Q Q Q Q Q R (#i..9 9 9#C!G, , , , i ' '" " " " (L*M;KLLLLs%C$$A D21D2(G"G('G()r)Nr)__doc__ __future__rrFsysrJ table_vs16r table_wider table_zerorrPr functoolsr ImportErrorbackports.functools_lru_cache version_inforBrr"r.r%rrrr_s==|  ,+++++&&&&&&""""""++++++8#######888877777778  a   6 4)@)@)@)@X7777t 3    1qMqMqMqMqMs5 AA