Countries.jl

For handling the countries on Earth.
Author cjdoris
Popularity
0 Stars
Updated Last
1 Year Ago
Started In
June 2020

Countries.jl

Stable Build Status codecov

Julia package for handling the countries on Earth. Useful for example to decode countries encoded differently in different data sets.

It is based on the data here, which is downloaded the first time you load this package.

Install

] add https://github.com/cjdoris/Countries.jl.git

Documentation

This module exports one type, Country. The following are all ways to construct the UK:

# ISO3166 codes (numeric, strings or symbols)
Country(826)
Country("GB")
Country(:GB)
Country("GBR")
Country(:GBR)

# Official name, UN name (any case, any language) or CLDR display name
Country("UK")
Country("United Kingdom of Great Britain and Northern Ireland")
Country("EL REINO UNIDO DE GRAN BRETAÑA E IRLANDA DEL NORTE")

# When all else fails, if there is an unambiguous match, returns this and emits a warning
Country("United Kingdom")
Country("Great Britain")
Country("Britain")
Country("Reino Unido")
Country("Grande-Bretagne")

We can retrieve information about a country c via property access:

c = Country(:GBR)
c.iso3166_numeric       # 826
c.iso3166_alpha2        # :GB
c.iso3166_alpha3        # :GBR
c.cldr_name_en          # "UK"
c.official_name_en      # "United Kingdom of Great Britain and Northern Ireland"
c.unterm_formal_name_ar # "المملكة المتحدة لبريطانيا العظمى وآيرلندا الشمالية"
c.tld_name              # ".uk"
c.continent_code        # :EU
c.capital_name_en       # "London"

Alternatively there are functions of the same name. The argument can be anything convertible to a country. The return type can be specified:

c = Country(:GBR)
Countries.continent_code(c)            # :EU
Countries.continent_code(Symbol, c)    # :EU
Countries.continent_code(String, c)    # "EU"
Countries.continent_code(String, :GBR) # "EU"

Required Packages

Used By Packages

No packages found.