worldlib – library for country code lookup

To use the worldlib library, import the database which reads a canned, pre-generated set of code mappings:

>>> from worldlib.database import Database
>>> db = Database()

You can look up a country code:

>>> print(db.lookup_code('it'))
ITALY

Country codes are case-insensitive:

>>> print(db.lookup_code('It'))
ITALY

You can find all matches for a particular string, which allows you for example to implement a reverse look up. The matches are returned sorted in alphabetical order. As with code look ups, the match string is case insensitive:

>>> for code, country in db.find_matches('United'):
...     print(code, 'is', country)
ae is UNITED ARAB EMIRATES
gb is UNITED KINGDOM
tz is TANZANIA, UNITED REPUBLIC OF
uk is United Kingdom (common practice)
um is UNITED STATES MINOR OUTLYING ISLANDS
us is UNITED STATES

You can iterate through all the codes:

>>> for code in db:
...     print(code)
ac
...
zw