Skip to main content

Hanzi Converter for Traditional and Simplified Chinese

Project description

This tool converts between simplified and traditional Chinese Characters. It consists of two parts:

  • a command line tool: hanzi-convert

  • a python library: hanziconv

Build Statu Latest Version Documentation License

Installation

$ pip install hanziconv

Command Line Tool

The tool requires Python 2.7+ (should work for Python 2.6, 3.0 and 3.1 but was not tested)

Synopsis

$ ./hanzi-convert --help
usage: hanzi-convert [-h] [-o OUTFILE] [-s] [-v] infile

Simplified and Traditional Chinese Character Conversion
Version 0.2.2 (By Bernard Yue)

Converting to Traditional Hanzi by default with no -s flag

positional arguments:
  infile                filename | "-", corresponds to stdin

optional arguments:
  -h, --help            show this help message and exit
  -o OUTFILE, --output OUTFILE
                        filename to save output, stdout if omitted
  -s, --simplified      convert to simplified characters
  -v, --version         show program's version number and exit

Example

Conversion from stdin

$ ./hanzi-convert.py -
Press Crtl-D when finished
Typing away
Now write some chinese characters
繁简转换器

Typing away
Now write some chinese characters
繁簡轉換器

$

Python API

This module requires Python 2.7+ (should work for Python 2.6 but was not tested). See https://pythonhosted.org/hanziconv/ for full documentation.

String Conversion

>>> from hanziconv import HanziConv
>>> print(HanziConv.toSimplified('繁簡轉換器'))
繁简转换器
>>> print(HanziConv.toTraditional('繁简转换器'))
繁簡轉換器
>>> print(HanziConv.toSimplified(u'繁簡轉換器'))
繁简转换器
>>> print(HanziConv.toTraditional(u'繁简转换器'))
繁簡轉換器
>>> print(HanziConv.toSimplified(u'mix English and Chinese. 繁簡轉換器')
mix English and Chinese. 繁简转换器
>>> print(HanziConv.toTraditional(u'mix English and Chinese. 繁简转换器'))
mix English and Chinese. 繁簡轉換器
>>> print(HanziConv.toSimplified('mix English and Chinese. 繁簡轉換器'))
mix English and Chinese. 繁简转换器
>>> print(HanziConv.toTraditional('mix English and Chinese. 繁简转换器'))
mix English and Chinese. 繁簡轉換器

Comparing String

>>> from hanziconv import HanziConv
>>> u'繁簡轉換器' ==  u'繁简转换器'
False
>>> HanziConv.same(u'繁簡轉換器', u'繁简转换器')
True
>>> str1 = 'mix English and Chinese. 繁簡轉換器'
>>> str2 = 'mix English and Chinese. 繁简转换器'
>>> str3 = 'mix Chinese and English. 繁简转换器'
>>> str4 = u'mix English and Chinese. 繁簡轉換器'
>>> HanziConv.same(str1, str2)
True
>>> HanziConv.same(str2, str3)
False
>>> HanziConv.same(str1, str4)
True

Testing

You can either run the standalone runtests.py or standard python setup.py test

$ tar zxf hanziconv-0.2.2.tar.gz
$ cd hanziconv-0.2.2
$ python setup.py test

License

This module is distributed under Apache License Version 2.0.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hanziconv-0.2.2.tar.gz (193.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page