cjkjust

Having strings containing CJK characters left-, right-justified or centered conveniently.

Installation

pip install cjkjust

Functions

• is_wide(char) -> bool: returns whether a character char is wide
• cjklen(string) -> int: returns the display width of a string containing CJK characters
• cjkljust(string, width: int, fillbyte=' '): has string left-justified
• cjkrjust(string, width: int, fillbyte=' '): has string right-justified
• cjkcenter(string, width: int, fillbyte=' '): has string centered

Caveat: <TAB> in string ruins the print-out.

Examples

import cjkjust

# right-justify a column of strings
print(cjkjust.cjkrjust('hello 世界', 20))
print(cjkjust.cjkrjust('你好world', 20))
print(cjkjust.cjkrjust('again and again', 20))

Optional dependency

• wcwidth: if installed, 0-width characters will also be well handled in cjkljust, cjkrjust, and cjkcenter. Caveat: installing wcwidth and explicitly set cjkjust.raises_on_indeterminate to True implies that ValueError will be raised if indeterminate-width-characters (e.g. <TAB>) is in string

It can be installed along with cjkjust by:

pip install cjkjust[allchars]