pycountry-nopytest 0.16.dev0

构建状态

pycountry

国家（ISO 3166）

国家可以通过在导入pycountry时已配置的数据库对象访问

>>> import pycountry
>>> len(pycountry.countries)
249
>>> list(pycountry.countries)[0]
<pycountry.db.Country object at 0x...>

可以通过各种代码查找特定国家，并作为属性提供标准中包含的信息

>>> germany = pycountry.countries.get(alpha2='DE')
>>> germany
<pycountry.db.Country object at 0x...>
>>> germany.alpha2
u'DE'
>>> germany.alpha3
u'DEU'
>>> germany.numeric
u'276'
>>> germany.name
u'Germany'
>>> germany.official_name
u'Federal Republic of Germany'

注意，ISO 3166-3子标准定义的历史国家不包括在这个列表中。

国家地区划分（ISO 3166-2）

国家地区划分比国家本身更复杂，因为它们提供了一个嵌套和类型化的结构。

可以直接访问所有地区划分

>>> len(pycountry.subdivisions)
4847
>>> list(pycountry.subdivisions)[0]
<pycountry.db.Subdivision object at 0x...>

可以使用唯一代码访问地区划分，并至少提供其代码、名称和类型

>>> de_st= pycountry.subdivisions.get(code='DE-ST')
>>> de_st.code
u'DE-ST'
>>> de_st.name
u'Sachsen-Anhalt'
>>> de_st.type
u'State'
>>> de_st.country
<pycountry.db.Country object at 0x...>

一些地区划分指定另一个地区划分为父级

>>> al_br = pycountry.subdivisions.get(code='AL-BU')
>>> al_br.code
u'AL-BU'
>>> al_br.name
u'Bulqiz\xeb'
>>> al_br.type
u'District'
>>> al_br.parent_code
u'AL-09'
>>> al_br.parent
<pycountry.db.Subdivision object at 0x...>
>>> al_br.parent.name
u'Dib\xebr'

可以使用country_code索引查询单一国家的地区划分

>>> len(pycountry.subdivisions.get(country_code='DE'))
16

>>> len(pycountry.subdivisions.get(country_code='US'))
57

脚本（ISO 15924）

脚本可以从与国家类似的数据库中获取

>>> len(pycountry.scripts)
163
>>> list(pycountry.scripts)[0]
<pycountry.db.Script object at 0x...>

>>> latin = pycountry.scripts.get(name='Latin')
>>> latin
<pycountry.db.Script object at 0x...>
>>> latin.alpha4
u'Latn'
>>> latin.name
u'Latin'
>>> latin.numeric
u'215'

货币（ISO 4217）

货币数据库与之前类似

>>> len(pycountry.currencies)
182
>>> list(pycountry.currencies)[0]
<pycountry.db.Currency object at 0x...>

>>> argentine_peso = pycountry.currencies.get(letter='ARS')
>>> argentine_peso
<pycountry.db.Currency object at 0x...>
>>> argentine_peso.letter
u'ARS'
>>> argentine_peso.name
u'Argentine Peso'
>>> argentine_peso.numeric
u'032'

语言（ISO 639）

语言数据库也类似

>>> len(pycountry.languages)
487
>>> list(pycountry.languages)[0]
<pycountry.db.Language object at 0x...>

>>> aragonese = pycountry.languages.get(alpha2='an')
>>> aragonese.alpha2
u'an'
>>> aragonese.bibliographic
u'arg'
>>> aragonese.terminology
u'arg'
>>> aragonese.name
u'Aragonese'

>>> bengali = pycountry.languages.get(alpha2='bn')
>>> bengali.name
u'Bengali'
>>> bengali.common_name
u'Bangla'

区域设置

区域设置位于该软件包的pycountry.LOCALES_DIR子目录中。翻译域根据它们提供的翻译标准命名为isoXXX。目录结构与Python的gettext模块兼容。

这里是一个翻译语言名称的示例

>>> import gettext
>>> german = gettext.translation('iso3166', pycountry.LOCALES_DIR,
...                              languages=['de'])
>>> german.install()
>>> _('Germany')
'Deutschland'

变更