This is a wrapper for pycountry, to make said library more usable.
Go to file
2024-11-19 14:55:37 +01:00
.vscode added release script 2024-11-19 14:55:37 +01:00
pycountry_wrapper initial commit 2024-11-19 14:51:55 +01:00
.gitignore Initial commit 2024-11-19 13:09:03 +00:00
LICENSE Initial commit 2024-11-19 13:09:03 +00:00
pyproject.toml initial commit 2024-11-19 14:51:55 +01:00
README.md initial commit 2024-11-19 14:51:55 +01:00
release added release script 2024-11-19 14:55:37 +01:00

Pycountry-Wrapper

This is a wrapper for pycountry, to make said library more usable.

Installation

You can install the library by using pip:

pip install pycountry-wrapper

Usage

from pycountry_wrapper import Country, CountryDoesNotExist

germany = Country.from_alpha_2("DE")
print(germany)
print(germany.name)

try:
    does_not_exist = Country.from_alpha_2("EN")
except CountryDoesNotExist:
    # if the country wasn't found, this exception is thrown
    pass

Creating country class

You can call create an instance of pycountry_wrapper.Country in three ways.

Using ISO 3166-1 with either 2 or 3 letters:

from pycountry_wrapper import Country

Country.from_alpha_2("DE")
Country.from_alpha_2("DEU")

Or you can do a fuzzy search in a similar way:

from pycountry_wrapper import Country

Country.from_fuzzy("Deutschland")

Or you can pass a pycountry object in the constructor:

import pycountry
from pycountry_wrapper import Country

Country(pycountry.countries.get(alpha_2="DE"))

Accessing information

There are only a handful (readonly) attributes.

from pycountry_wrapper import Country

country = Country.from_alpha_2("DE")

country.name
country.alpha_2
country.alpha_3
country.official_name