============================================================
python-iso3166 - Standalone 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.

Installation

::

$ pip install iso3166

Usage

Country details

::

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')

Country lists and indexes

::

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'),
...

Changes

2.1.1 - July 11, 2022

Move install metadata from setup.py to setup.cfg
Add py.typed to source distribution

2.1.0 - July 11, 2022

Updated entries
- "Turkey" changed to "Türkiye"

2.0.2 - Sep 20, 2021

Add the py.typed marker file in accordance with PEP 561

2.0.1 - Sep 14, 2021

Add python_requires to setup.py

2.0.0 - Sep 14, 2021

Add type hints throughout codebase (thanks blokje!)
Drop support for Python versions prior to 3.6

1.0.1 - Dec 13, 2019

Include test files in source distribution (thanks pmosetc!)
Added all Python 3 versions to tox.ini and supported list

1.0 - March 19, 2018

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!)

0.9 - July 21, 2018

Updated entries
- New entry for Kosovo (XK / XKX)
- Swaziland changed to Eswatini (effective 2018-07-16)

0.8 - February 5, 2017

Updated entries
- Czechia (changed 2016-09)
- United Kingdom of Great Britain and Northern Ireland (changed
  2014-12)

0.7 - February 13, 2015

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
- Holy See (changed in 2014-12)
CountryLookup now raises KeyError when passed an unknown integer
rather than AttributeError. (thanks unsignedint!)

0.6 - September 28, 2014

Updated entries
- Cabo Verde (changed in 2013-11)
Documented the dictionaries used for looking up countries by alpha2,
etc. (thanks brunetton!)

0.5 - February 13, 2014

Added __contains__ to CountryLookup (thanks tomako!)
Current through ISO newsletter VI-16
- No changes needed

0.4 - February 14, 2013

Current through ISO newsletter VI-14
Updated entries
- Palestine

0.3 - September 4, 2012

Current through ISO newsletter VI-13
Fix changes from 0.2 (thanks vincentfretin!):
- Venezuela
- Saint Helena
- Bolivia

0.2 - March 26, 2012

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:
- Netherlands Antilles (VI-8)

0.1 - December 14, 2010

Initial release

Package profile

iso3166

Releases

Release table

PyPI Downloads

Dependencies

Details

Project URLs

Dependencies

Package description