a-world-of-countries
Advanced tools
A World of Countries (AWOC) is a fully-featured library that provides an easy layer to access mutiple data about world continents and countries, according to the ISO Standard 3166-1.
A World of Countries (AWOC) is a fully-featured library that provides an easy layer to access mutiple data about world continents and countries, according to the ISO Standard 3166-1.
Note: A NodeJS version of this library is available here
$ pip install a-world-of-countries
# Import the AWOC package.
import awoc
# Initialize the AWOC class.
my_world = awoc.AWOC()
# Let's retrieve the full list of nations of Europe.
countries_of_europe = my_world.get_countries_list_of('Europe')
# It returns: [ 'Albania', 'Andorra', 'Austria', 'Belarus', 'Belgium', and so on... ]
# We can get the whole country data as well.
italy_data = my_world.get_country_data('Italy')
"""
Returns:
{
'Country Name': 'Italy',
ISO2: 'IT',
ISO3: 'ITA',
TLD: 'it',
FIPS: 'IT',
'ISO Numeric': '380',
GeoNameID: '3175395',
E164: '39',
'Phone Code': '39',
'Continent Name': 'Europe',
'Continent Code': 'eu',
Capital: 'Rome',
'Time Zone in Capital': 'Europe/Rome',
'Currency Name': 'Euro',
Languages:
'Italian (official), German (parts of Trentino-Alto Adige region are predominantly German-speaking), French (small French-speaking minority in Valle d\'Aosta region), Slovene (Slovene-speaking minority in the Trieste-Gorizia area)',
'Area KM2': '301230'
}
"""
A World of Countries is a library based upon a world.json file which holds all the continents and countries informations we need. The file is ntly evolving and this library, encoded in the form of a JS class, exposes a list of methods you can use to access those data without the hassle of writing data extraction code.
In the data/world.json (known as Global World Data Object, GWDO) file, every country is encoded as an object /w the following properties:
The whole library code is heavily commented, so every class property or method exposes a verbose explanation of its purpose. Feel free to inspect the code and find you preferred method of work. The following is the updated list of all AWOC available methods.
List of all AWOC.js methods about world continents.
Description: returns a list of continent names as strings.
# Let's fetch a list of all continents of planet Earth.
continents_list = my_world.get_continents_list()
# Returns: ['Africa', 'Antarctica', 'Asia', 'Europe', 'North America', 'Oceania', 'South America']
Description: returns a list of continent objects.
# Let's fetch a list of all continents of planet Earth in form of data objects.
continents_data = my_world.get_continents()
"""
Returns:
[
{ 'Continent Code': 'af', 'Continent Name': 'Africa' },
{ 'Continent Code': 'an', 'Continent Name': 'Antarctica' },
{ 'Continent Code': 'as', 'Continent Name': 'Asia' },
{ 'Continent Code': 'eu', 'Continent Name': 'Europe' },
{ 'Continent Code': 'na', 'Continent Name': 'North America' },
{ 'Continent Code': 'oc', 'Continent Name': 'Oceania' },
{ 'Continent Code': 'sa', 'Continent Name': 'South America' }
]
"""
Description: This method extracts all the countries data from the GWOD. It performs an additional sort by country name to ensure the correct alphabetical order, regardless of the GWOD json objects order (which might fail).
# Let's fetch the data of all countries of the world.
countries = my_world.get_countries()
"""
Returns the full list of country objects.
[...
{ 'Country Name': 'Cocos Islands', ISO2: 'CC', ISO3: 'CCK', TLD: 'cc', .. },
{ 'Country Name': 'Colombia', ISO2: 'CO', ISO3: 'COL', TLD: 'co', ... },
... ]
"""
Description: this method returns a single country object data. If a field parameter is specified, then the method will return its value. For a list of available fields, please check the country data structure above.
# We can fetch a single value from the country data object.
capital_of_spain = my_world.get_country_data('Spain', 'Capital')
# Returns: "Madrid".
# ... or just the full object.
spain_data = my_world.get_country_data('Spain')
# Returns: {'Country Name': 'Spain', ISO2: 'ES', ISO3: 'ESP', TLD: 'es', ... }
Description: this method returns a list of country names sorted alphabetically.
# Let's fetch a list of world nations.
get_countries_list = my_world.get_countries_list()
# Returns: ['Afghanistan', 'Albania', 'Algeria', 'American Samoa', 'Andorra', ...]
Description: this method returns a list of country names sorted alphabetically for a specific continent.
# Let's fetch the list of nations of Europe.
nations_of_europe = my_world.get_countries_list_of('Europe')
# Returns: [ 'Albania', 'Andorra', 'Austria', 'Belarus', 'Belgium', ...]
Description: this method returns a list of country objects alphabetically sorted per each country name for a specific continent.
# Let's fetch the list of nations of Europe in form of country objects.
nations_of_europe = my_world.get_countries_data_of('Europe')
"""
Returns:
[
{ 'Country Name': 'Albania', ISO2: 'AL', ISO3: 'ALB', ... },
{ 'Country Name': 'Andorra', ISO2: 'AD', ISO3: 'AND', ... }
]
"""
Description: this method returns the ISO2 code for the specified country.
italy_ISO2 = my_world.get_country_ISO2('Italy')
# Returns: 'IT'
Description: this method returns the ISO3 code for the specified country.
italy_ISO3 = my_world.get_country_ISO3('Italy')
# Returns: 'ITA'
Description: this method returns the Top Level Domain (TLD) for the specified country.
italy_TLD = my_world.get_country_TLD('Italy')
# Returns: 'it'
Description: this method returns the FIPS country code for the specified country.
italy_FIPS = my_world.get_country_FIPS('Italy')
# Returns: 'IT'
Description: this method returns the ISO Numeric code for the specified country.
italy_ISO_numeric = my_world.get_country_ISO_numeric('Italy')
# Returns: '380'
Description: this method returns the GEO Name ID for the specified country.
italy_GEO_name_ID = my_world.get_country_geo_name_ID('Italy')
# Returns: '3175395'
Description: this method returns the E164 code for the specified country.
italy_E164 = my_world.get_country_E164('Italy')
# Returns: '39'
Description: this method returns the Phone Code for the specified country.
italy_phone_code = my_world.get_country_phone_code('Italy')
# Returns: '39'
Description: this method returns the continent data the specified country belongs to.
italy_continent_name = my_world.get_country_continent_name('Italy')
# Returns: 'Europe'
Description: this method returns the continent code the specified country belongs to.
italy_continent_code = my_world.get_country_continent_code('Italy')
# Returns: 'eu'
Description: this method returns the capital city of the specified country.
capital_of_italy = my_world.get_country_capital_city('Italy')
# Returns: 'Rome'
Description: this method returns a time zone value for the specific country.
italy_time_zone = my_world.get_country_time_zone('Italy')
# Returns: 'Europe/Rome'
Description: this method returns the currency name for the specified country.
italy_currency_name = my_world.get_country_currency_name('Italy')
# Returns: 'Euro'
Description: this method returns a list of country names filtered by a specific currency.
# Let's fetch all the countries where the dollar is used.
dollar_nations = my_world.get_countries_list_by_currency('Dollar')
# Returns: [ 'American Samoa', 'Anguilla', 'Antigua and Barbuda', 'Australia', 'Bahamas', ... ]
# We can also filter the above by continent.
dollar_nations_in_south_america = my_world.get_countries_list_by_currency(
'Dollar',
'South America'
)
# Returns: [ 'Ecuador', 'Guyana', 'Suriname' ]
Description: this method returns one or multiple country object data for a specific currency.
# Let's fetch all the countries where the dollar is used in form of data objects
dollar_nations_obj = my_world.get_countries_data_by_currency('Dollar')
"""
Returns:
[...
{ 'Country Name': 'American Samoa', ISO2: 'AS', ISO3: 'ASM', TLD: 'as', FIPS: 'AQ', ... },
{ 'Country Name': 'Anguilla', ISO2: 'AI', ISO3: 'AIA', TLD: 'ai', FIPS: 'AV', ... },
...]
"""
# We can also filter the above by continent.
dollar_nations_in_south_americaObj = my_world.get_countries_data_by_currency(
'Dollar',
'South America'
)
"""
Returns:
[
{ 'Country Name': 'Ecuador', ISO2: 'EC', ISO3: 'ECU', TLD: 'ec', FIPS: 'EC', ... },
{ 'Country Name': 'Guyana', ISO2: 'GY', ISO3: 'GUY', TLD: 'gy', FIPS: 'GY', ... },
{ 'Country Name': 'Suriname', ISO2: 'SR', ISO3: 'SUR', TLD: 'sr', FIPS: 'NS', ... }
]
"""
Description: this method returns a list of languages for the specific country.
italy_language_codes = my_world.get_country_languages('Italy')
# Returns: 'Italian (official)', 'German (parts of Trentino-Alto Adige region are predominantly German-speaking)', 'French (small French-speaking minority in Valle d\'Aosta region)', 'Slovene (Slovene-speaking minority in the Trieste-Gorizia area)'.
Description: this method returns the country area in km2 or mi2.
# Let's fetch the extension area of Italy in km2
italy_extension_area_km2 = my_world.get_country_area('Italy')
# Returns: 301230
# We can fetch it in mi2 too.
italy_extension_area_mi2 = my_world.get_country_area('Italy', 'mi2')
# Returns: 116305.44
Initial release.
FAQs
A World of Countries (AWOC) is a fully-featured library that provides an easy layer to access mutiple data about world continents and countries, according to the ISO Standard 3166-1.
We found that a-world-of-countries demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.