Skip to main content

HDX Python country code and exchange rate (fx) utilities

Project description

Build Status Coverage Status Code style: black Imports: isort Downloads

The HDX Python Country Library provides utilities to map between country and region codes and names and to match administrative level one names from different sources. It also provides utilities for foreign exchange enabling obtaining current and historic FX rates for different currencies.

It provides country mappings including ISO 2 and ISO 3 letter codes (ISO 3166) and regions using live official data from the UN OCHA feed with fallbacks to an internal static file if there is any problem with retrieving data from the url. (Also it is possible to force the use of the internal static files.)

It can exact match English, French, Spanish, Russian, Chinese and Arabic. There is a fuzzy matching for English look up that can handle abbreviations in country names like Dem. for Democratic and Rep. for Republic.

Mapping administration level one names from a source to a given base set is also handled including phonetic fuzzy name matching.

It also provides currency conversion to and from USD from local currency.

For more information, please read the documentation.

This library is part of the Humanitarian Data Exchange (HDX) project. If you have humanitarian related data, please upload your datasets to HDX.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hdx-python-country-3.3.3.tar.gz (93.8 kB view details)

Uploaded Source

File details

Details for the file hdx-python-country-3.3.3.tar.gz.

File metadata

  • Download URL: hdx-python-country-3.3.3.tar.gz
  • Upload date:
  • Size: 93.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for hdx-python-country-3.3.3.tar.gz
Algorithm Hash digest
SHA256 905fc00e0e4fd9700a27e4539446fe28f643d7d02adef0a3d9887d30b012e219
MD5 e54e68a5d522c75648a7ad86d1c275b4
BLAKE2b-256 aa7aad07dbc158c42f7e29b78e95ff6c3b40d4a45c1ca78e38a393b0f4a132a7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page