wcwidth

What's Changed

• Measure hyphen break positions by display width by @jakezwang in #262

Full Changelog: 0.8.4...0.8.5

What's Changed

• bugfix: restore ITU T.416 colon-format colors with colon separators by @jquast in #243
• add coverage artifact to .gitignore by @jquast in #245
• Fix VS15 applying more than once to the same base character by @jquast in #244
• Small fixes and refactor document structure/length by @jquast in #246
• Default arguments for clip(start=0, end=-1) by @jquast in #250
• libwcwidth, a portable C11 library by @jquast in #247
• Unicode 18.0.0 support, releases soonish by @jquast in #238
• Remove workarounds for draft unicode 18 tests by @jquast in #251
• Bugfix clip() can hang on OSC 8 hyperlinks by @jquast in #252
• Packaging and libwcwidth fixes by @jquast in #253
• bugfix clip() painter's algo and charset designator by @jquast in #259
• Prepare for Unicode 18.0 (w/correction tables) by @jquast in #260

Full Changelog: 0.8.3...0.8.4

What's Changed

• Fix hang wrapping OSC-8 hyperlinks with wide graphemes by @jquast in #232
• bugfix: clip() should behave like propagate_sgr() by @jquast in #235
• add twine_check to "tox -e lint" and CI by @jquast in #236

Full Changelog: 0.8.2...0.8.3

• bugfix: IndexError when 'n' exceeds length by @gaoflow in https://github.com/jquast/wcwidth/pull/228

Full Changelog: https://github.com/jquast/wcwidth/compare/0.8.1...0.8.2

• Improved corrections tables by @jquast in https://github.com/jquast/wcwidth/pull/226

Full Changelog: https://github.com/jquast/wcwidth/compare/0.8.0...0.8.1

• New support for Variation Selector 15 Emojis as narrow, #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() #206.
• Improved memory usage and import time for Python 3.15 using lazy imports #221.
• Bugfix Invisible_Stacker viramas now form conjuncts (Burmese, Khmer, etc.) and change some Virama width calculations to match jacobsandlund/uucode_ (ghostty) #223.
• Updated graphemes width maximum now 2, matching Ghostty, foot, and Windows Terminal #224.

Full Changelog: https://github.com/jquast/wcwidth/compare/0.7.0...0.8.0

• 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'.

PR's

• Remove docs, add utils by @jquast in #209
• Bump requests from 2.32.5 to 2.33.0 in /docs by @dependabot[bot] in #210
• Bump pygments from 2.19.2 to 2.20.0 in /docs by @dependabot[bot] in #212
• dependabot nonsense by @jquast in #215
• Expand terminal escape sequence for three more ECMA-48 "families" by @jquast in #214
• Improve clip() and width() with hyperlinks and overtyping by @jquast in #216
• Improve width() and clip() with kitty Text Sizing Protocol by @jquast in #213

Full Changelog: 0.6.0...0.7.0

• Complete textwrap.wrap() with 6 missing params! by @jquast in #207

Full Changelog: 0.5.3...0.6.0

• Add Virama conjunct for the Brahmic scripts by @jquast in #204

Full Changelog: 0.5.2...0.5.3

• Do not distribute any data files by @jquast in #199
• Update specs and zero-width tables regarding Mc by @jquast in #200
• Standalone emoji support by @jquast in #202

Full Changelog: 0.5.1...0.5.2

• Drop Support of many historical versions of wide and zero unicode tables. Only the latest Unicode version (17.0.0) is now shipped. The related unicode_version='auto' keyword of the wcwidth()-family of functions are ignored. list_versions() always returns a tuple of only a single element of the only unicode version supported. #195
• Performance improvement of most common call without version or ambiguous_width specified by 20%. #195
• New Function propagate_sgr() for applying SGR state propagation to a list of lines. #194
• Improved wrap() and clip() with propagate_sgr=True. #194
• Bugfix clip() zero-width characters at clipping boundaries. #194
• Bugfix OSC Hyperlinks when broken mid-text by wrap(). #193

Full Changelog: 0.4.0...0.5.0

• Bugfix: OSC Hyperlinks should not be broken by wrap() by @jquast in #191
• New functions: iter_graphemes_reverse(), grapheme_boundary_before() by @jquast in #192

Full Changelog: 0.3.5...0.4.0

• Re-stamp package version correctly, 0.3.4 packaged a failing test

Full Changelog: https://github.com/jquast/wcwidth/compare/0.3.4...0.3.5

• bugfix our center() padding algorithm by @jquast in https://github.com/jquast/wcwidth/pull/188
• docfix: accidental double-escapes \t -> \t by @jquast in https://github.com/jquast/wcwidth/pull/187

Full Changelog: https://github.com/jquast/wcwidth/compare/0.3.3...0.3.4

• Add fast path for ASCII printables to width() by @hugovk in https://github.com/jquast/wcwidth/pull/185
• Add py.typed file and Typing :: Typed classifier by @hugovk in https://github.com/jquast/wcwidth/pull/184

Full Changelog: https://github.com/jquast/wcwidth/compare/0.3.2...0.3.3

• type hinting for full mympy --strict compliance, by @penguinolog https://github.com/jquast/wcwidth/pull/183

Full Changelog: https://github.com/jquast/wcwidth/compare/0.3.1...0.3.2

• Add benchmarking using codspeed.io by @jquast in https://github.com/jquast/wcwidth/pull/180
• improve width() performance by @jquast in https://github.com/jquast/wcwidth/pull/181

Full Changelog: https://github.com/jquast/wcwidth/compare/0.3.0...0.3.1

Major changes since 0.2.14, in order

• Migrate from setup.py + setuptools to pyproject.toml + hatchling by @hugovk in https://github.com/jquast/wcwidth/pull/156
• Small improvements to update-tables.py and wcwidth-browser.py by @jquast in https://github.com/jquast/wcwidth/pull/160
• New: iter_graphemes() by @jquast in https://github.com/jquast/wcwidth/pull/165
• New: width() terminal-aware string measurement by @jquast in https://github.com/jquast/wcwidth/pull/166
• New: ljust(), rjust(), center() justify text by @jquast in https://github.com/jquast/wcwidth/pull/168
• New: wrap() by @jquast in https://github.com/jquast/wcwidth/pull/169
• improve wcswidth() performance ~30% by @jquast in https://github.com/jquast/wcwidth/pull/171
• New ambigous_width=1 argument by @jquast in https://github.com/jquast/wcwidth/pull/172
• New strip_sequences() and cut() functions by @jquast in https://github.com/jquast/wcwidth/pull/173
• Width 0 for Default_Ignorable_Code_Point characters by @jquast in https://github.com/jquast/wcwidth/pull/174
• Bugfix for Prepended_Concatenation_Mark characters by @jquast in https://github.com/jquast/wcwidth/pull/176

Full Changelog: https://github.com/jquast/wcwidth/compare/0.2.14...0.3.0

0.2.14 2025-09-22

• Drop Support for Python 2.7 and 3.5. PR #117.
• Update tables to include Unicode Specifications 16.0.0 and 17.0.0. PR #146.
• Bugfix U+00AD SOFT HYPHEN should measure as 1, versions 0.2.9 through 0.2.13 measured as 0. PR #149.

Full Changelog: https://github.com/jquast/wcwidth/compare/0.2.13...0.2.14

• Bugfix zero-width support for Hangul Jamo (Korean) #111

Remove a .pyi file was misplaced in the wheel file distributed on pypi for 0.2.11, issue #101

Include tests files in the source distribution (PR #98, PR #100).

0.2.10 2023-11-13

• Bugfix accounting of some kinds of emoji sequences using U+FE0F Variation Selector 16 (PR #97).
• Updated Specification.

• Bugfix zero-width characters used in Emoji ZWJ sequences, Balinese, Jamo, Devanagari, Tamil, Kannada and others (PR #91).
• Updated to include a Specification of character measurements.

Minor changes

• Include requirements files in the source distibution (PR #83).

Full Changelog: https://github.com/jquast/wcwidth/compare/0.2.7...0.2.8

Major changes

• Update Unicode version to 15.1.0 by @GalaxySnail in https://github.com/jquast/wcwidth/pull/77

Minor changes

• Add testing support for Python 3.12 by @hugovk in https://github.com/jquast/wcwidth/pull/72
• Update README by @GalaxySnail in https://github.com/jquast/wcwidth/pull/74
• Update requirements by @GalaxySnail in https://github.com/jquast/wcwidth/pull/73
• Enable GitHub Actions CI by @GalaxySnail in https://github.com/jquast/wcwidth/pull/76
• Prepare release 0.2.7 by @jquast in https://github.com/jquast/wcwidth/pull/78
• Update tox envs in README by @GalaxySnail in https://github.com/jquast/wcwidth/pull/80
• Include bin, docs, and tox.ini in the source distribution by @GalaxySnail in https://github.com/jquast/wcwidth/pull/81

Full Changelog: https://github.com/jquast/wcwidth/compare/0.2.6...0.2.7

What's Changed

• Fix example for str.rjust(20, '_') by @RasmusWL in https://github.com/jquast/wcwidth/pull/43
• Bugfix sphinx build on readthedocs.org by @jquast in https://github.com/jquast/wcwidth/pull/53
• Add CodeQL workflow for GitHub code scanning by @lgtm-com in https://github.com/jquast/wcwidth/pull/63
• Switch to using importlib.metadata by @s-t-e-v-e-n-k in https://github.com/jquast/wcwidth/pull/62
• Use a new jinja2 templating process to update library to latest unicode (15.0) by @jquast in https://github.com/jquast/wcwidth/pull/61

New Contributors

• @RasmusWL made their first contribution in https://github.com/jquast/wcwidth/pull/43
• @lgtm-com made their first contribution in https://github.com/jquast/wcwidth/pull/63
• @s-t-e-v-e-n-k made their first contribution in https://github.com/jquast/wcwidth/pull/62

Full Changelog: https://github.com/jquast/wcwidth/compare/0.2.5...0.2.6

• Do not depend on pkg_resources module for list_versions() function.

• minor "bugfix" to avoid using pkg_resources module on import, 7918f581feedeaa4246dc0fc03ec6fb49cff15cb
• may help xonsh https://github.com/xonsh/xonsh/issues/3607

PR #23: Support all versions of Unicode, using the UNICODE_VERSION environment variable, when defined, or, for non-shells, explicitly by passing argument unicode_version to the wcwidth family of functions.

A demonstration utility that determines the Terminal's Unicode Version is made available as a separate package, https://github.com/jquast/ucs-detect/ which contains a Problem and Solution statement.

• Performance optimization by @avylove , PR #35.
• Updated tables to Unicode Specification 13.0.0.

• Updated tables to Unicode Specification 9.0.0. (PR #18).

• Bugfix: Resolution of "combining character width" issue, most especially those that previously returned -1 now often (correctly) return 0. resolved by Philip Craig via PR #11.
• Deprecated: The module path wcwidth.table_comb is no longer available, it has been superseded by module path wcwidth.table_zero.

0.1.4

• Feature: wcswidth() now determines printable length for (most) combining characters. The developer's tool bin/wcwidth-browser.py is improved to display combining characters when provided the --combining option (@thomasballinger and @lmontopo PR #5).
• added static analysis (prospector) to testing framework.

• Bugfix: 2nd parameter of wcswidth was not honored. (@thomasballinger PR #4).

Changes

0.1.2

• Updated tables to Unicode Specification 7.0.0 (PR #3)