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 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 names from a source to a given base set is also handled including phonetic fuzzy name matching.

It also provides foreign exchange rates and conversion from amounts in local currency to USD and vice-versa. The conversion relies on Yahoo Finance, falling back on currency-api for current rates, and Yahoo Finance falling back on IMF data via IATI for historic rates.

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

This version

3.6.1

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.6.1.tar.gz (403.6 kB view details)

Uploaded Source

Built Distribution

hdx_python_country-3.6.1-py3-none-any.whl (47.4 kB view details)

Uploaded Python 3

File details

Details for the file hdx_python_country-3.6.1.tar.gz.

File metadata

  • Download URL: hdx_python_country-3.6.1.tar.gz
  • Upload date:
  • Size: 403.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.25.1

File hashes

Hashes for hdx_python_country-3.6.1.tar.gz
Algorithm Hash digest
SHA256 2d88a9e740f73e09b83a498f40799741ce25e0b66652e433b0e30c3a53c9e98b
MD5 0fb7bd9e8aa7cb13048db0129804b1f7
BLAKE2b-256 9899db646ba23c9c186dccbdb9c00cee6c9884ef0fe1d30348f75d130d5b526c

See more details on using hashes here.

File details

Details for the file hdx_python_country-3.6.1-py3-none-any.whl.

File metadata

File hashes

Hashes for hdx_python_country-3.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d1096f9ac62aeb2d4df34e06d1a838e90a091c0a92b5634748f45e3b2e3ea65e
MD5 fe4856a72fec165fd3ebde8317e50cbc
BLAKE2b-256 554aaa6bcf8a81de4af7e271c5230cb0a0ce3baad0a4df7b0fe774b8f4c426dd

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