Repository files navigation

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

It provides country mappings including ISO 2 and ISO 3 letter codes (ISO 3166) and regionsusing live official data from theUN OCHA feed withfallbacks to an internal static file if there is any problem with retrieving data fromthe 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 afuzzy matching for English look up that can handle abbreviations in country names likeDem. for Democratic and Rep. for Republic.

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

It also provides foreign exchange rates and conversion from amounts in localcurrency to USD and vice-versa. The conversion relies on Yahoo Finance, fallingback oncurrency-api for current rates, and Yahoo Finance falling backon IMF data via IATI (with interpolation) for historic daily rates.

For more information, please read thedocumentation.

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