Self-contained ISO 3166-1 country definitions.
:Authors: Mike Spindel :Version: 2.1.1
ISO 3166-1 defines two-letter, three-letter, and three-digit country
codes. python-iso3166
is a self-contained module that converts
between these codes and the corresponding country name.
::
$ pip install iso3166
::
from iso3166 import countries
countries.get('us') Country(name='United States', alpha2='US', alpha3='USA', numeric='840') countries.get('ala') Country(name='Åland Islands', alpha2='AX', alpha3='ALA', numeric='248') countries.get(8) Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008')
::
from iso3166 import countries
for c in countries: print(c) Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004') Country(name='Åland Islands', alpha2='AX', alpha3='ALA', numeric='248') Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008') Country(name='Algeria', alpha2='DZ', alpha3='DZA', numeric='012')
::
import iso3166
iso3166.countries_by_name {'AFGHANISTAN': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004'), 'ALBANIA': Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008'), 'ALGERIA': Country(name='Algeria', alpha2='DZ', alpha3='DZA', numeric='012'), ...
iso3166.countries_by_numeric {'004': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004'), '008': Country(name='Albania', alpha2='AL', alpha3='ALB', numeric='008'), '010': Country(name='Antarctica', alpha2='AQ', alpha3='ATA', numeric='010'), ...
iso3166.countries_by_alpha2 {'AD': Country(name='Andorra', alpha2='AD', alpha3='AND', numeric='020'), 'AE': Country(name='United Arab Emirates', alpha2='AE', alpha3='ARE', numeric='784'), 'AF': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004'), ...
iso3166.countries_by_alpha3 {'ABW': Country(name='Aruba', alpha2='AW', alpha3='ABW', numeric='533'), 'AFG': Country(name='Afghanistan', alpha2='AF', alpha3='AFG', numeric='004'), 'AGO': Country(name='Angola', alpha2='AO', alpha3='AGO', numeric='024'), ...
setup.py
to setup.cfg
Updated entries
py.typed
marker file in accordance with PEP 561python_requires
to setup.py
Add type hints throughout codebase (thanks blokje!)
Drop support for Python versions prior to 3.6
Include test files in source distribution (thanks pmosetc!)
Added all Python 3 versions to tox.ini and supported list
Updated entries
"Macedonia, the former Yugoslav Republic of" changed to "North Macedonia" (effective 2019-03-13)
Added numeric code 983 for Kosovo to mirror usage by the National Statistical Office of Canada (thanks betaboon!)
Updated entries
New entry for Kosovo (XK / XKX)
Swaziland changed to Eswatini (effective 2018-07-16)
Updated entries
Czechia (changed 2016-09)
United Kingdom of Great Britain and Northern Ireland (changed 2014-12)
Added new attribute apolitical_name
to Country. This field
reflects the ISO short name but has unnecessarily inflammatory
modifiers removed.
Specifically: "Taiwan, Province of China" maps to "Taiwan" and "Palestine, State of" maps to "Palestine."
Updated entries
CountryLookup now raises KeyError when passed an unknown integer rather than AttributeError. (thanks unsignedint!)
Updated entries
Documented the dictionaries used for looking up countries by alpha2, etc. (thanks brunetton!)
Added __contains__
to CountryLookup (thanks tomako!)
Current through ISO newsletter VI-16
Current through ISO newsletter VI-14
Updated entries
Current through ISO newsletter VI-13
Fix changes from 0.2 (thanks vincentfretin!):
Venezuela
Saint Helena
Bolivia
Current through ISO newsletter VI-12
Added missing entry for Afghanistan
Updated entries
Bolivia (ISO Newsletter VI-6)
Libya (VI-11)
Saint Helena (VI-7)
Sudan (VI-10)
Venezuela (VI-5)
New entries:
Bonaire, Sint Eustatius and Saba (VI-8)
Curaçao (VI-8)
Sint Maarten (Dutch part) (VI-8)
South Sudan (VI-10)
Deleted entries: