Module operator

source code

Provides ReadingOperators, classes to handle strings written in a character reading.

Examples

Decompose a reading string in Gwoyeu Romatzyh into single entities:

>>> from cjklib.reading import ReadingFactory
>>> f = ReadingFactory()
>>> f.decompose('"Hannshyue" .de mingcheng duey Jonggwo [...]', 'GR')
['"', 'Hann', 'shyue', '" ', '.de', ' ', 'ming', 'cheng', ' ', 'duey',
' ', 'Jong', 'gwo', ' [...]']

The same can be done by directly using the operator's instance:

>>> from cjklib.reading import operator
>>> cy = operator.CantoneseYaleOperator()
>>> cy.decompose('gwóngjàuwá')
[u'gwóng', u'jàu', u'wá']

Composing will reverse the process, using a Pinyin string:

>>> f.compose([u'xī', u'ān'], 'Pinyin')
u"xī'ān"

For more complex operators, see PinyinOperator or MandarinIPAOperator.