wcwidth 0.1.5

Introduction

This API is mainly for Terminal Emulator implementors, or those writing programs that expect to interpreted by a terminal emulator and wish to determine the printable width of a string on a Terminal.

Usually, the length of the string is equivalent to the number of cells it occupies except that there are are also some categories of characters which occupy 2 or even 0 cells. POSIX-conforming systems provide wcwidth(3) and wcswidth(3) of which this module’s interface mirrors precisely.

This library aims to be forward-looking, portable, and most correct. The most current release of this API is based from Unicode Standard release files:

EastAsianWidth-8.0.0.txt

2015-02-10, 21:00:00 GMT [KW, LI]

DerivedGeneralCategory-8.0.0.txt

2015-02-13, 13:47:11 GMT [MD]

pip install wcwidth

>>> from wcwidth import wcswidth
>>> text = u'コンニチハ'
>>> print(u' ' * (80 - wcswidth(text)) + text)

$ pydoc wcwidth

Caveats

This library does its best to return the most appropriate return value for a very particular terminal user interface where a monospaced fixed-cell rendering is expected. As the POSIX Terminal programming interface does not provide any means to determine the unicode support level of a connecting terminal, we can only do our best to return what we assume to be correct for the given codepoint, and not the result of any terminal emulator particular.

Developing

Execute the command python setup.py develop to prepare an environment for running tests (python setup.py test), updating tables ( python setup.py update) or using any of the scripts in the bin/ sub-folder. These files are only made available in the source repository.

You may determine an exacting list of these discrepancies using the project file wcwidth-libc-comparator.py.

History

0.1.5 2015-09-13 Alpha

• 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 2014-11-20 Pre-Alpha

• 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 (Thomas Ballinger and Leta Montopoli PR #5).

• Feature: added static analysis (prospector) to testing framework.

0.1.3 2014-10-29 Pre-Alpha

• Bugfix: 2nd parameter of wcswidth was not honored. (Thomas Ballinger, PR #4).

0.1.2 2014-10-28 Pre-Alpha

• Updated tables to Unicode Specification 7.0.0. (Thomas Ballinger, PR #3).

0.1.1 2014-05-14 Pre-Alpha

• Initial release to pypi, Based on Unicode Specification 6.3.0