gem install chinese_pinyin

gem 'chinese_pinyin'

$ ch2py -h
Usage: ch2py [opts]
    -c, --camelcase                  Camelcase of each word
    -i, --stdin                      Read from stdard input
    -t, --tone                       Show tone at end of word
    -m, --tonemarks                  Show tone at top of letter, this
would cover -t option
    -s, --splitter <splitter>        Splitter of each word, use a space
by default
    -v, --version                    Show version
    -h, --help                       Show this help

$ ch2py 中文
zhong wen

require 'chinese_pinyin'

Pinyin.t('**')  => "zhong guo"
Pinyin.t('你好world') => "ni hao world"
Pinyin.t('**', splitter: '-') => "zhong-guo"
Pinyin.t('**', splitter: '') => "zhongguo"
Pinyin.t('**', tone: true) => "zhong1 guo2"
Pinyin.t('**', tonemarks: true) => "zhōng guó"
Pinyin.t('北京') { |letters| letters[0].upcase } => 'BJ'
Pinyin.t('北京') { |letters, i| letters[0].upcase if i == 0 } => 'B'

Pinyin.t('广州') => "yan zhou"

广州|guang3 zhou1

ENV['WORDS_FILE'] = "Words.dat path"
Pinyin.t('广州') => "guang zhou"