Python bindings for REST Countries API
Project description
python-countries
Wraps REST Countries
Installation
From Build:
$ pip install python-countries
From Source:
$ git clone https://github.com/leonkozlowski/python-countries.git
$ cd python-countries
$ pip install -e .
Usage
Create the client
>>> client = CountriesApi()
Show available endpoints
>>> client.endpoints()
>>> ['country_name', 'full_name', 'iso_code', 'currency', 'language', 'capital_city', 'calling_code', 'region']
Request for country data by full name
>>> client.full_name('Colombia')
Response for full_name
endpoint
{
"name": "Colombia",
"topLevelDomain": [".co"],
"alpha2Code": "CO",
"alpha3Code": "COL",
"callingCodes": ["57"],
"capital": "Bogotá",
"altSpellings": ["CO", "Republic of Colombia", "República de Colombia"],
"region": "Americas",
"subregion": "South America",
"population": 48759958,
"latlng": [4.0, -72.0],
"demonym": "Colombian",
"area": 1141748.0,
"gini": 55.9,
"timezones": ["UTC-05:00"],
"borders": ["BRA", "ECU", "PAN", "PER", "VEN"],
"nativeName": "Colombia",
"numericCode": "170",
"currencies": [{
"code": "COP",
"name": "Colombian peso",
"symbol": "$"
}],
"languages": [{
"iso639_1": "es",
"iso639_2": "spa",
"name": "Spanish",
"nativeName": "Español"
}],
"translations": {
"de": "Kolumbien",
"es": "Colombia",
"fr": "Colombie",
"ja": "コロンビア",
"it": "Colombia",
"br": "Colômbia",
"pt": "Colômbia"
},
"flag": "https://restcountries.eu/data/col.svg",
"regionalBlocs": [{
"acronym": "PA",
"name": "Pacific Alliance",
"otherAcronyms": [],
"otherNames": ["Alianza del Pacífico"]
}, {
"acronym": "USAN",
"name": "Union of South American Nations",
"otherAcronyms": ["UNASUR", "UNASUL", "UZAN"],
"otherNames": ["Unión de Naciones Suramericanas"..."]
}],
"cioc": "COL"
}
CountryResponse
facade for easy attribute access
>>> colombia = client.full_name('Colombia')
>>> colombia.name
>>> "Colombia"
>>> colombia.flag
>>> "https://restcountries.eu/data/col.svg"
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file python-countries-1.0.1.tar.gz
.
File metadata
- Download URL: python-countries-1.0.1.tar.gz
- Upload date:
- Size: 4.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/3.6.2rc1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e65d548662348549d972011c70491b1c727106d6817a087d15564d373d8a1b9d |
|
MD5 | b4cde57a15d9308599222164be436a20 |
|
BLAKE2b-256 | 020b127544f9740dc5bc9293dfc81d981410dc4fe6e712b4589e91abfb0058e5 |
File details
Details for the file python_countries-1.0.1-py3-none-any.whl
.
File metadata
- Download URL: python_countries-1.0.1-py3-none-any.whl
- Upload date:
- Size: 6.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/3.6.2rc1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 25377f119edc6afa1a52e1e0498b47cc726e3b90c83b712b431bc1e78ed04bb4 |
|
MD5 | 4fd28395c7a76fe8b88959357b4bfee7 |
|
BLAKE2b-256 | 4738544082e45037cd2a2ed48448d38cd6c0b6ab52e57175980a241b40be604a |