viscii-codec

viscii-codec is a Python package adding support for the viscii codecs. viscii is a legacy vietnamese language codec.

This package has been tested on python 3.8, 3.8, 3.10, 3.11, 3.12, 3.13, and 3.14. It may work on other versions but they have not been tested.

Installation

The viscii-codec package is available on pypi and can be installed using any package manager.

pip install viscii-codec

uv add viscii-codec

Usage

To encode "Xin chào, thế giới!" (Hello World! according to translate) using viscii use:

# You must import the package to register the codec.
>>> import viscii
>>> "Xin chào, thế giới!".encode('viscii')
b'Xin ch\xe0o, th\xaa gi\xbei!'

To decode viscii bytes into unicode use:

>>> import viscii
>>> b'Xin ch\xe0o, th\xaa gi\xbei!'.decode('viscii')
'Xin chào, thế giới!'

Sources

The mapping was generated from RFC-1456 and cross referenced with the vietstd report of September 1992.

Testing

% python -m unittest
.
----------------------------------------------------------------------
Ran 1 test in 0.000s

OK