gocept.country 3.0

简介

gocept.country为pycountry数据库提供了Zope 3源。您可以使用它，例如，获取包含所有ISO 3166国家的zope.schema.Choice字段。

>>> import gocept.country
>>> import gocept.country.db
>>> import zope.schema

ISO 3166国家

要获取一个网页表单中ISO 3166国家的列表，您可以使用zope.schema.Choice字段，并使用gocept.country.countries作为源

>>> countries_field = zope.schema.Choice(title=u'Country',
...                            source=gocept.country.countries)
>>> countries_field
<zope.schema._field.Choice object at 0x...>
>>> countries = iter(countries_field.source)

gocept.country.countries源工厂返回国家对象作为值，这些对象使用pycountry的值

>>> aruba = next(countries)
>>> afghanistan = next(countries)
>>> afghanistan
<gocept.country.db.Country object at 0x...>
>>> print(afghanistan.name)
Afghanistan

再次调用next()将返回源中的下一个国家

>>> angola = next(countries)
>>> print(angola.name)
Angola

所有信息均可用，您可以从pycountry获取这些信息

>>> print(afghanistan.alpha_2)
AF
>>> print(afghanistan.alpha_3)
AFG
>>> print(afghanistan.numeric)
004
>>> print(afghanistan.official_name)
Islamic Republic of Afghanistan

为了减少结果的数量，您可以提供一个您希望包含在源中的国家列表或元组

>>> countries = gocept.country.CountrySource(alpha_2=['DE', 'US'])
>>> print(*[countries.factory.getTitle(x) for x in countries], sep=', ')
Germany, United States
>>> print(*[countries.factory.getToken(x) for x in countries], sep=', ')
DE, US

请注意，结果项按alpha_2代码排序。请注意，您还可以提供alpha_3和数字代码以及相应名称来进一步减少结果项的数量

>>> len(list(gocept.country.CountrySource())) > 200
True
>>> len(list(gocept.country.CountrySource(alpha_2=['DE', 'US', 'GB'])))
3
>>> len(list(gocept.country.CountrySource(alpha_3=['DEU', 'USA'])))
2
>>> len(list(gocept.country.CountrySource(numeric=['276', ])))
1
>>> countries_list = ['Germany', 'Italy', 'Poland', 'France']
>>> len(list(gocept.country.CountrySource(name=countries_list)))
4

提供不存在的代码不会引发异常，但会返回一个空列表

>>> len(list(gocept.country.CountrySource(capital=['Berlin', 'Paris'])))
0

ISO 3166-2国家子划分

ISO 15924脚本

脚本类似于国家

>>> scripts_field = zope.schema.Choice(title=u'Script',
...                            source=gocept.country.scripts)
>>> scripts = iter(scripts_field.source)

>>> adlam = next(scripts)
>>> print(adlam.name)
Adlam

>>> afaka = next(scripts)
>>> print(afaka.name)
Afaka
>>> print(gocept.country.scripts.factory.getToken(afaka))
Afak

请注意，结果项按alpha_4代码排序。请注意，您还可以提供名称和数字代码来减少结果项的数量

>>> len(list(gocept.country.ScriptSource())) > 130
True
>>> len(list(gocept.country.ScriptSource(alpha_4=['Arab', 'Latn'])))
2
>>> len(list(gocept.country.ScriptSource(numeric=['215', ])))
1
>>> len(list(gocept.country.ScriptSource(name=['Arabic', 'Latin'])))
2

ISO 4217货币

货币与之前类似

>>> currencies_field = zope.schema.Choice(title=u'Currency',
...                            source=gocept.country.currencies)

>>> currencies = iter(currencies_field.source)

>>> dirham = next(currencies)
>>> print(dirham.name)
UAE Dirham

>>> afghani = next(currencies)
>>> print(afghani.name)
Afghani
>>> print(gocept.country.currencies.factory.getToken(afghani))
AFN

请注意，结果项按alpha_3代码排序。请注意，您还可以提供名称和数字代码来减少结果项的数量

>>> len(list(gocept.country.CurrencySource())) >= 170
True
>>> len(list(gocept.country.CurrencySource(alpha_3=['ARS', 'AED', 'AFN'])))
3
>>> len(list(gocept.country.CurrencySource(numeric=['032', '784'])))
2
>>> len(list(gocept.country.CurrencySource(name=['Afghani', ])))
1

ISO 639语言

语言也与之前类似

>>> languages_field = zope.schema.Choice(title=u'Language',
...                            source=gocept.country.languages)

>>> languages = iter(languages_field.source)

>>> ghotuo = next(languages)
>>> print(ghotuo.name)
Ghotuo

>>> alumu_tesu = next(languages)
>>> print(alumu_tesu.name)
Alumu-Tesu
>>> print(gocept.country.languages.factory.getToken(alumu_tesu))
aab

请注意，结果项按alpha_3排序。请注意，您还可以提供名称来减少结果项的数量

>>> len(list(gocept.country.LanguageSource())) > 480
True
>>> len(list(gocept.country.LanguageSource(alpha_3=['eng', 'deu'])))
2
>>> len(list(gocept.country.LanguageSource(name=['English', 'German'])))
2

翻译

首先，我们获取一个特定的国家

>>> countries = list(iter(countries_field.source))
>>> germany = [x for x in countries if x.name == u'Germany'][0]

i18n翻译方法将“德国”翻译成德语

>>> print(zope.i18n.translate(germany.name, target_language='de'))
Deutschland

脚本、货币和语言的翻译也存在。

比较

国家、脚本、货币和语言可以进行相等性比较。为了测试这一点，我们需要另一个国家对象 afghanistan，它不是之前获取的同一个对象

>>> afghanistan = next(iter(gocept.country.CountrySource(alpha_2=['AF'])))
>>> afghanistan2 = next(iter(gocept.country.CountrySource(alpha_2=['AF'])))

>>> str(afghanistan) == str(afghanistan2)
False

比较它们将获取每个对象的令牌并进行比较

>>> afghanistan == afghanistan2
True
>>> afghanistan != afghanistan2
False
>>> afghanistan != germany
True
>>> afghanistan == germany
False

与另一个类的实例比较总是返回 False

>>> afghanistan == None
False
>>> afghanistan != None
True
>>> afghanistan == object()
False
>>> afghanistan != object()
True

序列化和反序列化

应该在数据库中存储“代理对象”（如 ZODB）。因此，它们必须是可 picklable 的

>>> from io import BytesIO
>>> import pickle
>>> f = BytesIO(b'')

country 对象的 picklable 从不引发错误...

>>> pickle.dump(afghanistan, f)

…并将令牌存储在 pickle 中

>>> ignored = f.seek(0)
>>> b'AF' in f.read()
True

再次读取 pickle 将返回之前 picklable 的相同国家

>>> ignored = f.seek(0)
>>> afghanistan2 = pickle.load(f)
>>> afghanistan2 == afghanistan
True
>>> print(afghanistan2.name)
Afghanistan

变更

贡献者

• Michael Howitz <mh at gocept dot com>