wcwidth 0.6.0__tar.gz → 0.8.0__tar.gz

{wcwidth-0.6.0 → wcwidth-0.8.0}/.pylintrc

@@ -26,6 +26,8 @@ disable=
     too-many-boolean-expressions,
     redundant-u-string-prefix,
     consider-using-f-string,
+    consider-using-max-builtin,
+    consider-using-min-builtin,
 
 [FORMAT]
 max-line-length: 100

{wcwidth-0.6.0 → wcwidth-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wcwidth
-Version: 0.6.0
+Version: 0.8.0
 Summary: Measures the displayed width of unicode strings in a terminal
 Project-URL: Homepage, https://github.com/jquast/wcwidth
 Author-email: Jeff Quast <contact@jeffquast.com>
@@ -20,6 +20,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Internationalization
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Localization
@@ -28,6 +29,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.8
 Description-Content-Type: text/x-rst
 
+
 |pypi_downloads| |codecov| |license|
 
 ============
@@ -65,33 +67,49 @@ Some examples of **incorrect results**:
 Solution
 --------
 
-The lowest-level functions in this library are the POSIX.1-2001 and POSIX.1-2008 `wcwidth(3)`_ and
-`wcswidth(3)`_, which this library precisely copies by interface as `wcwidth()`_ and `wcswidth()`_.
-These functions return -1 when C0 and C1 control codes are present.
+The lowest-level functions in this library are derived from POSIX.1-2001 and POSIX.1-2008
+`wcwidth(3)`_ and `wcswidth(3)`_, which this library precisely copies by interface as `wcwidth()`_
+and `wcswidth()`_.  These functions return -1 when C0 and C1 control codes are present.
 
 An easy-to-use `width()`_ function is provided as a wrapper of `wcswidth()`_ that is also capable of
 measuring most terminal control codes and sequences, like colors, bold, tabstops, and horizontal
-cursor movement.
+cursor movement. `width()`_ argument ``term_program`` may provide more accurate terminal measurement
+Corrections_ as a wrapper of `wcstwidth()`_.
+
+Text-justification is solved by the sequence-aware functions `ljust()`_, `rjust()`_, `center()`_,
+and the grapheme-aware function `wrap()`_, serving as drop-in replacements to python standard
+functions.
 
-Text-justification is solved by the grapheme and sequence-aware functions `ljust()`_,
-`rjust()`_, `center()`_, and `wrap()`_, serving as drop-in replacements to python standard functions
-of the same names.
+The `clip()`_ function extracts substrings by their displayed column positions, and
+`strip_sequences()`_ removes terminal escape sequences from text altogether.
 
 The iterator functions `iter_graphemes()`_ and `iter_sequences()`_ allow for careful navigation of
-grapheme and terminal control sequence boundaries.  `iter_graphemes_reverse()`_, and
-`grapheme_boundary_before()`_ are useful for editing and searching of complex unicode.  The
-`clip()`_ function extracts substrings by display column positions, and `strip_sequences()`_ removes
-terminal escape sequences from text altogether.
+grapheme and terminal control sequence boundaries as required by editors or REPLs with cursor
+control.  `iter_graphemes_reverse()`_ and `grapheme_boundary_before()`_ are necessary for backward
+cursor control over complex unicode.
 
 Discrepancies
 -------------
 
 You may find that support *varies* for complex unicode sequences or codepoints.
 
-A companion utility, `jquast/ucs-detect`_ was authored to gather and publish the results of Wide
-character, language/grapheme clustering and complex script support, emojis and zero-width joiner,
+This library may be considered to presume the terminal is enabled for DEC Private Mode 2027
+("Grapheme Clustering") by default, which may require to be enabled by a TUI application but
+is often the default mode for those terminals that support it: Windows Terminal, WezTerm, ghostty,
+contour, and foot. This library does support any specific "legacy width" measurement, but does
+provide Corrections_ for those terminals without grapheme support.
+
+See also:
+
+- `Grapheme Clusters and Terminal Emulators`_
+- `terminal-unicode-core.tex`_
+- `State of Terminal Emulators in 2025`_
+- `Report of terminals supporting Graphemes (2027)`_
+
+The `jquast/ucs-detect`_ project publishes automatic results of compliance to our standard for Wide
+character, Languages, grapheme clustering, complex or combining scripts, emojis, zero-width joiner,
 variations, and regional indicator (flags) as a `General Tabulated Summary`_ by terminal emulator
-software and version.
+software and version. The results of the ucs-detect project create our correction tables.
 
 ========
 Overview
@@ -138,40 +156,95 @@ Use function `wcswidth()`_ to determine the length of many, a *string of unicode
 See specification_ of character measurements. Note that ``-1`` is returned if control codes occurs
 anywhere in the string.
 
+wcstwidth()
+-----------
+
+Same behavior as `wcswidth()`_ with automatic terminal-specific Corrections_, reading
+``TERM_PROGRAM`` or ``TERM`` when ``True`` (default), or caller can provide terminal query
+XTVERSION_ or ENQ_ response:
+
+.. code-block:: python
+
+    >>> # '♀️' emoji w/vs-16, uncorrected:
+    >>> wcwidth.wcswidth('\u2640\ufe0f')
+    2
+    >>> # corrected,
+    >>> wcwidth.wcstwidth('\u2640\ufe0f', term_program='vte')
+    1
+
 width()
 -------
 
-Use function `width()`_ to measure a string with improved handling of ``control_codes``.
+Use function `width()`_ to measure a string with improved handling of ``control_codes`` and
+measurement Corrections_ through ``term_program``:.
 
 .. code-block:: python
 
     >>> # same support as wcswidth(), eg. regional indicator flag:
     >>> wcwidth.width('\U0001F1FF\U0001F1FC')
     2
-    >>> # but also supports SGR colored text, 'WARN', followed by SGR reset
+    >>> # set term_program=True to use wcstwidth()
+    >>> wcwidth.width('\U0001F1FF\U0001F1FC', term_program=True)
+    1
+    >>> # or set term_program for measurement of a specific terminal
+    >>> wcwidth.width('\U0001F1FF\U0001F1FC', term_program='contour')
+    2
+    >>> # but also supports sequences, like SGR colored text, "WARN", followed by reset
     >>> wcwidth.width('\x1b[38;2;255;150;100mWARN\x1b[0m')
     4
-    >>> # tabs,
+    >>> # tabs are measured as though the string begins at a tabstop,
     >>> wcwidth.width('\t', tabsize=4)
     4
-    >>> # or, tab and all other control characters can be ignored
-    >>> wcwidth.width('\t', control_codes='ignore')
+    >>> # or, all control characters can be ignored (including tab)
+    >>> wcwidth.width('\t\n\a\r', control_codes='ignore')
     0
-    >>> # "vertical" control characters are ignored
-    >>> wcwidth.width('\n')
-    0
-    >>> # as well as sequences with "indeterminate" effects like Home + Clear
+    >>> # sequences with "indeterminate" effects like Home + Clear are zero-width
     >>> wcwidth.width('\x1b[H\x1b[2J')
     0
+    >>> # horizontal cursor movements are parsed,
+    >>> wcwidth.width('hello\b\b\b\b\bworld')
+    5
+    >>> wcwidth.width('hello\x1b[5Dworld')
+    5
+    >>> # or ignored,
+    >>> wcwidth.width('hello\x1b[5Dworld', control_codes='ignore')
+    10
+    >>> # Measure width of text using kitty text sizing protocol (OSC 66),
+    >>> width('\x1b]66;w=2;XY\x07')
+    2
+    >>> # Scaled text sizing: each grapheme occupies 'scale' cells
+    >>> width('\x1b]66;s=2;ABC\x07')
+    6
+
+Use ``control_codes='ignore'`` when the input is known not to contain any control characters or
+terminal sequences for slightly improved performance. Note that TAB (``'\t'``) is a control
+character and is also ignored, you may want to use `str.expandtabs()`_, first.
+
+Use ``control_codes='strict'`` when input is known to contain some control sequences, such as
+SGR color, bold, hyperlinks and cursor movement. Any sequence that cannot be accurately parsed
+for horizontal measurement, such as clearing the screen, vertical, or absolute cursor movement will
+raise ``ValueError``:
+
+.. code-block:: python
+
     >>> # or, raise ValueError for "indeterminate" effects using control_codes='strict'
     >>> wcwidth.width('\n', control_codes='strict')
     Traceback (most recent call last):
     ...
     ValueError: Vertical movement character 0xa at position 0
 
-Use ``control_codes='ignore'`` when the input is known not to contain any control characters or
-terminal sequences for slightly improved performance. Note that TAB (``'\t'``) is a control
-character and is also ignored, you may want to use `str.expandtabs()`_, first.
+
+    >>> wcwidth.width('\x1b[H\x1b[2J', control_codes='strict')
+    Traceback (most recent call last):
+    ...
+    ValueError: Indeterminate cursor sequence at position 0, '\x1b[H'
+
+
+    >>> # cursor left movement beyond string start raises in strict mode,
+    >>> wcwidth.width('a\x1b[5Da', control_codes='strict')
+    Traceback (most recent call last):
+    ...
+    ValueError: Cursor left movement at position 1 would move 5 cells left from column 1, exceeding string start
 
 iter_sequences()
 ----------------
@@ -290,9 +363,29 @@ Use `clip()`_ to extract a substring by column positions, preserving terminal se
     >>> clip('\x1b[1;31mHello world\x1b[0m', 6, 11)
     '\x1b[1;31mworld\x1b[0m'
 
-    >>> # Disable SGR propagation to preserve original sequences as-is
-    >>> clip('\x1b[31m中文\x1b[0m', 0, 3, propagate_sgr=False)
-    '\x1b[31m中 \x1b[0m'
+    >>> # Disable SGR propagation to preserve sequence order outside of clip boundary
+    >>> clip('\x1b[31m中文\x1b[32m', 0, 3, propagate_sgr=False)
+    '\x1b[31m中 \x1b[32m'
+
+    >>> # Cursor-left overwrites previous text (painter's algorithm)
+    >>> clip('hello\x1b[2DXY', 0, 5)
+    'helXY'
+    >>> # Carriage return resets to column 0, overwriting earlier cells
+    >>> clip('abc\rXY', 0, 5)
+    'XYc'
+
+    >>> # even OSC 8 hyperlink text may be clipped, 'Click This link' -> 'is link' !
+    >>> clip('\x1b]8;;http://example.com\x07Click This link\x1b]8;;\x07', 8, 15)
+    '\x1b]8;;http://example.com\x07is link\x1b]8;;\x07'
+
+    >>> # and OSC 66 kitty text sizing, supporting width and scale, 'Look' -> '...ook'
+    >>> clip('\x1b]66;w=4:s=4;Look\x07', 1, 16, fillchar='.')
+    '...\x1b]66;s=4:w=3;ook\x07'
+
+Use ``overtyping=False`` when the input is known not to contain any cursor movement characters
+(``\b``, ``\r``, ``CSI C``, ``CSI D``, ``CSI G``) for improved performance.  When
+``overtyping=None`` (default), a slower "Painter's algorithm" may be used after testing for the
+presence of these characters. ``overtyping`` has no effect when ``control_codes='ignore'``.
 
 strip_sequences()
 -----------------
@@ -307,7 +400,7 @@ Use `strip_sequences()`_ to remove all terminal escape sequences from text.
 
 .. _ambiguous_width:
 
-ambiguous_width
+Ambiguous Width
 ---------------
 
 Some Unicode characters have "East Asian Ambiguous" (A) width. These characters display as 1 cell by
@@ -315,6 +408,9 @@ default, matching Western terminal contexts, but many CJK (Chinese, Japanese, Ko
 may have a preference for 2 cells.  This is often found as boolean option, "Ambiguous width as wide"
 in Terminal Emulator software preferences.
 
+The ``ambiguous_width`` parameter is available on all width-measuring functions: `wcwidth()`_,
+`wcswidth()`_, `width()`_, `ljust()`_, `rjust()`_, `center()`_, `wrap()`_, and `clip()`_.
+
 By default, wcwidth treats ambiguous characters as narrow (width 1). For CJK environments where your
 terminal is configured to display ambiguous characters as double-width, pass ``ambiguous_width=2``:
 
@@ -326,9 +422,6 @@ terminal is configured to display ambiguous characters as double-width, pass ``a
     >>> wcwidth.width('\u2460', ambiguous_width=2)
     2
 
-The ``ambiguous_width`` parameter is available on all width-measuring functions: `wcwidth()`_,
-`wcswidth()`_, `width()`_, `ljust()`_, `rjust()`_, `center()`_, `wrap()`_, and `clip()`_.
-
 **Terminal Detection**
 
 The most reliable method to detect whether a terminal profile is set for "Ambiguous width as wide"
@@ -336,7 +429,7 @@ mode is to display an ambiguous character surrounded by a pair of Cursor Positio
 queries with a terminal in cooked or raw mode, and to parse the responses for their ``(y, x)``
 locations and measure the difference ``x``.
 
-This code should also be careful check whether it is attached to a terminal and be careful of
+This code should also be careful to check whether it is attached to a terminal and be careful of
 possible timeout, slow network, or non-response when working with "dumb terminals" like a CI build.
 
 `jquast/blessed`_ library provides such a helping `Terminal.detect_ambiguous_width()`_ method:
@@ -352,6 +445,90 @@ possible timeout, slow network, or non-response when working with "dumb terminal
     >>> awidth('\u2460')
     1
 
+Corrections
+-----------
+
+Corrections are automatically applied depending on detected or given terminal software name
+beginning with wcwidth release 0.8.0. This allows to correct widths for terminal software that
+differs from the standard.  These corrections are sourced from the `jquast/ucs-detect`_ project.
+
+The ``term_program`` parameter is available on all width-measuring functions: `wcstwidth()`_,
+`width()`_, `ljust()`_, `rjust()`_, `center()`_, `wrap()`_, and `clip()`_.
+
+`wcstwidth()`_ defaults to ``term_program=True``, auto-detecting the terminal from the
+``TERM_PROGRAM`` or ``TERM`` environment variable.  All other functions default to
+``term_program=False``, disabling corrections.  Use ``term_program=True`` for automatic
+detection by environment values of ``TERM`` and ``TERM_PROGRAM``.
+
+.. code-block:: python
+
+    # VTE terminals (Gnome Terminal Et al.) still render trigrams as narrow (1 cell), but their
+    # definition was changed to wide in Unicode 16 (September 2024).
+    >>> wcwidth.wcswidth('\u2630')
+    2
+    >>> wcwidth.wcstwidth('\u2630', term_program='vte')
+    1
+
+    # account for Alacritty non-support of emoji ZWJ:
+    # man + ZWJ + woman + ZWJ + girl + ZWJ + boy
+    >>> family = '\U0001F468\u200D\U0001F469\u200D\U0001F467\u200D\U0001F466'
+    >>> wcwidth.wcswidth(family)
+    2
+    >>> wcwidth.wcstwidth(family, term_program='alacritty')
+    8
+
+Only detectable_ terminals are included: those that identify themselves by XTVERSION_, ENQ_, any
+``TERM_PROGRAM`` or a unique ``TERM`` environment value.  For the most accurate correction tables,
+query the terminal's software version via XTVERSION_ (``CSI > q``) using a higher-level interactive
+terminal library like `jquast/blessed`_:
+
+.. code-block:: python
+
+    >>> import blessed, wcwidth
+    >>> term = blessed.Terminal()
+    >>> sw_ver = term.get_software_version()
+    >>> print(sw_ver)
+    SoftwareVersion(name='VTE', version='7600')
+    >>> wcwidth.width('\u2630', term_program=sw_ver.name)
+    1
+
+This is important because ``TERM_PROGRAM`` is not forwarded for remote hosts, like SSH, and many
+terminals may only be identified using XTVERSION_ or ENQ_.  Use `list_term_programs()`_ to see all
+recognized names:
+
+.. BEGIN_LIST_TERM_PROGRAMS
+.. code-block:: python
+
+    >>> wcwidth.list_term_programs()
+    ('alacritty', 'apple_terminal', 'bobcat', 'contour', 'extraterm', 'foot',
+     'ghostty', 'hyper', 'iterm.app', 'iterm2', 'kitty', 'konsole', 'mintty',
+     'mlterm', 'pterm', 'putty', 'rio', 'rxvt', 'rxvt-unicode-256color', 'st',
+     'st-256color', 'tabby', 'terminology', 'urxvt', 'vscode', 'vte', 'warp',
+     'warpterminal', 'wezterm', 'xterm', 'xterm-ghostty', 'xterm-kitty',
+     'xterm.js')
+
+.. END_LIST_TERM_PROGRAMS
+
+``term_program=False`` (the default for `width()`_, `ljust()`_, `rjust()`_, `center()`_,
+`wrap()`_, and `clip()`_) disables terminal corrections.  `wcstwidth()`_ defaults to
+``term_program=True`` for auto-detection.
+
+For automatic tests and other purposes that require cross-environment consistency, set static values
+or unset ``TERM`` and ``TERM_PROGRAM`` environment values, such as in ``conftest.py`` with pytest:
+
+.. code-block:: python
+
+    @pytest.fixture(autouse=True)
+    def _clear_term_program():
+        """unset TERM/TERM_PROGRAM before each test."""
+        saved_term = os.environ.pop('TERM', None)
+        saved_tprog = os.environ.pop('TERM_PROGRAM', None)
+        yield
+        if saved_term is not None:
+            os.environ['TERM'] = saved_term
+        if saved_tprog is not None:
+            os.environ['TERM_PROGRAM'] = saved_tprog
+
 ==========
 Developing
 ==========
@@ -429,9 +606,18 @@ This library is used in:
 - `jquast/blessed`_: a thin, practical wrapper around terminal capabilities in
   Python.
 
+- `jquast/telix`_:  A Modern telnet client especially designed for BBSs and MUDs.
+
 - `prompt-toolkit/python-prompt-toolkit`_: a Library for building powerful
   interactive command lines in Python.
 
+- `urwid/urwid`_: Console user interface library for Python
+
+- `prettytable/prettytable`_:  Display tabular data in a visually appealing ASCII table format
+
+- `leviathan0992/Pylsy`_:  Pylsy is a simple python library draw tables in the Terminal. Just two
+  lines of code.
+
 - `dbcli/pgcli`_: Postgres CLI with autocompletion and syntax highlighting.
 
 - `thomasballinger/curtsies`_: a Curses-like terminal wrapper with a display
@@ -448,8 +634,8 @@ This library is used in:
 - `nbedos/termtosvg`_: Terminal recorder that renders sessions as SVG
   animations.
 
-- `peterbrittain/asciimatics`_: Package to help people create full-screen text
-  UIs.
+- `peterbrittain/asciimatics`_: A cross platform package to do curses-like operations, plus higher
+  level APIs and widgets to create text UIs and ASCII art animations
 
 - `python-cmd2/cmd2`_: A tool for building interactive command line apps
 
@@ -466,9 +652,18 @@ This library is used in:
 Other Languages
 ===============
 
-There are similar implementations of the `wcwidth()`_ and `wcswidth()`_ functions in other
-languages.
+The following libraries provide grapheme and emoji support and closely align with our
+specification_:
+
+- `jacobsandlund/uucode`_ Zig
+- `contour-terminal/libunicode`_ C++20
 
+There are similar implementations of at least the `wcwidth()`_ and `wcswidth()`_ functions in other
+languages:
+
+- `ridiculousfish/widecharwidth`_: Python
+- `termux/wcwidth`_: C
+- `powerman/wcwidth-icons`_: C
 - `timoxley/wcwidth`_: JavaScript
 - `janlelis/unicode-display_width`_: Ruby
 - `alecrabbit/php-wcwidth`_: PHP
@@ -478,6 +673,9 @@ languages.
 - `grepsuzette/wcwidth`_: Haxe
 - `aperezdc/lua-wcwidth`_: Lua
 - `joachimschmidt557/zig-wcwidth`_: Zig
+- `mycoboco/wcwidth.js`_: JavaScript
+- `ainame/swift-displaywidth`_: Swift
+- `pmonks/clj-wcwidth`_: Clojure
 - `fumiyas/wcwidth-cjk`_: `LD_PRELOAD` override
 - `joshuarubin/wcwidth9`_: Unicode version 9 in C
 - `spectreconsole/wcwidth`_: C#
@@ -486,6 +684,29 @@ languages.
 History
 =======
 
+0.8.0 *(unreleased)*
+  * **New** support for Variation Selector 15 Emojis as narrow, `Issue #211`_.
+  * **New** argument, ``term_program`` for `wcstwidth()`_, `width()`_, `clip()`_, `wrap()`_,
+    `ljust()`_, `rjust()`_, and `center()`_.  ``False`` disables corrections; ``True``
+    auto-detects by ``TERM_PROGRAM`` or ``TERM``; string values accept canonical names matching
+    `list_term_programs()`_.  `wcstwidth()`_ defaults to ``True``; all other functions
+    default to ``False``.
+  * **Improved** performance on Python 3.15 using standard library iter_graphemes() `PR #206`_.
+  * **Improved** memory usage and import time for Python 3.15 using lazy imports `PR #221`_.
+  * **Bugfix** Invisible_Stacker viramas now form conjuncts (Burmese, Khmer, etc.) and
+    change some Virama width calculations to match `jacobsandlund/uucode`_ (ghostty) `PR #223`_.
+  * **Updated** graphemes width maximum now 2, matching Ghostty, foot, and Windows Terminal `PR
+    #224`_.
+
+0.7.0 *2026-05-02*
+  * **New** support for `kitty text sizing protocol`_ (OSC 66) in `width()`_ and `clip()`_.
+  * **New** `clip()`_ parameter ``control_codes='parse'``, ``'ignore'``, and ``'strict'``. `clip()`_
+    is now able to clip OSC 8 hyperlinks and OSC 66 text sizing sequences.
+  * **Improved** `clip()`_ and `width()`_ to support horizontal cursor sequences (``cub``, ``cuf``,
+    ``hpa``). Cursor-left (``cub``) or backspace (``\b``) now overwrites text.  ``column_address``
+    (``hpa``) and carriage return (``\r``) are now parsed, and more values conditionally raise
+    ``ValueError`` when ``control_codes='strict'``.
+
 0.6.0 *2026-02-06*
   * **New** Parameters ``expand_tabs``, ``replace_whitespace``, ``fix_sentence_endings``,
     ``drop_whitespace``, ``max_lines``, and ``placeholder`` for `wrap()`_, completing stdlib
@@ -707,10 +928,16 @@ https://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c::
 .. _`PR #200`: https://github.com/jquast/wcwidth/pull/200
 .. _`PR #202`: https://github.com/jquast/wcwidth/pull/202
 .. _`PR #204`: https://github.com/jquast/wcwidth/pull/204
+.. _`PR #206`: https://github.com/jquast/wcwidth/pull/206
+.. _`PR #221`: https://github.com/jquast/wcwidth/pull/221
+.. _`PR #223`: https://github.com/jquast/wcwidth/pull/223
+.. _`PR #224`: https://github.com/jquast/wcwidth/pull/224
 .. _`Issue #101`: https://github.com/jquast/wcwidth/issues/101
 .. _`Issue #155`: https://github.com/jquast/wcwidth/issues/155
 .. _`Issue #190`: https://github.com/jquast/wcwidth/issues/190
+.. _`Issue #211`: https://github.com/jquast/wcwidth/issues/211
 .. _`jquast/blessed`: https://github.com/jquast/blessed
+.. _`jquast/telix`: https://github.com/jquast/telix
 .. _`selectel/pyte`: https://github.com/selectel/pyte
 .. _`thomasballinger/curtsies`: https://github.com/thomasballinger/curtsies
 .. _`dbcli/pgcli`: https://github.com/dbcli/pgcli
@@ -735,10 +962,21 @@ https://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c::
 .. _`fumiyas/wcwidth-cjk`: https://github.com/fumiyas/wcwidth-cjk
 .. _`joshuarubin/wcwidth9`: https://github.com/joshuarubin/wcwidth9
 .. _`spectreconsole/wcwidth`: https://github.com/spectreconsole/wcwidth
+.. _`contour-terminal/libunicode`: https://github.com/contour-terminal/libunicode
+.. _`jacobsandlund/uucode`: https://github.com/jacobsandlund/uucode
+.. _`ridiculousfish/widecharwidth`: https://github.com/ridiculousfish/widecharwidth
+.. _`termux/wcwidth`: https://github.com/termux/wcwidth
+.. _`powerman/wcwidth-icons`: https://github.com/powerman/wcwidth-icons
+.. _`mycoboco/wcwidth.js`: https://github.com/mycoboco/wcwidth.js
+.. _`ainame/swift-displaywidth`: https://github.com/ainame/swift-displaywidth
+.. _`pmonks/clj-wcwidth`: https://github.com/pmonks/clj-wcwidth
 .. _`python-cmd2/cmd2`: https://github.com/python-cmd2/cmd2
 .. _`stratis-storage/stratis-cli`: https://github.com/stratis-storage/stratis-cli
 .. _`ihabunek/toot`: https://github.com/ihabunek/toot
 .. _`saulpw/visidata`: https://github.com/saulpw/visidata
+.. _`urwid/urwid`: https://github.com/urwid/urwid
+.. _`prettytable/prettytable`: https://github.com/prettytable/prettytable
+.. _`leviathan0992/Pylsy`: https://github.com/leviathan0992/Pylsy
 .. _`pip-tools`: https://pip-tools.readthedocs.io/
 .. _`sphinx`: https://www.sphinx-doc.org/
 .. _`textwrap.wrap()`: https://docs.python.org/3/library/textwrap.html#textwrap.wrap
@@ -749,6 +987,7 @@ https://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c::
 .. _`General Tabulated Summary`: https://ucs-detect.readthedocs.io/results.html#tabulated-results
 .. _`wcwidth()`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.wcwidth
 .. _`wcswidth()`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.wcswidth
+.. _`wcstwidth()`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.wcstwidth
 .. _`width()`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.width
 .. _`iter_graphemes()`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.iter_graphemes
 .. _`iter_graphemes_reverse()`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.iter_graphemes_reverse
@@ -760,11 +999,22 @@ https://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c::
 .. _`clip()`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.clip
 .. _`strip_sequences()`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.strip_sequences
 .. _`propagate_sgr()`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.propagate_sgr
+.. _`TextSizing`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.TextSizing
+.. _`TextSizingParams`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.TextSizingParams
 .. _`iter_sequences()`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.iter_sequences
 .. _`list_versions()`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.list_versions
+.. _`list_term_programs()`: https://wcwidth.readthedocs.io/en/latest/api.html#wcwidth.list_term_programs
 .. _`Unicode Standard Annex #29`: https://www.unicode.org/reports/tr29/
 .. _`Terminal.detect_ambiguous_width()`: https://blessed.readthedocs.io/en/latest/api/terminal.html#blessed.terminal.Terminal.detect_ambiguous_width
 .. _`parity padding`: https://jazcap53.github.io/pythons-eccentric-strcenter.html
+.. _`kitty text sizing protocol`: https://sw.kovidgoyal.net/kitty/text-sizing-protocol/
+.. _`Grapheme Clusters and Terminal Emulators`: https://mitchellh.com/writing/grapheme-clusters-in-terminals
+.. _`terminal-unicode-core.tex`: https://github.com/contour-terminal/terminal-unicode-core/blob/master/spec/terminal-unicode-core.tex
+.. _`State of Terminal Emulators in 2025`: https://www.jeffquast.com/post/state-of-terminal-emulation-2025/
+.. _`Report of terminals supporting Graphemes (2027)`: https://ucs-detect.readthedocs.io/results.html#terminal-features
+.. _XTVERSION: https://vtdn.dev/docs/dcs/xtversion/
+.. _ENQ: https://documentation.help/PuTTY/config-answerback.html
+.. _detectable: https://ucs-detect.readthedocs.io/results.html#terminal-identification
 .. |pypi_downloads| image:: https://img.shields.io/pypi/dm/wcwidth.svg?logo=pypi
     :alt: Downloads
     :target: https://pypi.org/project/wcwidth/

wcwidth-0.8.0/bin/show-sequences

@@ -0,0 +1,23 @@
+#!/usr/bin/env python3
+"""Show terminal escape sequences in a file or stdin as repr() literals."""
+# std imports
+import sys
+
+# local
+from wcwidth import iter_sequences
+
+
+def _read_input():
+    # some care is taken regarding '\r\n' because this program is meant to show
+    # raw terminal data to terminals that are *not* in raw mode, so different
+    # interpretation of '\r\n' is needed.
+    if len(sys.argv) > 1:
+        with open(sys.argv[1], "rb") as f:
+            return f.read().replace(b"\r\n", b"\n").decode()
+    return sys.stdin.buffer.read().replace(b"\r\n", b"\n").decode()
+
+
+for line in _read_input().split("\n"):
+    for item, is_seq in iter_sequences(line):
+        print(repr(item) if is_seq else item.replace("\r", repr("\r")), end="")
+    print("", flush=True)

wcwidth-0.8.0/bin/strip-sequences

@@ -0,0 +1,18 @@
+#!/usr/bin/env python3
+"""Strip terminal escape sequences from a file or stdin."""
+# std imports
+import sys
+
+# local
+from wcwidth import strip_sequences
+
+# some care is taken regarding '\r\n' because this program is meant to show
+# raw terminal data to terminals that are *not* in raw mode, so different
+# interpretation of '\r\n' is needed.
+
+if len(sys.argv) > 1:
+    with open(sys.argv[1], "rb") as f:
+        text = f.read().replace(b"\r\n", b"\n").replace(b"\r", b"").decode()
+else:
+    text = sys.stdin.buffer.read().replace(b"\r\n", b"\n").replace(b"\r", b"").decode()
+sys.stdout.write(strip_sequences(text))