NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #2949 most downloaded on PyPI
The country converter (coco) - a Python package for converting country names between different classifications schemes
Last release 11 months ago
22 Oct 2025
Ships fairly regularly
a new release about every 4 months
Most releases are documented
notes for 29 of 34 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
35 releases · first in 2017
added Council of Europe classification
switch to uv based development environment
One column per quarter.
added BACI - BACI: International Trade Database at the Product-Level (by @mabudz)
added IOC classification (by @Azrael3000)
fixed numerical position warning
Nothing published for this version
So going forward we will be conservative in changing existing functionality, avoiding breaking changes as much as possible.
We finally jump to version 1.0! Overall, it is only a minor update, including the move to github.com/IndEcol. However, the functionality seems quite stable and the country converter is heavily used in production. So going forward we will be conservative in changing existing functionality, avoiding breaking changes as much as possible.
added Costa Rica as new OECD member (2021), fix #118
ISO2 did return the regex for GB|UK - fix #113
additional data must specify ISO2 (necessary for regex matching in ISO2)
Full Changelog: https://github.com/konstantinstadler/country_converter/compare/v0.7.5...v0.7.6
Classifications ^^^^^^^^^^^^^^^^
Classifications ^^^^^^^^^^^^^^^^
Bug Fixes ^^^^^^^^^
Development ^^^^^^^^^^^^^^^^
Full Changelog: https://github.com/konstantinstadler/country_converter/compare/v0.7.4...v0.7.5
IEA classification added by @Kajwan in https://github.com/konstantinstadler/country_converter/pull/97
Full Changelog: https://github.com/konstantinstadler/country_converter/blob/master/CHANGELOG.rst
added GBDcode (numerical Global Burden of Disease codes)
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming ver
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming ver
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming ver
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.
Deprecated pandas methods (ix, read_table) replaced
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.
Coco now includes as switch for including obsolete countries (off by default), see https://github.com/konstantinstadler/country_converter#classification-schemes
Further improved test coverage
Improved test coverage Changed ISO3 for Kosovo from KSV to XKV
Switched ROW in WIOD to RoW
Switched WIOD country names to upper case to fit the WIOD database case
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming ver
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.
0.6.6 - 20180729
Added Cecilia2050 classification (merging pull request #36 from @bixiou with some futher modifications)
Changing Swaziland to Eswatini, following the official name change in April 2018 (https://unterm.un.org/UNTERM/Display/Record/UNHQ/NA/01b637e1-1497-4825-b73d-e0114a7f4d22 …). Closes issue #35
Removed space from McDonald in "Heard and Mc Donald Islands" and updated offical name to "Territory of Heard Island and McDonald Islands". Closes issus #34.
0.6.5 - 20180309
Coco now includes as switch for including obsolete countries (off by default), see https://github.com/konstantinstadler/country_converter#classification-schemes
Further improved test coverage
0.6.4 - 20180308
Improved test coverage Changed ISO3 for Kosovo from KSV to XKV
0.6.3 - 20180105
Switched ROW in WIOD to RoW
Pymrio is an open source tool for analysing global environmentally extended multi-regional input-output tables (EE MRIOs). Pymrio aims to provide a hi
Pymrio is an open source tool for analysing global environmentally extended multi-regional input-output tables (EE MRIOs). Pymrio aims to provide a high-level abstraction layer for global EE MRIO databases in order to simplify common EE MRIO data tasks. Pymrio includes automatic download functions and parsers for available EE MRIO databases like EXIOBASE_, WIOD_ and EORA26_. It automatically checks parsed EE MRIOs for missing data necessary for calculating standard EE MRIO accounts (such as footprint, territorial, impacts embodied in trade) and calculates all missing tables. Various data report and visualization methods help to explore the dataset by comparing the different accounts across countries.
Pymrio is an open source tool for analysing global environmentally extended multi-regional input-output tables (EE MRIOs). Pymrio aims to provide a high-level abstraction layer for global EE MRIO databases in order to simplify common EE MRIO data tasks. Pymrio includes automatic download functions and parsers for available EE MRIO databases like EXIOBASE_, WIOD_ and EORA26_. It automatically checks parsed EE MRIOs for missing data necessary for calculating standard EE MRIO accounts (such as footprint, territorial, impacts embodied in trade) and calculates all missing tables. Various data report and visualization methods help to explore the dataset by comparing the different accounts across countries.
Coco now includes as switch for including obsolete countries (off by default), see https://github.com/konstantinstadler/country_converter#classification-schemes
Further improved test coverage
Improved test coverage Changed ISO3 for Kosovo from KSV to XKV
Switched ROW in WIOD to RoW
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming ver
Country Converter (Coco)
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.
Improved test coverage Changed ISO3 for Kosovo from KSV to XKV
Switched ROW in WIOD to RoW
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming ver
The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.
Switched ROW in WIOD to RoW
Switched WIOD country names to upper case to fit the WIOD database case
Minor spelling fixes
Aggregation concordance building functionality with
Include Eora(26) country codes
CountryConverter accepts a parameter only_UNmember to restrict the concordances to UN member countries.
Fix and close Issue #28 (Wrong ISO3 code for Palestine) and #25 (Non-standard codes).
Switched WIOD country names to upper case to fit the WIOD database case
Switched WIOD country names to upper case to fit the WIOD database case
Minor spelling fixes
Minor spelling fixes
Aggregation concordance building functionality with
Aggregation concordance building functionality with
- method get_correspondance_dict in CountryConverter
- function agg_conc which build concordance matrices in various formats
- notebook tutorial
Include Eora(26) country codes
CountryConverter accepts a parameter only_UNmember to restrict the concordances to UN member countries.
Fix and close Issue #28 (Wrong ISO3 code for Palestine) and #25 (Non-standard codes).
Corrected Palestine ISO3 code to PSE
Corrected Palestine ISO3 code to PSE
Minor bugfixes with UN codes and regions.
Minor bugfixes with UN codes and regions.
Fixing issue 22 and 23
Changed Futuna and Sahara to Uppercase
Changed Futuna and Sahara to Uppercase
Minor update, added the citation for the JOSS article.
Minor update, added the citation for the JOSS article.
This is the version after the review for publication in The Journal of Open Source Software.
This is the version after the review for publication in The Journal of Open Source Software.
* Renamed XXin methods to XXas. For example coco.EU27in('ISO3') becomese coco.EU27as('ISO3')
* Some updates in README.rst (related software, badges, motivation)
* Added CONTRIBUTING.rst
Account for cases where countries or regions are specified with 'exclude ...'
Extended functionality:
Account for cases where countries or regions are specified with 'exclude ...'
Possibility to add custom countryfile for own mappings
Not found value can be specified also in the CLI version
Automatically detect input format (ISO2, ISO3, ISOnumeric)
Some bugfixes:
Change ISO3 for Romania from ROM to ROU (bugfix)
Change ISO3 for Congo from COD to COG (bugfix)
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →