NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1758 most downloaded on PyPI
Self-contained ISO 3166-1 country definitions.
Last release 1 months ago
03 Sep 2026
Release timing varies
gaps range from 5 months to 4.1 years
Nearly every release is documented
notes for 16 of 16 stable releases
1 version withdrawn
withdrawn after publishing
16 years old
17 releases · first in 2010
Update test matrix for current versions of Python 3
Migrate build system to uv
Update test matrix for current versions of Python 3
Updated entries
Move install metadata from setup.py to setup.cfg
setup.py to setup.cfgOne column per quarter.
* Updated entries - "Turkey" changed to "Türkiye"
Updated entries
Add the py.typed marker file in accordance with PEP 561
py.typed marker file in accordance with PEP 561Add python_requires to setup.py
python_requires to setup.pyAdd type hints throughout codebase (thanks blokje!)
Add type hints throughout codebase (thanks blokje!)
Drop support for Python versions prior to 3.6
Include test files in source distribution (thanks pmosetc!)
Include test files in source distribution (thanks pmosetc!)
Added all Python 3 versions to tox.ini and supported list
"Macedonia, the former Yugoslav Republic of" changed to "North Macedonia" (effective 2019-03-13)
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!)
New entry for Kosovo (XK / XKX)
Updated entries
New entry for Kosovo (XK / XKX)
Swaziland changed to Eswatini (effective 2018-07-16)
United Kingdom of Great Britain and Northern Ireland (changed 2014-12)
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.
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!)
Cabo Verde (changed in 2013-11)
Updated entries
Documented the dictionaries used for looking up countries by alpha2, etc. (thanks brunetton!)
Added __contains__ to CountryLookup (thanks tomako!)
Added __contains__ to CountryLookup (thanks tomako!)
Current through ISO newsletter VI-16
Current through ISO newsletter VI-14
Current through ISO newsletter VI-14
Updated entries
Current through ISO newsletter VI-13
Current through ISO newsletter VI-13
Fix changes from 0.2 (thanks vincentfretin!):
Venezuela
Saint Helena
Bolivia
Current through ISO newsletter VI-12
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:
* Initial release
Your coding agent can read these notes before it upgrades. Set up the MCP server →