country_list

What it is and what it does

country_list is a lightweight reference package that bundles ISO 3166-1 country codes alongside country names translated into multiple languages. It exposes a simple API to query countries by language code, returning code-name pairs, and to reverse-lookup country codes from names. The package has no runtime dependencies and supports Python 3.8 through 3.12.

Typical use is in web forms, data validation, or internationalization workflows where you need to populate dropdowns or validate user input against a canonical list of countries. The data comes from umpirsky/country-list and is packaged as a pure Python wheel, making it quick to install and integrate.

Use it for:

• Populate country dropdown menus in web forms with localized country names for different user languages.
• Validate user-entered country names or codes against the ISO 3166-1 standard during data import or form submission.
• Build a reverse lookup table to convert country names (in any supported language) back to ISO codes for storage or API calls.
• Generate multilingual country reference data for documentation, reports, or configuration files.
• Support internationalization by serving country lists in the user's preferred language without maintaining separate data files.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides ISO 3166-1 country codes and names in multiple languages, queryable by language or country code.

Yes. The package is lightweight, has zero dependencies, is actively maintained, carries a permissive MIT license, and solves a common reference-data problem. Install it if you need ISO 3166-1 country codes and names in multiple languages; skip it only if you already have country data embedded elsewhere or need real-time updates beyond what a static package provides.

Install

country-list on PyPI

pip install country-list

uv add country-list

poetry add country-list

Installing country_list

Before you install

Low install friction with no runtime dependencies. Actively maintained with recent commits; last release was 1013 days ago but repo shows activity through 2026-08-07.

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions—suitable for commercial and open-source projects.

Quickstart

pip install country_list

from country_list import countries_for_language
countries = dict(countries_for_language('en'))
print(countries['GB'])  # 'United Kingdom'

Verify before relying

• Whether all language codes and country names are current with ISO 3166-1 standard updates
• Performance characteristics when working with the full dataset across all supported languages

Package facts

Evidence: country_list-1.1.0-py3-none-any.whl

Tags

More Utilities packages