Metadata-Version: 1.0
Name: correct_pycountry
Version: 0.12.1.1
Summary: A fork for pycountry, correct the country name of Taiwan
Home-page: http://bitbucket.org/victorlin/correct_pycountry
Author: Victor Lin
Author-email: bornstub@gmail.com
License: LGPL 2.1
Description: =========
        pycountry
        =========
        
        pycountry provides the ISO databases for the standards:
        
        639
        Languages
        
        3166
        Countries
        
        3166-2
        Subdivisions of countries
        
        4217
        Currencies
        
        15924
        Scripts
        
        The package includes a copy from Debian's `pkg-isocodes` and makes the data
        accessible through a Python API.
        
        Translation files for the various strings are included as well.
        
        
        Countries (ISO 3166)
        ====================
        
        Countries are accessible through a database object that is already configured
        upon import of pycountry and works as an iterable:
        
        >>> import pycountry
        >>> len(pycountry.countries)
        246
        >>> list(pycountry.countries)[0]
        <pycountry.db.Country object at 0x...>
        
        Specific countries can be looked up by their various codes and provide the
        information included in the standard as attributes:
        
        >>> germany = pycountry.countries.get(alpha2='DE')
        >>> germany
        <pycountry.db.Country object at 0x...>
        >>> germany.alpha2
        'DE'
        >>> germany.alpha3
        'DEU'
        >>> germany.numeric
        '276'
        >>> germany.name
        'Germany'
        >>> germany.official_name
        'Federal Republic of Germany'
        
        Note that historic countries, defined by the ISO 3166-3 sub-standard are not
        included in this list.
        
        Country subdivisions (ISO 3166-2)
        =================================
        
        The country subdivisions are a little more complex than the countries itself
        because they provide a nested and typed structure.
        
        All subdivisons can be accessed directly:
        
        >>> len(pycountry.subdivisions)
        4548
        >>> list(pycountry.subdivisions)[0]
        <pycountry.db.Subdivision object at 0x...>
        
        Subdivisions can be accessed using their unique code and provide at least
        their code, name and type:
        
        >>> de_st= pycountry.subdivisions.get(code='DE-ST')
        >>> de_st.code
        'DE-ST'
        >>> de_st.name
        'Sachsen-Anhalt'
        >>> de_st.type
        'State'
        >>> de_st.country
        <pycountry.db.Country object at 0x...>
        
        Some subdivisions specify another subdivision as a parent:
        
        >>> al_br = pycountry.subdivisions.get(code='AL-BU')
        >>> al_br.code
        'AL-BU'
        >>> al_br.name
        u'Bulqiz\xeb'
        >>> al_br.type
        'District'
        >>> al_br.parent_code
        'AL-09'
        >>> al_br.parent
        <pycountry.db.Subdivision object at 0x...>
        >>> al_br.parent.name
        u'Dib\xebr'
        
        The divisions of a single country can be queried using the country_code index:
        
        >>> len(pycountry.subdivisions.get(country_code='DE'))
        16
        
        >>> len(pycountry.subdivisions.get(country_code='US'))
        57
        
        
        Scripts (ISO 15924)
        ===================
        
        Scripts are available from a database similar to the countries:
        
        >>> len(pycountry.scripts)
        146
        >>> 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
        'Latn'
        >>> latin.name
        'Latin'
        >>> latin.numeric
        '215'
        
        
        Currencies (ISO 4217)
        =====================
        
        The currencies database is, again, similar to the ones before:
        
        >>> 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
        'ARS'
        >>> argentine_peso.name
        'Argentine Peso'
        >>> argentine_peso.numeric
        '032'
        
        
        Languages (ISO 639)
        ===================
        
        The languages database is similar too:
        
        >>> len(pycountry.languages)
        486
        >>> list(pycountry.languages)[0]
        <pycountry.db.Language object at 0x...>
        
        >>> aragonese = pycountry.languages.get(alpha2='an')
        >>> aragonese.alpha2
        'an'
        >>> aragonese.bibliographic
        'arg'
        >>> aragonese.terminology
        'arg'
        >>> aragonese.name
        'Aragonese'
        
        Locales
        =======
        
        Locales are available in the `pycountry.LOCALES_DIR` subdirectory of this
        package. The translation domains are called `isoXXX` according to the standard
        they provide translations for. The directory is structured in a way compatible
        to Python's gettext module.
        
        Here is an example translating language names:
        
        >>> import gettext
        >>> german = gettext.translation('iso3166', pycountry.LOCALES_DIR,
        ...                              languages=['de'])
        >>> german.install()
        >>> _('Germany')
        'Deutschland'
        
        Taiwan country name
        ===================
        
        The official name of Taiwan is `Republic of China`, but however, due to the
        pressure from Chinese government, ISO defines the name of Taiwan as
        `Province of China`, which is not true after all.  Therefore, we replace
        `Province of China` as `Republic of China` in this fork, and it is what this
        fork mainly for.  If you don't agree with this modification, please just don't
        use it.
        
        >>> tw = pycountry.countries.get(alpha2='TW')
        >>> tw.name
        'Taiwan, Republic of China'
        >>> zh_tw = gettext.translation('iso3166', pycountry.LOCALES_DIR,
        ...                             languages=['zh_TW'])
        >>> zh_tw.install(unicode=True)
        >>> _('Taiwan, Republic of China')
        u'\u4e2d\u83ef\u6c11\u570b'
        
        Changes
        =======
        
        0.12.1.1 (2010-10-19)
        ---------------------
        
        - Fix some locales bug
        
        - Add test for Taiwan country name in Readme.txt
        
        - Follow original project to use revision
        770fa9cd603f90f9fb982b32fe6f45d253f1d33e.
        
        0.12.1 (2010-04-21)
        -------------------
        
        - Remedy brown-bag release 0.12 which was missing all data files due to a bad
        interaction between the build system for the data and zest.releaeser's
        full-release script.
        
        
        0.12 (2010-04-20)
        -----------------
        
        - Follow Debian repository to git.
        
        - Upgrade data to revision 770fa9cd603f90f9fb982b32fe6f45d253f1d33e as
        requested by #5488 and others.
        
        - Reflect subdivision changes with how they reference their parents in the XML
        (they used to use space as a separator but now use a hyphen).
        
        - Refactor index building structures a bit.
        
        - Remove superfluous 'code' index from subdivision database. (Together with
        the data upgrade this also gets rid of all the annoying warnings as
        described in #6667).
        
        - Some light PEP 8 improvements.
        
        0.11 (2009-03-03)
        -----------------
        
        - Updated Debian repository to r1752.
        
        
        0.10 (2008-06-26)
        -----------------
        
        - Added support for country subdivisions (ISO 3166-2).
        
        
        0.9
        ---
        
        - Initial release
        
Keywords: country subdivision language currency iso 3166 639 4217 15924 3166-2
Platform: UNKNOWN
