Countries.jl
Julia package of information about countries, currencies and languages according to these ISO standards:
- ISO 3166-1: Countries.
- ISO 3166-2: Country subdivisions.
- ISO 4217: Currencies.
- ISO 639-3: Languages.
- ISO 15924: Scripts.
The data can be converted to any table type, allowing for easy integration into data science workflows.
The data is obtained from the Julia package
iso_codes_jll
which makes available the data from the Debian package
iso-codes.
Install
pkg> add Countries
Example
julia> using Countries
julia> all_countries()
249-element Vector{Country}:
Country("AW", "ABW", "Aruba", 533, "Aruba", "Aruba", "🇦🇼")
Country("AF", "AFG", "Afghanistan", 4, "Islamic Republic of Afghanistan", "Afghanistan", "🇦🇫")
⋮
Country("ZM", "ZMB", "Zambia", 894, "Republic of Zambia", "Zambia", "🇿🇲")
Country("ZW", "ZWE", "Zimbabwe", 716, "Republic of Zimbabwe", "Zimbabwe", "🇿🇼")
julia> get_language("en")
Language("en", "eng", "English", "I", "L", "English", "English", "eng")
julia> filter(x->startswith(x.alpha4, "La"), all_scripts())
5-element Vector{Script}:
Script("Lana", "Tai Tham (Lanna)", 351)
Script("Laoo", "Lao", 356)
Script("Latf", "Latin (Fraktur variant)", 217)
Script("Latg", "Latin (Gaelic variant)", 216)
Script("Latn", "Latin", 215)
julia> using DataFrames
julia> DataFrame(all_currencies())
181×3 DataFrame
Row │ alpha3 name numeric
│ String String Int16
─────┼────────────────────────────────────────────────────
1 │ AED UAE Dirham 784
2 │ AFN Afghani 971
⋮ │ ⋮ ⋮ ⋮
180 │ ZMW Zambian Kwacha 967
181 │ ZWL Zimbabwe Dollar 932
julia> my_data = DataFrame(Country=["NGA", "CA", "KOR", "NZ"], Widgets=[400, 12000, 100, 3000])
4×2 DataFrame
Row │ Country Widgets
│ String Int64
─────┼──────────────────
1 │ NGA 400
2 │ CA 12000
3 │ KOR 100
4 │ NZ 3000
julia> my_data.Country_Name = [x.name for x in get_country.(my_data.Country)];
julia> my_data
4×3 DataFrame
Row │ Country Widgets Country_Name
│ String Int64 String
─────┼──────────────────────────────────────
1 │ NGA 400 Nigeria
2 │ CA 12000 Canada
3 │ KOR 100 Korea, Republic of
4 │ NZ 3000 New Zealand
Exported API
For each supported ISO standard, this package exports:
- a type (e.g.
Country) to hold information about an instance from the standard; - a function (e.g.
all_countries) returning a list of all instances; and - a lookup function (e.g.
get_country) to get an instance from any of its codes.
Information about an instance can be obtained through its fields. All fields are strings,
except numeric which is an integer. Optional fields may also be nothing.
The lists also satisfy the
Tables.jl
interface, so can be converted to your favourite table type.
| Standard | API | Fields |
|---|---|---|
| ISO 3166-1: Countries | Country, all_countries, get_country |
alpha2, alpha3, name, numeric, official_name, common_name, flag (optional) |
| ISO 3166-2: Country Subdivisions | CountrySubdivision, all_country_subdivisions, get_country_subdivision |
code, name, type, parent (optional) |
| ISO 4217: Currencies | Currency, all_currencies, get_currency |
alpha3, name, numeric |
| ISO 639-3: Languages | Language, all_languages, get_language |
alpha2 (optional), alpha3, name, scope, type, common_name, inverted_name, bibliographic |
| ISO 15924: Scripts | Script, all_scripts, get_script |
alpha4, name, numeric |