ruby-continent 0.1.0

data/COPYING

@@ -0,0 +1,8 @@
+Copyright (c) 2013, Michael Alexander
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/Gemfile

@@ -0,0 +1 @@
+gem 'rake'

data/Gemfile.lock

@@ -0,0 +1,9 @@
+GEM
+  specs:
+    rake (10.0.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rake

data/README.md

@@ -0,0 +1,68 @@
+ruby-continent
+==============
+
+[![Build Status](https://travis-ci.org/beefsack/ruby-continent.png)](https://travis-ci.org/beefsack/ruby-continent)
+
+ruby-continent provides a mechanism to get the continent for a given country, or
+to get the countries given a continent.  Effort has been made to make the
+library very light weight and efficient.
+
+Countries are returned as a hash in the following format:
+
+```ruby
+{
+  :name => 'Turkey, Republic of',
+  :continent_codes => ['EU', 'AS'],
+  :alpha_2_code => 'TR',
+  :alpha_3_code => 'TUR',
+  :numeric_code => 792
+}
+```
+
+The Turkey example demonstrates how continent codes are given as an array, as
+some countries can belong to multiple continents.  Countries which only belong
+to one continent are also given as an array.
+
+Functions
+---------
+
+### By country
+
+There are a few methods to select a country, based on ISO 3166-1 codes.  These
+all return a single country in the format above, or `nil` if not found.
+
+```RUBY
+Continent.by_alpha_2_code('AU')
+Continent.by_alpha_3_code('AUS')
+Continent.by_numeric_code(36)
+```
+
+### By continent
+
+The following function takes a continent code and returns an array of countries
+in the format above, or nil if the continent is invalid.
+
+```ruby
+Continent.by_continent_code('OC')
+```
+
+Continent codes and names are defined in `share/continent_names.yml`.
+
+### Getting continent name from a code
+
+There is a helper method to get the continent name from the code, as codes are
+used inside the country hashes.
+
+```ruby
+Continent.continent_name('OC')
+```
+
+### Getting access to the underlying data
+
+Full access to the underlying data is available via `Continent.data`, which is
+lazily loaded.
+
+License
+-------
+
+Please see COPYING provided with these source files.

data/Rakefile

@@ -0,0 +1,10 @@
+require 'rake'
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/test*.rb']
+  t.verbose = true
+end
+
+task :default => :test

data/bin/parse_raw

@@ -0,0 +1,43 @@
+#!/usr/bin/ruby
+require 'yaml'
+
+data = {}
+
+# Build base data, indexed by alpha_2_code, and build other indexes at the same time
+data[:base] = {}
+data[:by_continent_code] = {}
+data[:by_alpha_3_code] = {}
+data[:by_numeric_code] = {}
+data[:continent_names] = YAML.load_file(File.join(File.dirname(__FILE__),
+  '..', 'share', 'continent_names.yml'))
+
+ARGF.each do |line|
+  matches = line.match(
+    /^([A-Z]{2})\s+([A-Z]{2}|null)\s+([A-Z]{3}|null)\s+(\d+|null)\s+(.+?)\s*$/)
+  if matches
+    c = {
+      :continent_codes => [matches[1]],
+      :alpha_2_code => matches[2],
+      :alpha_3_code => matches[3] == 'null' ? nil : matches[3],
+      :numeric_code => matches[4] == 'null' ? nil : matches[4].to_i,
+      :name => matches[5]
+    }
+    if data[:by_continent_code][c[:continent_codes].first].nil?
+      data[:by_continent_code][c[:continent_codes].first] = []
+    end
+    data[:by_continent_code][c[:continent_codes].first].push(c[:alpha_2_code])
+    if data[:base][c[:alpha_2_code]].nil?
+      data[:base][c[:alpha_2_code]] = c
+    else
+      data[:base][c[:alpha_2_code]][:continent_codes] += c[:continent_codes]
+    end
+    if c[:alpha_3_code]
+      data[:by_alpha_3_code][c[:alpha_3_code]] = c[:alpha_2_code]
+    end
+    if c[:numeric_code]
+      data[:by_numeric_code][c[:numeric_code]] = c[:alpha_2_code]
+    end
+  end
+end
+
+puts YAML.dump(data)

data/lib/continent.rb

@@ -0,0 +1,31 @@
+require 'yaml'
+
+module Continent
+  def self.data
+    @@data ||= YAML.load_file(File.join(File.dirname(__FILE__), '..', 'share',
+      'data.yml'))
+  end
+
+  def self.by_alpha_2_code country
+    self.data[:base][country]
+  end
+
+  def self.by_alpha_3_code country
+    self.data[:base][self.data[:by_alpha_3_code][country]]
+  end
+
+  def self.by_numeric_code country
+    self.data[:base][self.data[:by_numeric_code][country]]
+  end
+
+  def self.by_continent_code continent
+    return nil unless self.data[:by_continent_code][continent]
+    self.data[:by_continent_code][continent].map do |c|
+      self.data[:base][c]
+    end
+  end
+
+  def self.continent_name continent
+    self.data[:continent_names][continent]
+  end
+end

data/share/continent_names.yml

@@ -0,0 +1,8 @@
+---
+AS: Asia
+EU: Europe
+AN: Antarctica
+AF: Africa
+OC: Oceania
+NA: North America
+SA: South America

data/share/data.yml

@@ -0,0 +1,2568 @@
+---
+:base:
+  AF:
+    :continent_codes:
+    - AS
+    :alpha_2_code: AF
+    :alpha_3_code: AFG
+    :numeric_code: 4
+    :name: Afghanistan, Islamic Republic of
+  AL:
+    :continent_codes:
+    - EU
+    :alpha_2_code: AL
+    :alpha_3_code: ALB
+    :numeric_code: 8
+    :name: Albania, Republic of
+  AQ:
+    :continent_codes:
+    - AN
+    :alpha_2_code: AQ
+    :alpha_3_code: ATA
+    :numeric_code: 10
+    :name: Antarctica (the territory South of 60 deg S)
+  DZ:
+    :continent_codes:
+    - AF
+    :alpha_2_code: DZ
+    :alpha_3_code: DZA
+    :numeric_code: 12
+    :name: Algeria, People's Democratic Republic of
+  AS:
+    :continent_codes:
+    - OC
+    :alpha_2_code: AS
+    :alpha_3_code: ASM
+    :numeric_code: 16
+    :name: American Samoa
+  AD:
+    :continent_codes:
+    - EU
+    :alpha_2_code: AD
+    :alpha_3_code: AND
+    :numeric_code: 20
+    :name: Andorra, Principality of
+  AO:
+    :continent_codes:
+    - AF
+    :alpha_2_code: AO
+    :alpha_3_code: AGO
+    :numeric_code: 24
+    :name: Angola, Republic of
+  AG:
+    :continent_codes:
+    - NA
+    :alpha_2_code: AG
+    :alpha_3_code: ATG
+    :numeric_code: 28
+    :name: Antigua and Barbuda
+  AZ:
+    :continent_codes:
+    - EU
+    - AS
+    :alpha_2_code: AZ
+    :alpha_3_code: AZE
+    :numeric_code: 31
+    :name: Azerbaijan, Republic of
+  AR:
+    :continent_codes:
+    - SA
+    :alpha_2_code: AR
+    :alpha_3_code: ARG
+    :numeric_code: 32
+    :name: Argentina, Argentine Republic
+  AU:
+    :continent_codes:
+    - OC
+    :alpha_2_code: AU
+    :alpha_3_code: AUS
+    :numeric_code: 36
+    :name: Australia, Commonwealth of
+  AT:
+    :continent_codes:
+    - EU
+    :alpha_2_code: AT
+    :alpha_3_code: AUT
+    :numeric_code: 40
+    :name: Austria, Republic of
+  BS:
+    :continent_codes:
+    - NA
+    :alpha_2_code: BS
+    :alpha_3_code: BHS
+    :numeric_code: 44
+    :name: Bahamas, Commonwealth of the
+  BH:
+    :continent_codes:
+    - AS
+    :alpha_2_code: BH
+    :alpha_3_code: BHR
+    :numeric_code: 48
+    :name: Bahrain, Kingdom of
+  BD:
+    :continent_codes:
+    - AS
+    :alpha_2_code: BD
+    :alpha_3_code: BGD
+    :numeric_code: 50
+    :name: Bangladesh, People's Republic of
+  AM:
+    :continent_codes:
+    - EU
+    - AS
+    :alpha_2_code: AM
+    :alpha_3_code: ARM
+    :numeric_code: 51
+    :name: Armenia, Republic of
+  BB:
+    :continent_codes:
+    - NA
+    :alpha_2_code: BB
+    :alpha_3_code: BRB
+    :numeric_code: 52
+    :name: Barbados
+  BE:
+    :continent_codes:
+    - EU
+    :alpha_2_code: BE
+    :alpha_3_code: BEL
+    :numeric_code: 56
+    :name: Belgium, Kingdom of
+  BM:
+    :continent_codes:
+    - NA
+    :alpha_2_code: BM
+    :alpha_3_code: BMU
+    :numeric_code: 60
+    :name: Bermuda
+  BT:
+    :continent_codes:
+    - AS
+    :alpha_2_code: BT
+    :alpha_3_code: BTN
+    :numeric_code: 64
+    :name: Bhutan, Kingdom of
+  BO:
+    :continent_codes:
+    - SA
+    :alpha_2_code: BO
+    :alpha_3_code: BOL
+    :numeric_code: 68
+    :name: Bolivia, Republic of
+  BA:
+    :continent_codes:
+    - EU
+    :alpha_2_code: BA
+    :alpha_3_code: BIH
+    :numeric_code: 70
+    :name: Bosnia and Herzegovina
+  BW:
+    :continent_codes:
+    - AF
+    :alpha_2_code: BW
+    :alpha_3_code: BWA
+    :numeric_code: 72
+    :name: Botswana, Republic of
+  BV:
+    :continent_codes:
+    - AN
+    :alpha_2_code: BV
+    :alpha_3_code: BVT
+    :numeric_code: 74
+    :name: Bouvet Island (Bouvetoya)
+  BR:
+    :continent_codes:
+    - SA
+    :alpha_2_code: BR
+    :alpha_3_code: BRA
+    :numeric_code: 76
+    :name: Brazil, Federative Republic of
+  BZ:
+    :continent_codes:
+    - NA
+    :alpha_2_code: BZ
+    :alpha_3_code: BLZ
+    :numeric_code: 84
+    :name: Belize
+  IO:
+    :continent_codes:
+    - AS
+    :alpha_2_code: IO
+    :alpha_3_code: IOT
+    :numeric_code: 86
+    :name: British Indian Ocean Territory (Chagos Archipelago)
+  SB:
+    :continent_codes:
+    - OC
+    :alpha_2_code: SB
+    :alpha_3_code: SLB
+    :numeric_code: 90
+    :name: Solomon Islands
+  VG:
+    :continent_codes:
+    - NA
+    :alpha_2_code: VG
+    :alpha_3_code: VGB
+    :numeric_code: 92
+    :name: British Virgin Islands
+  BN:
+    :continent_codes:
+    - AS
+    :alpha_2_code: BN
+    :alpha_3_code: BRN
+    :numeric_code: 96
+    :name: Brunei Darussalam
+  BG:
+    :continent_codes:
+    - EU
+    :alpha_2_code: BG
+    :alpha_3_code: BGR
+    :numeric_code: 100
+    :name: Bulgaria, Republic of
+  MM:
+    :continent_codes:
+    - AS
+    :alpha_2_code: MM
+    :alpha_3_code: MMR
+    :numeric_code: 104
+    :name: Myanmar, Union of
+  BI:
+    :continent_codes:
+    - AF
+    :alpha_2_code: BI
+    :alpha_3_code: BDI
+    :numeric_code: 108
+    :name: Burundi, Republic of
+  BY:
+    :continent_codes:
+    - EU
+    :alpha_2_code: BY
+    :alpha_3_code: BLR
+    :numeric_code: 112
+    :name: Belarus, Republic of
+  KH:
+    :continent_codes:
+    - AS
+    :alpha_2_code: KH
+    :alpha_3_code: KHM
+    :numeric_code: 116
+    :name: Cambodia, Kingdom of
+  CM:
+    :continent_codes:
+    - AF
+    :alpha_2_code: CM
+    :alpha_3_code: CMR
+    :numeric_code: 120
+    :name: Cameroon, Republic of
+  CA:
+    :continent_codes:
+    - NA
+    :alpha_2_code: CA
+    :alpha_3_code: CAN
+    :numeric_code: 124
+    :name: Canada
+  CV:
+    :continent_codes:
+    - AF
+    :alpha_2_code: CV
+    :alpha_3_code: CPV
+    :numeric_code: 132
+    :name: Cape Verde, Republic of
+  KY:
+    :continent_codes:
+    - NA
+    :alpha_2_code: KY
+    :alpha_3_code: CYM
+    :numeric_code: 136
+    :name: Cayman Islands
+  CF:
+    :continent_codes:
+    - AF
+    :alpha_2_code: CF
+    :alpha_3_code: CAF
+    :numeric_code: 140
+    :name: Central African Republic
+  LK:
+    :continent_codes:
+    - AS
+    :alpha_2_code: LK
+    :alpha_3_code: LKA
+    :numeric_code: 144
+    :name: Sri Lanka, Democratic Socialist Republic of
+  TD:
+    :continent_codes:
+    - AF
+    :alpha_2_code: TD
+    :alpha_3_code: TCD
+    :numeric_code: 148
+    :name: Chad, Republic of
+  CL:
+    :continent_codes:
+    - SA
+    :alpha_2_code: CL
+    :alpha_3_code: CHL
+    :numeric_code: 152
+    :name: Chile, Republic of
+  CN:
+    :continent_codes:
+    - AS
+    :alpha_2_code: CN
+    :alpha_3_code: CHN
+    :numeric_code: 156
+    :name: China, People's Republic of
+  TW:
+    :continent_codes:
+    - AS
+    :alpha_2_code: TW
+    :alpha_3_code: TWN
+    :numeric_code: 158
+    :name: Taiwan
+  CX:
+    :continent_codes:
+    - AS
+    :alpha_2_code: CX
+    :alpha_3_code: CXR
+    :numeric_code: 162
+    :name: Christmas Island
+  CC:
+    :continent_codes:
+    - AS
+    :alpha_2_code: CC
+    :alpha_3_code: CCK
+    :numeric_code: 166
+    :name: Cocos (Keeling) Islands
+  CO:
+    :continent_codes:
+    - SA
+    :alpha_2_code: CO
+    :alpha_3_code: COL
+    :numeric_code: 170
+    :name: Colombia, Republic of
+  KM:
+    :continent_codes:
+    - AF
+    :alpha_2_code: KM
+    :alpha_3_code: COM
+    :numeric_code: 174
+    :name: Comoros, Union of the
+  YT:
+    :continent_codes:
+    - AF
+    :alpha_2_code: YT
+    :alpha_3_code: MYT
+    :numeric_code: 175
+    :name: Mayotte
+  CG:
+    :continent_codes:
+    - AF
+    :alpha_2_code: CG
+    :alpha_3_code: COG
+    :numeric_code: 178
+    :name: Congo, Republic of the
+  CD:
+    :continent_codes:
+    - AF
+    :alpha_2_code: CD
+    :alpha_3_code: COD
+    :numeric_code: 180
+    :name: Congo, Democratic Republic of the
+  CK:
+    :continent_codes:
+    - OC
+    :alpha_2_code: CK
+    :alpha_3_code: COK
+    :numeric_code: 184
+    :name: Cook Islands
+  CR:
+    :continent_codes:
+    - NA
+    :alpha_2_code: CR
+    :alpha_3_code: CRI
+    :numeric_code: 188
+    :name: Costa Rica, Republic of
+  HR:
+    :continent_codes:
+    - EU
+    :alpha_2_code: HR
+    :alpha_3_code: HRV
+    :numeric_code: 191
+    :name: Croatia, Republic of
+  CU:
+    :continent_codes:
+    - NA
+    :alpha_2_code: CU
+    :alpha_3_code: CUB
+    :numeric_code: 192
+    :name: Cuba, Republic of
+  CY:
+    :continent_codes:
+    - EU
+    - AS
+    :alpha_2_code: CY
+    :alpha_3_code: CYP
+    :numeric_code: 196
+    :name: Cyprus, Republic of
+  CZ:
+    :continent_codes:
+    - EU
+    :alpha_2_code: CZ
+    :alpha_3_code: CZE
+    :numeric_code: 203
+    :name: Czech Republic
+  BJ:
+    :continent_codes:
+    - AF
+    :alpha_2_code: BJ
+    :alpha_3_code: BEN
+    :numeric_code: 204
+    :name: Benin, Republic of
+  DK:
+    :continent_codes:
+    - EU
+    :alpha_2_code: DK
+    :alpha_3_code: DNK
+    :numeric_code: 208
+    :name: Denmark, Kingdom of
+  DM:
+    :continent_codes:
+    - NA
+    :alpha_2_code: DM
+    :alpha_3_code: DMA
+    :numeric_code: 212
+    :name: Dominica, Commonwealth of
+  DO:
+    :continent_codes:
+    - NA
+    :alpha_2_code: DO
+    :alpha_3_code: DOM
+    :numeric_code: 214
+    :name: Dominican Republic
+  EC:
+    :continent_codes:
+    - SA
+    :alpha_2_code: EC
+    :alpha_3_code: ECU
+    :numeric_code: 218
+    :name: Ecuador, Republic of
+  SV:
+    :continent_codes:
+    - NA
+    :alpha_2_code: SV
+    :alpha_3_code: SLV
+    :numeric_code: 222
+    :name: El Salvador, Republic of
+  GQ:
+    :continent_codes:
+    - AF
+    :alpha_2_code: GQ
+    :alpha_3_code: GNQ
+    :numeric_code: 226
+    :name: Equatorial Guinea, Republic of
+  ET:
+    :continent_codes:
+    - AF
+    :alpha_2_code: ET
+    :alpha_3_code: ETH
+    :numeric_code: 231
+    :name: Ethiopia, Federal Democratic Republic of
+  ER:
+    :continent_codes:
+    - AF
+    :alpha_2_code: ER
+    :alpha_3_code: ERI
+    :numeric_code: 232
+    :name: Eritrea, State of
+  EE:
+    :continent_codes:
+    - EU
+    :alpha_2_code: EE
+    :alpha_3_code: EST
+    :numeric_code: 233
+    :name: Estonia, Republic of
+  FO:
+    :continent_codes:
+    - EU
+    :alpha_2_code: FO
+    :alpha_3_code: FRO
+    :numeric_code: 234
+    :name: Faroe Islands
+  FK:
+    :continent_codes:
+    - SA
+    :alpha_2_code: FK
+    :alpha_3_code: FLK
+    :numeric_code: 238
+    :name: Falkland Islands (Malvinas)
+  GS:
+    :continent_codes:
+    - AN
+    :alpha_2_code: GS
+    :alpha_3_code: SGS
+    :numeric_code: 239
+    :name: South Georgia and the South Sandwich Islands
+  FJ:
+    :continent_codes:
+    - OC
+    :alpha_2_code: FJ
+    :alpha_3_code: FJI
+    :numeric_code: 242
+    :name: Fiji, Republic of the Fiji Islands
+  FI:
+    :continent_codes:
+    - EU
+    :alpha_2_code: FI
+    :alpha_3_code: FIN
+    :numeric_code: 246
+    :name: Finland, Republic of
+  AX:
+    :continent_codes:
+    - EU
+    :alpha_2_code: AX
+    :alpha_3_code: ALA
+    :numeric_code: 248
+    :name: Åland Islands
+  FR:
+    :continent_codes:
+    - EU
+    :alpha_2_code: FR
+    :alpha_3_code: FRA
+    :numeric_code: 250
+    :name: France, French Republic
+  GF:
+    :continent_codes:
+    - SA
+    :alpha_2_code: GF
+    :alpha_3_code: GUF
+    :numeric_code: 254
+    :name: French Guiana
+  PF:
+    :continent_codes:
+    - OC
+    :alpha_2_code: PF
+    :alpha_3_code: PYF
+    :numeric_code: 258
+    :name: French Polynesia
+  TF:
+    :continent_codes:
+    - AN
+    :alpha_2_code: TF
+    :alpha_3_code: ATF
+    :numeric_code: 260
+    :name: French Southern Territories
+  DJ:
+    :continent_codes:
+    - AF
+    :alpha_2_code: DJ
+    :alpha_3_code: DJI
+    :numeric_code: 262
+    :name: Djibouti, Republic of
+  GA:
+    :continent_codes:
+    - AF
+    :alpha_2_code: GA
+    :alpha_3_code: GAB
+    :numeric_code: 266
+    :name: Gabon, Gabonese Republic
+  GE:
+    :continent_codes:
+    - EU
+    - AS
+    :alpha_2_code: GE
+    :alpha_3_code: GEO
+    :numeric_code: 268
+    :name: Georgia
+  GM:
+    :continent_codes:
+    - AF
+    :alpha_2_code: GM
+    :alpha_3_code: GMB
+    :numeric_code: 270
+    :name: Gambia, Republic of the
+  PS:
+    :continent_codes:
+    - AS
+    :alpha_2_code: PS
+    :alpha_3_code: PSE
+    :numeric_code: 275
+    :name: Palestinian Territory, Occupied
+  DE:
+    :continent_codes:
+    - EU
+    :alpha_2_code: DE
+    :alpha_3_code: DEU
+    :numeric_code: 276
+    :name: Germany, Federal Republic of
+  GH:
+    :continent_codes:
+    - AF
+    :alpha_2_code: GH
+    :alpha_3_code: GHA
+    :numeric_code: 288
+    :name: Ghana, Republic of
+  GI:
+    :continent_codes:
+    - EU
+    :alpha_2_code: GI
+    :alpha_3_code: GIB
+    :numeric_code: 292
+    :name: Gibraltar
+  KI:
+    :continent_codes:
+    - OC
+    :alpha_2_code: KI
+    :alpha_3_code: KIR
+    :numeric_code: 296
+    :name: Kiribati, Republic of
+  GR:
+    :continent_codes:
+    - EU
+    :alpha_2_code: GR
+    :alpha_3_code: GRC
+    :numeric_code: 300
+    :name: Greece, Hellenic Republic
+  GL:
+    :continent_codes:
+    - NA
+    :alpha_2_code: GL
+    :alpha_3_code: GRL
+    :numeric_code: 304
+    :name: Greenland
+  GD:
+    :continent_codes:
+    - NA
+    :alpha_2_code: GD
+    :alpha_3_code: GRD
+    :numeric_code: 308
+    :name: Grenada
+  GP:
+    :continent_codes:
+    - NA
+    :alpha_2_code: GP
+    :alpha_3_code: GLP
+    :numeric_code: 312
+    :name: Guadeloupe
+  GU:
+    :continent_codes:
+    - OC
+    :alpha_2_code: GU
+    :alpha_3_code: GUM
+    :numeric_code: 316
+    :name: Guam
+  GT:
+    :continent_codes:
+    - NA
+    :alpha_2_code: GT
+    :alpha_3_code: GTM
+    :numeric_code: 320
+    :name: Guatemala, Republic of
+  GN:
+    :continent_codes:
+    - AF
+    :alpha_2_code: GN
+    :alpha_3_code: GIN
+    :numeric_code: 324
+    :name: Guinea, Republic of
+  GY:
+    :continent_codes:
+    - SA
+    :alpha_2_code: GY
+    :alpha_3_code: GUY
+    :numeric_code: 328
+    :name: Guyana, Co-operative Republic of
+  HT:
+    :continent_codes:
+    - NA
+    :alpha_2_code: HT
+    :alpha_3_code: HTI
+    :numeric_code: 332
+    :name: Haiti, Republic of
+  HM:
+    :continent_codes:
+    - AN
+    :alpha_2_code: HM
+    :alpha_3_code: HMD
+    :numeric_code: 334
+    :name: Heard Island and McDonald Islands
+  VA:
+    :continent_codes:
+    - EU
+    :alpha_2_code: VA
+    :alpha_3_code: VAT
+    :numeric_code: 336
+    :name: Holy See (Vatican City State)
+  HN:
+    :continent_codes:
+    - NA
+    :alpha_2_code: HN
+    :alpha_3_code: HND
+    :numeric_code: 340
+    :name: Honduras, Republic of
+  HK:
+    :continent_codes:
+    - AS
+    :alpha_2_code: HK
+    :alpha_3_code: HKG
+    :numeric_code: 344
+    :name: Hong Kong, Special Administrative Region of China
+  HU:
+    :continent_codes:
+    - EU
+    :alpha_2_code: HU
+    :alpha_3_code: HUN
+    :numeric_code: 348
+    :name: Hungary, Republic of
+  IS:
+    :continent_codes:
+    - EU
+    :alpha_2_code: IS
+    :alpha_3_code: ISL
+    :numeric_code: 352
+    :name: Iceland, Republic of
+  IN:
+    :continent_codes:
+    - AS
+    :alpha_2_code: IN
+    :alpha_3_code: IND
+    :numeric_code: 356
+    :name: India, Republic of
+  ID:
+    :continent_codes:
+    - AS
+    :alpha_2_code: ID
+    :alpha_3_code: IDN
+    :numeric_code: 360
+    :name: Indonesia, Republic of
+  IR:
+    :continent_codes:
+    - AS
+    :alpha_2_code: IR
+    :alpha_3_code: IRN
+    :numeric_code: 364
+    :name: Iran, Islamic Republic of
+  IQ:
+    :continent_codes:
+    - AS
+    :alpha_2_code: IQ
+    :alpha_3_code: IRQ
+    :numeric_code: 368
+    :name: Iraq, Republic of
+  IE:
+    :continent_codes:
+    - EU
+    :alpha_2_code: IE
+    :alpha_3_code: IRL
+    :numeric_code: 372
+    :name: Ireland
+  IL:
+    :continent_codes:
+    - AS
+    :alpha_2_code: IL
+    :alpha_3_code: ISR
+    :numeric_code: 376
+    :name: Israel, State of
+  IT:
+    :continent_codes:
+    - EU
+    :alpha_2_code: IT
+    :alpha_3_code: ITA
+    :numeric_code: 380
+    :name: Italy, Italian Republic
+  CI:
+    :continent_codes:
+    - AF
+    :alpha_2_code: CI
+    :alpha_3_code: CIV
+    :numeric_code: 384
+    :name: Cote d'Ivoire, Republic of
+  JM:
+    :continent_codes:
+    - NA
+    :alpha_2_code: JM
+    :alpha_3_code: JAM
+    :numeric_code: 388
+    :name: Jamaica
+  JP:
+    :continent_codes:
+    - AS
+    :alpha_2_code: JP
+    :alpha_3_code: JPN
+    :numeric_code: 392
+    :name: Japan
+  KZ:
+    :continent_codes:
+    - EU
+    - AS
+    :alpha_2_code: KZ
+    :alpha_3_code: KAZ
+    :numeric_code: 398
+    :name: Kazakhstan, Republic of
+  JO:
+    :continent_codes:
+    - AS
+    :alpha_2_code: JO
+    :alpha_3_code: JOR
+    :numeric_code: 400
+    :name: Jordan, Hashemite Kingdom of
+  KE:
+    :continent_codes:
+    - AF
+    :alpha_2_code: KE
+    :alpha_3_code: KEN
+    :numeric_code: 404
+    :name: Kenya, Republic of
+  KP:
+    :continent_codes:
+    - AS
+    :alpha_2_code: KP
+    :alpha_3_code: PRK
+    :numeric_code: 408
+    :name: Korea, Democratic People's Republic of
+  KR:
+    :continent_codes:
+    - AS
+    :alpha_2_code: KR
+    :alpha_3_code: KOR
+    :numeric_code: 410
+    :name: Korea, Republic of
+  KW:
+    :continent_codes:
+    - AS
+    :alpha_2_code: KW
+    :alpha_3_code: KWT
+    :numeric_code: 414
+    :name: Kuwait, State of
+  KG:
+    :continent_codes:
+    - AS
+    :alpha_2_code: KG
+    :alpha_3_code: KGZ
+    :numeric_code: 417
+    :name: Kyrgyz Republic
+  LA:
+    :continent_codes:
+    - AS
+    :alpha_2_code: LA
+    :alpha_3_code: LAO
+    :numeric_code: 418
+    :name: Lao People's Democratic Republic
+  LB:
+    :continent_codes:
+    - AS
+    :alpha_2_code: LB
+    :alpha_3_code: LBN
+    :numeric_code: 422
+    :name: Lebanon, Lebanese Republic
+  LS:
+    :continent_codes:
+    - AF
+    :alpha_2_code: LS
+    :alpha_3_code: LSO
+    :numeric_code: 426
+    :name: Lesotho, Kingdom of
+  LV:
+    :continent_codes:
+    - EU
+    :alpha_2_code: LV
+    :alpha_3_code: LVA
+    :numeric_code: 428
+    :name: Latvia, Republic of
+  LR:
+    :continent_codes:
+    - AF
+    :alpha_2_code: LR
+    :alpha_3_code: LBR
+    :numeric_code: 430
+    :name: Liberia, Republic of
+  LY:
+    :continent_codes:
+    - AF
+    :alpha_2_code: LY
+    :alpha_3_code: LBY
+    :numeric_code: 434
+    :name: Libyan Arab Jamahiriya
+  LI:
+    :continent_codes:
+    - EU
+    :alpha_2_code: LI
+    :alpha_3_code: LIE
+    :numeric_code: 438
+    :name: Liechtenstein, Principality of
+  LT:
+    :continent_codes:
+    - EU
+    :alpha_2_code: LT
+    :alpha_3_code: LTU
+    :numeric_code: 440
+    :name: Lithuania, Republic of
+  LU:
+    :continent_codes:
+    - EU
+    :alpha_2_code: LU
+    :alpha_3_code: LUX
+    :numeric_code: 442
+    :name: Luxembourg, Grand Duchy of
+  MO:
+    :continent_codes:
+    - AS
+    :alpha_2_code: MO
+    :alpha_3_code: MAC
+    :numeric_code: 446
+    :name: Macao, Special Administrative Region of China
+  MG:
+    :continent_codes:
+    - AF
+    :alpha_2_code: MG
+    :alpha_3_code: MDG
+    :numeric_code: 450
+    :name: Madagascar, Republic of
+  MW:
+    :continent_codes:
+    - AF
+    :alpha_2_code: MW
+    :alpha_3_code: MWI
+    :numeric_code: 454
+    :name: Malawi, Republic of
+  MY:
+    :continent_codes:
+    - AS
+    :alpha_2_code: MY
+    :alpha_3_code: MYS
+    :numeric_code: 458
+    :name: Malaysia
+  MV:
+    :continent_codes:
+    - AS
+    :alpha_2_code: MV
+    :alpha_3_code: MDV
+    :numeric_code: 462
+    :name: Maldives, Republic of
+  ML:
+    :continent_codes:
+    - AF
+    :alpha_2_code: ML
+    :alpha_3_code: MLI
+    :numeric_code: 466
+    :name: Mali, Republic of
+  MT:
+    :continent_codes:
+    - EU
+    :alpha_2_code: MT
+    :alpha_3_code: MLT
+    :numeric_code: 470
+    :name: Malta, Republic of
+  MQ:
+    :continent_codes:
+    - NA
+    :alpha_2_code: MQ
+    :alpha_3_code: MTQ
+    :numeric_code: 474
+    :name: Martinique
+  MR:
+    :continent_codes:
+    - AF
+    :alpha_2_code: MR
+    :alpha_3_code: MRT
+    :numeric_code: 478
+    :name: Mauritania, Islamic Republic of
+  MU:
+    :continent_codes:
+    - AF
+    :alpha_2_code: MU
+    :alpha_3_code: MUS
+    :numeric_code: 480
+    :name: Mauritius, Republic of
+  MX:
+    :continent_codes:
+    - NA
+    :alpha_2_code: MX
+    :alpha_3_code: MEX
+    :numeric_code: 484
+    :name: Mexico, United Mexican States
+  MC:
+    :continent_codes:
+    - EU
+    :alpha_2_code: MC
+    :alpha_3_code: MCO
+    :numeric_code: 492
+    :name: Monaco, Principality of
+  MN:
+    :continent_codes:
+    - AS
+    :alpha_2_code: MN
+    :alpha_3_code: MNG
+    :numeric_code: 496
+    :name: Mongolia
+  MD:
+    :continent_codes:
+    - EU
+    :alpha_2_code: MD
+    :alpha_3_code: MDA
+    :numeric_code: 498
+    :name: Moldova, Republic of
+  ME:
+    :continent_codes:
+    - EU
+    :alpha_2_code: ME
+    :alpha_3_code: MNE
+    :numeric_code: 499
+    :name: Montenegro, Republic of
+  MS:
+    :continent_codes:
+    - NA
+    :alpha_2_code: MS
+    :alpha_3_code: MSR
+    :numeric_code: 500
+    :name: Montserrat
+  MA:
+    :continent_codes:
+    - AF
+    :alpha_2_code: MA
+    :alpha_3_code: MAR
+    :numeric_code: 504
+    :name: Morocco, Kingdom of
+  MZ:
+    :continent_codes:
+    - AF
+    :alpha_2_code: MZ
+    :alpha_3_code: MOZ
+    :numeric_code: 508
+    :name: Mozambique, Republic of
+  OM:
+    :continent_codes:
+    - AS
+    :alpha_2_code: OM
+    :alpha_3_code: OMN
+    :numeric_code: 512
+    :name: Oman, Sultanate of
+  NA:
+    :continent_codes:
+    - AF
+    :alpha_2_code: NA
+    :alpha_3_code: NAM
+    :numeric_code: 516
+    :name: Namibia, Republic of
+  NR:
+    :continent_codes:
+    - OC
+    :alpha_2_code: NR
+    :alpha_3_code: NRU
+    :numeric_code: 520
+    :name: Nauru, Republic of
+  NP:
+    :continent_codes:
+    - AS
+    :alpha_2_code: NP
+    :alpha_3_code: NPL
+    :numeric_code: 524
+    :name: Nepal, State of
+  NL:
+    :continent_codes:
+    - EU
+    :alpha_2_code: NL
+    :alpha_3_code: NLD
+    :numeric_code: 528
+    :name: Netherlands, Kingdom of the
+  AN:
+    :continent_codes:
+    - NA
+    :alpha_2_code: AN
+    :alpha_3_code: ANT
+    :numeric_code: 530
+    :name: Netherlands Antilles
+  CW:
+    :continent_codes:
+    - NA
+    :alpha_2_code: CW
+    :alpha_3_code: CUW
+    :numeric_code: 531
+    :name: Curaçao
+  AW:
+    :continent_codes:
+    - NA
+    :alpha_2_code: AW
+    :alpha_3_code: ABW
+    :numeric_code: 533
+    :name: Aruba
+  SX:
+    :continent_codes:
+    - NA
+    :alpha_2_code: SX
+    :alpha_3_code: SXM
+    :numeric_code: 534
+    :name: Sint Maarten (Netherlands)
+  BQ:
+    :continent_codes:
+    - NA
+    :alpha_2_code: BQ
+    :alpha_3_code: BES
+    :numeric_code: 535
+    :name: Bonaire, Sint Eustatius and Saba
+  NC:
+    :continent_codes:
+    - OC
+    :alpha_2_code: NC
+    :alpha_3_code: NCL
+    :numeric_code: 540
+    :name: New Caledonia
+  VU:
+    :continent_codes:
+    - OC
+    :alpha_2_code: VU
+    :alpha_3_code: VUT
+    :numeric_code: 548
+    :name: Vanuatu, Republic of
+  NZ:
+    :continent_codes:
+    - OC
+    :alpha_2_code: NZ
+    :alpha_3_code: NZL
+    :numeric_code: 554
+    :name: New Zealand
+  NI:
+    :continent_codes:
+    - NA
+    :alpha_2_code: NI
+    :alpha_3_code: NIC
+    :numeric_code: 558
+    :name: Nicaragua, Republic of
+  NE:
+    :continent_codes:
+    - AF
+    :alpha_2_code: NE
+    :alpha_3_code: NER
+    :numeric_code: 562
+    :name: Niger, Republic of
+  NG:
+    :continent_codes:
+    - AF
+    :alpha_2_code: NG
+    :alpha_3_code: NGA
+    :numeric_code: 566
+    :name: Nigeria, Federal Republic of
+  NU:
+    :continent_codes:
+    - OC
+    :alpha_2_code: NU
+    :alpha_3_code: NIU
+    :numeric_code: 570
+    :name: Niue
+  NF:
+    :continent_codes:
+    - OC
+    :alpha_2_code: NF
+    :alpha_3_code: NFK
+    :numeric_code: 574
+    :name: Norfolk Island
+  'NO':
+    :continent_codes:
+    - EU
+    :alpha_2_code: 'NO'
+    :alpha_3_code: NOR
+    :numeric_code: 578
+    :name: Norway, Kingdom of
+  MP:
+    :continent_codes:
+    - OC
+    :alpha_2_code: MP
+    :alpha_3_code: MNP
+    :numeric_code: 580
+    :name: Northern Mariana Islands, Commonwealth of the
+  UM:
+    :continent_codes:
+    - OC
+    - NA
+    :alpha_2_code: UM
+    :alpha_3_code: UMI
+    :numeric_code: 581
+    :name: United States Minor Outlying Islands
+  FM:
+    :continent_codes:
+    - OC
+    :alpha_2_code: FM
+    :alpha_3_code: FSM
+    :numeric_code: 583
+    :name: Micronesia, Federated States of
+  MH:
+    :continent_codes:
+    - OC
+    :alpha_2_code: MH
+    :alpha_3_code: MHL
+    :numeric_code: 584
+    :name: Marshall Islands, Republic of the
+  PW:
+    :continent_codes:
+    - OC
+    :alpha_2_code: PW
+    :alpha_3_code: PLW
+    :numeric_code: 585
+    :name: Palau, Republic of
+  PK:
+    :continent_codes:
+    - AS
+    :alpha_2_code: PK
+    :alpha_3_code: PAK
+    :numeric_code: 586
+    :name: Pakistan, Islamic Republic of
+  PA:
+    :continent_codes:
+    - NA
+    :alpha_2_code: PA
+    :alpha_3_code: PAN
+    :numeric_code: 591
+    :name: Panama, Republic of
+  PG:
+    :continent_codes:
+    - OC
+    :alpha_2_code: PG
+    :alpha_3_code: PNG
+    :numeric_code: 598
+    :name: Papua New Guinea, Independent State of
+  PY:
+    :continent_codes:
+    - SA
+    :alpha_2_code: PY
+    :alpha_3_code: PRY
+    :numeric_code: 600
+    :name: Paraguay, Republic of
+  PE:
+    :continent_codes:
+    - SA
+    :alpha_2_code: PE
+    :alpha_3_code: PER
+    :numeric_code: 604
+    :name: Peru, Republic of
+  PH:
+    :continent_codes:
+    - AS
+    :alpha_2_code: PH
+    :alpha_3_code: PHL
+    :numeric_code: 608
+    :name: Philippines, Republic of the
+  PN:
+    :continent_codes:
+    - OC
+    :alpha_2_code: PN
+    :alpha_3_code: PCN
+    :numeric_code: 612
+    :name: Pitcairn Islands
+  PL:
+    :continent_codes:
+    - EU
+    :alpha_2_code: PL
+    :alpha_3_code: POL
+    :numeric_code: 616
+    :name: Poland, Republic of
+  PT:
+    :continent_codes:
+    - EU
+    :alpha_2_code: PT
+    :alpha_3_code: PRT
+    :numeric_code: 620
+    :name: Portugal, Portuguese Republic
+  GW:
+    :continent_codes:
+    - AF
+    :alpha_2_code: GW
+    :alpha_3_code: GNB
+    :numeric_code: 624
+    :name: Guinea-Bissau, Republic of
+  TL:
+    :continent_codes:
+    - AS
+    :alpha_2_code: TL
+    :alpha_3_code: TLS
+    :numeric_code: 626
+    :name: Timor-Leste, Democratic Republic of
+  PR:
+    :continent_codes:
+    - NA
+    :alpha_2_code: PR
+    :alpha_3_code: PRI
+    :numeric_code: 630
+    :name: Puerto Rico, Commonwealth of
+  QA:
+    :continent_codes:
+    - AS
+    :alpha_2_code: QA
+    :alpha_3_code: QAT
+    :numeric_code: 634
+    :name: Qatar, State of
+  RE:
+    :continent_codes:
+    - AF
+    :alpha_2_code: RE
+    :alpha_3_code: REU
+    :numeric_code: 638
+    :name: Reunion
+  RO:
+    :continent_codes:
+    - EU
+    :alpha_2_code: RO
+    :alpha_3_code: ROU
+    :numeric_code: 642
+    :name: Romania
+  RU:
+    :continent_codes:
+    - EU
+    - AS
+    :alpha_2_code: RU
+    :alpha_3_code: RUS
+    :numeric_code: 643
+    :name: Russian Federation
+  RW:
+    :continent_codes:
+    - AF
+    :alpha_2_code: RW
+    :alpha_3_code: RWA
+    :numeric_code: 646
+    :name: Rwanda, Republic of
+  BL:
+    :continent_codes:
+    - NA
+    :alpha_2_code: BL
+    :alpha_3_code: BLM
+    :numeric_code: 652
+    :name: Saint Barthelemy
+  SH:
+    :continent_codes:
+    - AF
+    :alpha_2_code: SH
+    :alpha_3_code: SHN
+    :numeric_code: 654
+    :name: Saint Helena
+  KN:
+    :continent_codes:
+    - NA
+    :alpha_2_code: KN
+    :alpha_3_code: KNA
+    :numeric_code: 659
+    :name: Saint Kitts and Nevis, Federation of
+  AI:
+    :continent_codes:
+    - NA
+    :alpha_2_code: AI
+    :alpha_3_code: AIA
+    :numeric_code: 660
+    :name: Anguilla
+  LC:
+    :continent_codes:
+    - NA
+    :alpha_2_code: LC
+    :alpha_3_code: LCA
+    :numeric_code: 662
+    :name: Saint Lucia
+  MF:
+    :continent_codes:
+    - NA
+    :alpha_2_code: MF
+    :alpha_3_code: MAF
+    :numeric_code: 663
+    :name: Saint Martin
+  PM:
+    :continent_codes:
+    - NA
+    :alpha_2_code: PM
+    :alpha_3_code: SPM
+    :numeric_code: 666
+    :name: Saint Pierre and Miquelon
+  VC:
+    :continent_codes:
+    - NA
+    :alpha_2_code: VC
+    :alpha_3_code: VCT
+    :numeric_code: 670
+    :name: Saint Vincent and the Grenadines
+  SM:
+    :continent_codes:
+    - EU
+    :alpha_2_code: SM
+    :alpha_3_code: SMR
+    :numeric_code: 674
+    :name: San Marino, Republic of
+  ST:
+    :continent_codes:
+    - AF
+    :alpha_2_code: ST
+    :alpha_3_code: STP
+    :numeric_code: 678
+    :name: Sao Tome and Principe, Democratic Republic of
+  SA:
+    :continent_codes:
+    - AS
+    :alpha_2_code: SA
+    :alpha_3_code: SAU
+    :numeric_code: 682
+    :name: Saudi Arabia, Kingdom of
+  SN:
+    :continent_codes:
+    - AF
+    :alpha_2_code: SN
+    :alpha_3_code: SEN
+    :numeric_code: 686
+    :name: Senegal, Republic of
+  RS:
+    :continent_codes:
+    - EU
+    :alpha_2_code: RS
+    :alpha_3_code: SRB
+    :numeric_code: 688
+    :name: Serbia, Republic of
+  SC:
+    :continent_codes:
+    - AF
+    :alpha_2_code: SC
+    :alpha_3_code: SYC
+    :numeric_code: 690
+    :name: Seychelles, Republic of
+  SL:
+    :continent_codes:
+    - AF
+    :alpha_2_code: SL
+    :alpha_3_code: SLE
+    :numeric_code: 694
+    :name: Sierra Leone, Republic of
+  SG:
+    :continent_codes:
+    - AS
+    :alpha_2_code: SG
+    :alpha_3_code: SGP
+    :numeric_code: 702
+    :name: Singapore, Republic of
+  SK:
+    :continent_codes:
+    - EU
+    :alpha_2_code: SK
+    :alpha_3_code: SVK
+    :numeric_code: 703
+    :name: Slovakia (Slovak Republic)
+  VN:
+    :continent_codes:
+    - AS
+    :alpha_2_code: VN
+    :alpha_3_code: VNM
+    :numeric_code: 704
+    :name: Vietnam, Socialist Republic of
+  SI:
+    :continent_codes:
+    - EU
+    :alpha_2_code: SI
+    :alpha_3_code: SVN
+    :numeric_code: 705
+    :name: Slovenia, Republic of
+  SO:
+    :continent_codes:
+    - AF
+    :alpha_2_code: SO
+    :alpha_3_code: SOM
+    :numeric_code: 706
+    :name: Somalia, Somali Republic
+  ZA:
+    :continent_codes:
+    - AF
+    :alpha_2_code: ZA
+    :alpha_3_code: ZAF
+    :numeric_code: 710
+    :name: South Africa, Republic of
+  ZW:
+    :continent_codes:
+    - AF
+    :alpha_2_code: ZW
+    :alpha_3_code: ZWE
+    :numeric_code: 716
+    :name: Zimbabwe, Republic of
+  ES:
+    :continent_codes:
+    - EU
+    :alpha_2_code: ES
+    :alpha_3_code: ESP
+    :numeric_code: 724
+    :name: Spain, Kingdom of
+  SS:
+    :continent_codes:
+    - AF
+    :alpha_2_code: SS
+    :alpha_3_code: SSD
+    :numeric_code: 728
+    :name: South Sudan
+  EH:
+    :continent_codes:
+    - AF
+    :alpha_2_code: EH
+    :alpha_3_code: ESH
+    :numeric_code: 732
+    :name: Western Sahara
+  SD:
+    :continent_codes:
+    - AF
+    :alpha_2_code: SD
+    :alpha_3_code: SDN
+    :numeric_code: 736
+    :name: Sudan, Republic of
+  SR:
+    :continent_codes:
+    - SA
+    :alpha_2_code: SR
+    :alpha_3_code: SUR
+    :numeric_code: 740
+    :name: Suriname, Republic of
+  SJ:
+    :continent_codes:
+    - EU
+    :alpha_2_code: SJ
+    :alpha_3_code: SJM
+    :numeric_code: 744
+    :name: Svalbard & Jan Mayen Islands
+  SZ:
+    :continent_codes:
+    - AF
+    :alpha_2_code: SZ
+    :alpha_3_code: SWZ
+    :numeric_code: 748
+    :name: Swaziland, Kingdom of
+  SE:
+    :continent_codes:
+    - EU
+    :alpha_2_code: SE
+    :alpha_3_code: SWE
+    :numeric_code: 752
+    :name: Sweden, Kingdom of
+  CH:
+    :continent_codes:
+    - EU
+    :alpha_2_code: CH
+    :alpha_3_code: CHE
+    :numeric_code: 756
+    :name: Switzerland, Swiss Confederation
+  SY:
+    :continent_codes:
+    - AS
+    :alpha_2_code: SY
+    :alpha_3_code: SYR
+    :numeric_code: 760
+    :name: Syrian Arab Republic
+  TJ:
+    :continent_codes:
+    - AS
+    :alpha_2_code: TJ
+    :alpha_3_code: TJK
+    :numeric_code: 762
+    :name: Tajikistan, Republic of
+  TH:
+    :continent_codes:
+    - AS
+    :alpha_2_code: TH
+    :alpha_3_code: THA
+    :numeric_code: 764
+    :name: Thailand, Kingdom of
+  TG:
+    :continent_codes:
+    - AF
+    :alpha_2_code: TG
+    :alpha_3_code: TGO
+    :numeric_code: 768
+    :name: Togo, Togolese Republic
+  TK:
+    :continent_codes:
+    - OC
+    :alpha_2_code: TK
+    :alpha_3_code: TKL
+    :numeric_code: 772
+    :name: Tokelau
+  TO:
+    :continent_codes:
+    - OC
+    :alpha_2_code: TO
+    :alpha_3_code: TON
+    :numeric_code: 776
+    :name: Tonga, Kingdom of
+  TT:
+    :continent_codes:
+    - NA
+    :alpha_2_code: TT
+    :alpha_3_code: TTO
+    :numeric_code: 780
+    :name: Trinidad and Tobago, Republic of
+  AE:
+    :continent_codes:
+    - AS
+    :alpha_2_code: AE
+    :alpha_3_code: ARE
+    :numeric_code: 784
+    :name: United Arab Emirates
+  TN:
+    :continent_codes:
+    - AF
+    :alpha_2_code: TN
+    :alpha_3_code: TUN
+    :numeric_code: 788
+    :name: Tunisia, Tunisian Republic
+  TR:
+    :continent_codes:
+    - EU
+    - AS
+    :alpha_2_code: TR
+    :alpha_3_code: TUR
+    :numeric_code: 792
+    :name: Turkey, Republic of
+  TM:
+    :continent_codes:
+    - AS
+    :alpha_2_code: TM
+    :alpha_3_code: TKM
+    :numeric_code: 795
+    :name: Turkmenistan
+  TC:
+    :continent_codes:
+    - NA
+    :alpha_2_code: TC
+    :alpha_3_code: TCA
+    :numeric_code: 796
+    :name: Turks and Caicos Islands
+  TV:
+    :continent_codes:
+    - OC
+    :alpha_2_code: TV
+    :alpha_3_code: TUV
+    :numeric_code: 798
+    :name: Tuvalu
+  UG:
+    :continent_codes:
+    - AF
+    :alpha_2_code: UG
+    :alpha_3_code: UGA
+    :numeric_code: 800
+    :name: Uganda, Republic of
+  UA:
+    :continent_codes:
+    - EU
+    :alpha_2_code: UA
+    :alpha_3_code: UKR
+    :numeric_code: 804
+    :name: Ukraine
+  MK:
+    :continent_codes:
+    - EU
+    :alpha_2_code: MK
+    :alpha_3_code: MKD
+    :numeric_code: 807
+    :name: Macedonia, The Former Yugoslav Republic of
+  EG:
+    :continent_codes:
+    - AF
+    :alpha_2_code: EG
+    :alpha_3_code: EGY
+    :numeric_code: 818
+    :name: Egypt, Arab Republic of
+  GB:
+    :continent_codes:
+    - EU
+    :alpha_2_code: GB
+    :alpha_3_code: GBR
+    :numeric_code: 826
+    :name: United Kingdom of Great Britain & Northern Ireland
+  GG:
+    :continent_codes:
+    - EU
+    :alpha_2_code: GG
+    :alpha_3_code: GGY
+    :numeric_code: 831
+    :name: Guernsey, Bailiwick of
+  JE:
+    :continent_codes:
+    - EU
+    :alpha_2_code: JE
+    :alpha_3_code: JEY
+    :numeric_code: 832
+    :name: Jersey, Bailiwick of
+  IM:
+    :continent_codes:
+    - EU
+    :alpha_2_code: IM
+    :alpha_3_code: IMN
+    :numeric_code: 833
+    :name: Isle of Man
+  TZ:
+    :continent_codes:
+    - AF
+    :alpha_2_code: TZ
+    :alpha_3_code: TZA
+    :numeric_code: 834
+    :name: Tanzania, United Republic of
+  US:
+    :continent_codes:
+    - NA
+    :alpha_2_code: US
+    :alpha_3_code: USA
+    :numeric_code: 840
+    :name: United States of America
+  VI:
+    :continent_codes:
+    - NA
+    :alpha_2_code: VI
+    :alpha_3_code: VIR
+    :numeric_code: 850
+    :name: United States Virgin Islands
+  BF:
+    :continent_codes:
+    - AF
+    :alpha_2_code: BF
+    :alpha_3_code: BFA
+    :numeric_code: 854
+    :name: Burkina Faso
+  UY:
+    :continent_codes:
+    - SA
+    :alpha_2_code: UY
+    :alpha_3_code: URY
+    :numeric_code: 858
+    :name: Uruguay, Eastern Republic of
+  UZ:
+    :continent_codes:
+    - AS
+    :alpha_2_code: UZ
+    :alpha_3_code: UZB
+    :numeric_code: 860
+    :name: Uzbekistan, Republic of
+  VE:
+    :continent_codes:
+    - SA
+    :alpha_2_code: VE
+    :alpha_3_code: VEN
+    :numeric_code: 862
+    :name: Venezuela, Bolivarian Republic of
+  WF:
+    :continent_codes:
+    - OC
+    :alpha_2_code: WF
+    :alpha_3_code: WLF
+    :numeric_code: 876
+    :name: Wallis and Futuna
+  WS:
+    :continent_codes:
+    - OC
+    :alpha_2_code: WS
+    :alpha_3_code: WSM
+    :numeric_code: 882
+    :name: Samoa, Independent State of
+  YE:
+    :continent_codes:
+    - AS
+    :alpha_2_code: YE
+    :alpha_3_code: YEM
+    :numeric_code: 887
+    :name: Yemen
+  ZM:
+    :continent_codes:
+    - AF
+    :alpha_2_code: ZM
+    :alpha_3_code: ZMB
+    :numeric_code: 894
+    :name: Zambia, Republic of
+  XX:
+    :continent_codes:
+    - OC
+    :alpha_2_code: XX
+    :alpha_3_code: 
+    :numeric_code: 
+    :name: Disputed Territory
+  XE:
+    :continent_codes:
+    - AS
+    :alpha_2_code: XE
+    :alpha_3_code: 
+    :numeric_code: 
+    :name: Iraq-Saudi Arabia Neutral Zone
+  XD:
+    :continent_codes:
+    - AS
+    :alpha_2_code: XD
+    :alpha_3_code: 
+    :numeric_code: 
+    :name: United Nations Neutral Zone
+  XS:
+    :continent_codes:
+    - AS
+    :alpha_2_code: XS
+    :alpha_3_code: 
+    :numeric_code: 
+    :name: Spratly Islands
+:by_continent_code:
+  AS:
+  - AF
+  - AZ
+  - BH
+  - BD
+  - AM
+  - BT
+  - IO
+  - BN
+  - MM
+  - KH
+  - LK
+  - CN
+  - TW
+  - CX
+  - CC
+  - CY
+  - GE
+  - PS
+  - HK
+  - IN
+  - ID
+  - IR
+  - IQ
+  - IL
+  - JP
+  - KZ
+  - JO
+  - KP
+  - KR
+  - KW
+  - KG
+  - LA
+  - LB
+  - MO
+  - MY
+  - MV
+  - MN
+  - OM
+  - NP
+  - PK
+  - PH
+  - TL
+  - QA
+  - RU
+  - SA
+  - SG
+  - VN
+  - SY
+  - TJ
+  - TH
+  - AE
+  - TR
+  - TM
+  - UZ
+  - YE
+  - XE
+  - XD
+  - XS
+  EU:
+  - AL
+  - AD
+  - AZ
+  - AT
+  - AM
+  - BE
+  - BA
+  - BG
+  - BY
+  - HR
+  - CY
+  - CZ
+  - DK
+  - EE
+  - FO
+  - FI
+  - AX
+  - FR
+  - GE
+  - DE
+  - GI
+  - GR
+  - VA
+  - HU
+  - IS
+  - IE
+  - IT
+  - KZ
+  - LV
+  - LI
+  - LT
+  - LU
+  - MT
+  - MC
+  - MD
+  - ME
+  - NL
+  - 'NO'
+  - PL
+  - PT
+  - RO
+  - RU
+  - SM
+  - RS
+  - SK
+  - SI
+  - ES
+  - SJ
+  - SE
+  - CH
+  - TR
+  - UA
+  - MK
+  - GB
+  - GG
+  - JE
+  - IM
+  AN:
+  - AQ
+  - BV
+  - GS
+  - TF
+  - HM
+  AF:
+  - DZ
+  - AO
+  - BW
+  - BI
+  - CM
+  - CV
+  - CF
+  - TD
+  - KM
+  - YT
+  - CG
+  - CD
+  - BJ
+  - GQ
+  - ET
+  - ER
+  - DJ
+  - GA
+  - GM
+  - GH
+  - GN
+  - CI
+  - KE
+  - LS
+  - LR
+  - LY
+  - MG
+  - MW
+  - ML
+  - MR
+  - MU
+  - MA
+  - MZ
+  - NA
+  - NE
+  - NG
+  - GW
+  - RE
+  - RW
+  - SH
+  - ST
+  - SN
+  - SC
+  - SL
+  - SO
+  - ZA
+  - ZW
+  - SS
+  - EH
+  - SD
+  - SZ
+  - TG
+  - TN
+  - UG
+  - EG
+  - TZ
+  - BF
+  - ZM
+  OC:
+  - AS
+  - AU
+  - SB
+  - CK
+  - FJ
+  - PF
+  - KI
+  - GU
+  - NR
+  - NC
+  - VU
+  - NZ
+  - NU
+  - NF
+  - MP
+  - UM
+  - FM
+  - MH
+  - PW
+  - PG
+  - PN
+  - TK
+  - TO
+  - TV
+  - WF
+  - WS
+  - XX
+  NA:
+  - AG
+  - BS
+  - BB
+  - BM
+  - BZ
+  - VG
+  - CA
+  - KY
+  - CR
+  - CU
+  - DM
+  - DO
+  - SV
+  - GL
+  - GD
+  - GP
+  - GT
+  - HT
+  - HN
+  - JM
+  - MQ
+  - MX
+  - MS
+  - AN
+  - CW
+  - AW
+  - SX
+  - BQ
+  - NI
+  - UM
+  - PA
+  - PR
+  - BL
+  - KN
+  - AI
+  - LC
+  - MF
+  - PM
+  - VC
+  - TT
+  - TC
+  - US
+  - VI
+  SA:
+  - AR
+  - BO
+  - BR
+  - CL
+  - CO
+  - EC
+  - FK
+  - GF
+  - GY
+  - PY
+  - PE
+  - SR
+  - UY
+  - VE
+:by_alpha_3_code:
+  AFG: AF
+  ALB: AL
+  ATA: AQ
+  DZA: DZ
+  ASM: AS
+  AND: AD
+  AGO: AO
+  ATG: AG
+  AZE: AZ
+  ARG: AR
+  AUS: AU
+  AUT: AT
+  BHS: BS
+  BHR: BH
+  BGD: BD
+  ARM: AM
+  BRB: BB
+  BEL: BE
+  BMU: BM
+  BTN: BT
+  BOL: BO
+  BIH: BA
+  BWA: BW
+  BVT: BV
+  BRA: BR
+  BLZ: BZ
+  IOT: IO
+  SLB: SB
+  VGB: VG
+  BRN: BN
+  BGR: BG
+  MMR: MM
+  BDI: BI
+  BLR: BY
+  KHM: KH
+  CMR: CM
+  CAN: CA
+  CPV: CV
+  CYM: KY
+  CAF: CF
+  LKA: LK
+  TCD: TD
+  CHL: CL
+  CHN: CN
+  TWN: TW
+  CXR: CX
+  CCK: CC
+  COL: CO
+  COM: KM
+  MYT: YT
+  COG: CG
+  COD: CD
+  COK: CK
+  CRI: CR
+  HRV: HR
+  CUB: CU
+  CYP: CY
+  CZE: CZ
+  BEN: BJ
+  DNK: DK
+  DMA: DM
+  DOM: DO
+  ECU: EC
+  SLV: SV
+  GNQ: GQ
+  ETH: ET
+  ERI: ER
+  EST: EE
+  FRO: FO
+  FLK: FK
+  SGS: GS
+  FJI: FJ
+  FIN: FI
+  ALA: AX
+  FRA: FR
+  GUF: GF
+  PYF: PF
+  ATF: TF
+  DJI: DJ
+  GAB: GA
+  GEO: GE
+  GMB: GM
+  PSE: PS
+  DEU: DE
+  GHA: GH
+  GIB: GI
+  KIR: KI
+  GRC: GR
+  GRL: GL
+  GRD: GD
+  GLP: GP
+  GUM: GU
+  GTM: GT
+  GIN: GN
+  GUY: GY
+  HTI: HT
+  HMD: HM
+  VAT: VA
+  HND: HN
+  HKG: HK
+  HUN: HU
+  ISL: IS
+  IND: IN
+  IDN: ID
+  IRN: IR
+  IRQ: IQ
+  IRL: IE
+  ISR: IL
+  ITA: IT
+  CIV: CI
+  JAM: JM
+  JPN: JP
+  KAZ: KZ
+  JOR: JO
+  KEN: KE
+  PRK: KP
+  KOR: KR
+  KWT: KW
+  KGZ: KG
+  LAO: LA
+  LBN: LB
+  LSO: LS
+  LVA: LV
+  LBR: LR
+  LBY: LY
+  LIE: LI
+  LTU: LT
+  LUX: LU
+  MAC: MO
+  MDG: MG
+  MWI: MW
+  MYS: MY
+  MDV: MV
+  MLI: ML
+  MLT: MT
+  MTQ: MQ
+  MRT: MR
+  MUS: MU
+  MEX: MX
+  MCO: MC
+  MNG: MN
+  MDA: MD
+  MNE: ME
+  MSR: MS
+  MAR: MA
+  MOZ: MZ
+  OMN: OM
+  NAM: NA
+  NRU: NR
+  NPL: NP
+  NLD: NL
+  ANT: AN
+  CUW: CW
+  ABW: AW
+  SXM: SX
+  BES: BQ
+  NCL: NC
+  VUT: VU
+  NZL: NZ
+  NIC: NI
+  NER: NE
+  NGA: NG
+  NIU: NU
+  NFK: NF
+  NOR: 'NO'
+  MNP: MP
+  UMI: UM
+  FSM: FM
+  MHL: MH
+  PLW: PW
+  PAK: PK
+  PAN: PA
+  PNG: PG
+  PRY: PY
+  PER: PE
+  PHL: PH
+  PCN: PN
+  POL: PL
+  PRT: PT
+  GNB: GW
+  TLS: TL
+  PRI: PR
+  QAT: QA
+  REU: RE
+  ROU: RO
+  RUS: RU
+  RWA: RW
+  BLM: BL
+  SHN: SH
+  KNA: KN
+  AIA: AI
+  LCA: LC
+  MAF: MF
+  SPM: PM
+  VCT: VC
+  SMR: SM
+  STP: ST
+  SAU: SA
+  SEN: SN
+  SRB: RS
+  SYC: SC
+  SLE: SL
+  SGP: SG
+  SVK: SK
+  VNM: VN
+  SVN: SI
+  SOM: SO
+  ZAF: ZA
+  ZWE: ZW
+  ESP: ES
+  SSD: SS
+  ESH: EH
+  SDN: SD
+  SUR: SR
+  SJM: SJ
+  SWZ: SZ
+  SWE: SE
+  CHE: CH
+  SYR: SY
+  TJK: TJ
+  THA: TH
+  TGO: TG
+  TKL: TK
+  TON: TO
+  TTO: TT
+  ARE: AE
+  TUN: TN
+  TUR: TR
+  TKM: TM
+  TCA: TC
+  TUV: TV
+  UGA: UG
+  UKR: UA
+  MKD: MK
+  EGY: EG
+  GBR: GB
+  GGY: GG
+  JEY: JE
+  IMN: IM
+  TZA: TZ
+  USA: US
+  VIR: VI
+  BFA: BF
+  URY: UY
+  UZB: UZ
+  VEN: VE
+  WLF: WF
+  WSM: WS
+  YEM: YE
+  ZMB: ZM
+:by_numeric_code:
+  4: AF
+  8: AL
+  10: AQ
+  12: DZ
+  16: AS
+  20: AD
+  24: AO
+  28: AG
+  31: AZ
+  32: AR
+  36: AU
+  40: AT
+  44: BS
+  48: BH
+  50: BD
+  51: AM
+  52: BB
+  56: BE
+  60: BM
+  64: BT
+  68: BO
+  70: BA
+  72: BW
+  74: BV
+  76: BR
+  84: BZ
+  86: IO
+  90: SB
+  92: VG
+  96: BN
+  100: BG
+  104: MM
+  108: BI
+  112: BY
+  116: KH
+  120: CM
+  124: CA
+  132: CV
+  136: KY
+  140: CF
+  144: LK
+  148: TD
+  152: CL
+  156: CN
+  158: TW
+  162: CX
+  166: CC
+  170: CO
+  174: KM
+  175: YT
+  178: CG
+  180: CD
+  184: CK
+  188: CR
+  191: HR
+  192: CU
+  196: CY
+  203: CZ
+  204: BJ
+  208: DK
+  212: DM
+  214: DO
+  218: EC
+  222: SV
+  226: GQ
+  231: ET
+  232: ER
+  233: EE
+  234: FO
+  238: FK
+  239: GS
+  242: FJ
+  246: FI
+  248: AX
+  250: FR
+  254: GF
+  258: PF
+  260: TF
+  262: DJ
+  266: GA
+  268: GE
+  270: GM
+  275: PS
+  276: DE
+  288: GH
+  292: GI
+  296: KI
+  300: GR
+  304: GL
+  308: GD
+  312: GP
+  316: GU
+  320: GT
+  324: GN
+  328: GY
+  332: HT
+  334: HM
+  336: VA
+  340: HN
+  344: HK
+  348: HU
+  352: IS
+  356: IN
+  360: ID
+  364: IR
+  368: IQ
+  372: IE
+  376: IL
+  380: IT
+  384: CI
+  388: JM
+  392: JP
+  398: KZ
+  400: JO
+  404: KE
+  408: KP
+  410: KR
+  414: KW
+  417: KG
+  418: LA
+  422: LB
+  426: LS
+  428: LV
+  430: LR
+  434: LY
+  438: LI
+  440: LT
+  442: LU
+  446: MO
+  450: MG
+  454: MW
+  458: MY
+  462: MV
+  466: ML
+  470: MT
+  474: MQ
+  478: MR
+  480: MU
+  484: MX
+  492: MC
+  496: MN
+  498: MD
+  499: ME
+  500: MS
+  504: MA
+  508: MZ
+  512: OM
+  516: NA
+  520: NR
+  524: NP
+  528: NL
+  530: AN
+  531: CW
+  533: AW
+  534: SX
+  535: BQ
+  540: NC
+  548: VU
+  554: NZ
+  558: NI
+  562: NE
+  566: NG
+  570: NU
+  574: NF
+  578: 'NO'
+  580: MP
+  581: UM
+  583: FM
+  584: MH
+  585: PW
+  586: PK
+  591: PA
+  598: PG
+  600: PY
+  604: PE
+  608: PH
+  612: PN
+  616: PL
+  620: PT
+  624: GW
+  626: TL
+  630: PR
+  634: QA
+  638: RE
+  642: RO
+  643: RU
+  646: RW
+  652: BL
+  654: SH
+  659: KN
+  660: AI
+  662: LC
+  663: MF
+  666: PM
+  670: VC
+  674: SM
+  678: ST
+  682: SA
+  686: SN
+  688: RS
+  690: SC
+  694: SL
+  702: SG
+  703: SK
+  704: VN
+  705: SI
+  706: SO
+  710: ZA
+  716: ZW
+  724: ES
+  728: SS
+  732: EH
+  736: SD
+  740: SR
+  744: SJ
+  748: SZ
+  752: SE
+  756: CH
+  760: SY
+  762: TJ
+  764: TH
+  768: TG
+  772: TK
+  776: TO
+  780: TT
+  784: AE
+  788: TN
+  792: TR
+  795: TM
+  796: TC
+  798: TV
+  800: UG
+  804: UA
+  807: MK
+  818: EG
+  826: GB
+  831: GG
+  832: JE
+  833: IM
+  834: TZ
+  840: US
+  850: VI
+  854: BF
+  858: UY
+  860: UZ
+  862: VE
+  876: WF
+  882: WS
+  887: YE
+  894: ZM
+:continent_names:
+  AS: Asia
+  EU: Europe
+  AN: Antarctica
+  AF: Africa
+  OC: Oceania
+  NA: North America
+  SA: South America