Iridium

The International Standard for country codes and codes for their subdivisions on Nim (ISO-3166).

Usage

>>> import iridium
>>> echo getCountryByCode("CO")
(name: "Colombia", alpha2: "CO", alpha3: "COL", numeric: "170", official: "Republic of Colombia")
>>> echo getSubdivisionByCode("CO-QUI")
(name: "Quindío", category: "Department", parent: "")

Install

nimble install iridium

Requisites

• Nim 1.2.0 or higher.

Documentation

Types

The country data is stored as a CountryDivision object with the following fields:

type
  CountryDivision* = object
    name*: string       ## Country name (short)
    alpha2*: string     ## Two letter alphabetic code of the country
    alpha3*: string     ## Three letter alphabetic code of the country
    numeric*: string    ## Three digit numeric code of the country, including leading zeros
    official*: string   ## Official name of the country (optional)

The country subdivision is stored as a CountrySubdivision object with the following fields:

type
  CountrySubdivision* = object
    name*: string        ## Name of the country subdivision
    category*: string    ## Type of subdivision of the country (i.e. Province, Region, Emirate)
    parent*: string      ## Parent of the country subdivision

Procedures

Each procedure will raise a KeyError if the code does not satisfy certain checks (i.e. code does not exist, invalid numeric code).

ISO-3166-1 Related

• getAllCountries()

Get all the countries data as a Nim Table whose keys are the country alpha2 code and the values as CountryDivision object.

• Arguments: None

• Returns: Table[string, CountryDivision]

• getCountryByCode()

Get the country data by its alpha2 code.

• Arguments:
  • code ISO-3166-1 alpha2 code, required.

• Returns: CountryDivision

• getCountryByName()

Get the country data by its name.

• Arguments:
  • countryName The common name, required.

• Returns: CountryDivision

• getCountryByAlpha3()

Get the country data by its alpha3 code.

• Arguments:
  • alpha3Code ISO-3166-1 alpha3 code, required.

• Returns: CountryDivision

• getCountryByNumeric()

Get the country data by its numeric code.

• Arguments:
  • numericCode ISO-3166-1 numeric code as string or integer, required.
• Returns: CountryDivision

ISO-3166-2 Related

• getAllSubdivisions()

Get all the subdivisions data as a Nim Table whose keys are the subdivision code (country-subdivision) and the values as CountrySubdivision object.

• Arguments: None

• Returns: Table[string, CountrySubdivision]

• getSubdivisionsByCountry()

Get the country subdivisions data by its code as a sequence.

• Arguments:
  • countryCode ISO-3166-1 alpha2 country code as string, required.

• Returns: seq[CountrySubdivision]

• getSubdivisionByCode()

Get the subdivision data by its code.

• Arguments:
  • numericCode ISO-3166-2 code as string, required.
• Returns: CountrySubdivision

ISO-4217 Related

• getAllCurrencies()

Get all the currencies as a Nim table whose keys are the currency alphabetic code and the values as CurrencyCode object.

• Arguments: None

• Returns: Table[string, CurrencyCode]

• getCurrencyByCode()

Get the currency data by its alphabetic code.

• Arguments:
  • code ISO-4217 alphabetic code as string, required.
• Returns: CurrencyCode