wcwidth: Unicode String Width Measurement

0.6.0 · active · verified Sat Mar 28

wcwidth is a Python library that measures the displayed width of Unicode strings in a terminal, ensuring accurate text formatting. The current version is 0.6.0, released on January 22, 2022. The library is actively maintained with a release cadence of approximately every few months.

Warnings

breaking Version 0.5.0 dropped support for many historical versions of wide and zero Unicode tables, now only the latest Unicode version (17.0.0) is supported. The 'unicode_version' keyword in wcwidth() functions is ignored, and list_versions() returns a tuple with only the latest Unicode version.
Fix: Update your code to be compatible with Unicode version 17.0.0 and remove any reliance on the 'unicode_version' keyword.
deprecated The 'unicode_version' keyword in wcwidth() functions was deprecated in version 0.5.0 and is ignored in version 0.6.0.
Fix: Remove the 'unicode_version' keyword from your wcwidth() function calls.
gotcha The wcwidth function may not handle all Unicode characters correctly, especially those with ambiguous widths. It's important to test with a variety of characters to ensure accurate results.
Fix: Regularly test your application with diverse Unicode characters to identify and handle any width measurement issues.

Install

pip install wcwidth Install wcwidth

Imports

wcwidth
```
from wcwidth import wcwidth
```
Ensure correct import path to access the wcwidth function

Quickstart

This example demonstrates how to import the wcwidth function and use it to measure the width of a Unicode string.

from wcwidth import wcwidth

# Measure the width of a Unicode string
text = 'Hello, 世界'
width = wcwidth(text)
print(f'The width of the text is: {width}')

view raw JSON →