>>> from xpinyin import Pinyin

>>> p = Pinyin()

>>> # default splitter is `-`

>>> p.get_pinyin(u"上海")

'shang-hai'

>>> # show tone marks

>>> p.get_pinyin(u"上海", show_tone_marks=True)

'shàng-hǎi'

>>> # remove splitter

>>> p.get_pinyin(u"上海", '')

'shanghai'

>>> # set splitter as whitespace

>>> p.get_pinyin(u"上海", ' ')

'shang hai'

>>> p.get_initial(u"上")

'S'

>>> p.get_initials(u"上海")

'S-H'

>>> p.get_initials(u"上海", u'')

'SH'

>>> p.get_initials(u"上海", u' ')

'S H'