carmen 0.2.13 → 1.0.0.beta1

data/CHANGELOG.md

@@ -1,10 +1,17 @@
+### 1.0.0pre
+* Complete rewrite. New data source and API. Extracting Rails view
+  helpers into seperate gem.
+
 ### 0.2.12
 * Republish the gem with Ruby 1.8.7.
+
 ### 0.2.11
 * Remove Jeweler and release new version.
+
 ### 0.2.10
 * Generate the gem with Ruby 1.8.7 to try to fix YAML library
   incompatibilities.
+
 ### 0.2.9
 * Preserve order of priority_countries in country_select (castiglione)
 * Add Finnish localization (marjakapyaho)

data/MIT-LICENSE

@@ -1,5 +1,18 @@
-Copyright (c) 2009 Jim Benton
-View helpers based on code (c) 2008 Michael Koziarski (http://github.com/rails/country_select/tree/master)
+Copyright (c) 2011 Jim Benton
+
+View helpers based on code (c) 2008 Michael Koziarski (http://github.com/rails/country_select)
+
+Contains data from the iso-codes Debian project, released under the LGPL:
+
+    Copyright (C) 2004-2006 Alastair McKinstry <mckinstry@computer.org>
+    Copyright (C) 2004, 2007 Christian Perrier <bubulle@debian.org>
+    Copyright (C) 2005-2007 Tobias Quathamer <toddy@debian.org>
+    Copyright (C) 2007, 2009 LI Daobing <lidaobing@gmail.com>
+    Copyright (C) 2007-2010 Alexis Darrasse <alexis@ortsa.com>
+
+    Source: <http://www.iso.org/iso/country_codes/background_on_iso_3166/iso_3166-2.htm>
+
+    More info: http://pkg-isocodes.alioth.debian.org/
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,176 @@
+# Carmen- A repository of geographic regions for Ruby
+
+[![Build Status](https://secure.travis-ci.org/jim/carmen.png?branch=master)](http://travis-ci.org/jim/carmen)
+
+Carmen 1.0 is a rewrite of the library, seperating out the geographic
+components from the Rails-specific view helpers. If you are using Carmen with
+Rails, you should check out the
+[carmen-rails](http://github.com/jim/carmen-rails) library.
+
+The [0.2.x branch](https://github.com/jim/carmen/tree/0.2.x) contains the previous
+version of Carmen should you need it for some reason.
+
+Carmen 1.0 features the following:
+
+* A new, cleaner API
+* Support for the old API via an optional require
+* More complete data via the iso-codes Debian package (idea borrowed from [here](https://github.com/pluginaweek/has_addresses))
+* A sane approach to internationalization
+
+# How to Use Carmen
+
+Carmen is designed to make it easy to access Country and region data.
+You can query for a country by name or code:
+
+    require 'carmen'
+    include Carmen
+
+    us = Country.named('United States')
+    => <#Carmen::Country name="United States">
+
+A Country object has some attributes that may be useful:
+
+    us.alpha_2_code
+    => 'US'
+
+    us.alpha_3_code
+    => 'USA'
+
+    us.code # alias for alpha_2_code
+    => 'US'
+
+    us.official_name
+    => "United States of America"
+
+A `Country` (and its subregions) can contain subregions. In the US these are states, but other countries have other types of regions:
+
+    us.subregions?
+    => true
+
+    us.subregions.first
+      => <#Carmen::Region name="Alabama" type="state">
+
+`Country#subregions` returns a `RegionCollection`, which can be queried
+similarly to a `Country` to find, for instance, a specific state:
+
+    illinois = us.subregions.coded('IL')
+    => <#Carmen::Region "Illinois">
+
+Subregions support a smaller set of attributes than countries:
+
+    illinois.name
+      => "Illinois"
+
+    illinois.code
+    => "IL"
+
+    illinois.type
+    => "state"
+
+Some subregions may contain additional subregions. An example of this is Spain:
+
+    spain = Country.named('Spain')
+    andalucia = spain.subregions.first
+    => <#Carmen::Region name="Andalucía" type="autonomous community">
+
+    andalucia.subregions?
+    => true
+
+    andalucia.subregions.first
+    => <#Carmen::Region name="Almería" type="province">
+
+## How Carmen organizes data
+
+In order to facilitate support for I18n, Carmen stores the structure of regions
+seperately from the strings that represent a region's names. The defualt data
+that ships with Carmen is in the iso_data and locale directories,
+respectively.
+
+## Overriding structural data
+
+You might want to tweak the data that Carmen provides for a variety of reasons.
+Carmen provides an `overlay_path` which can be set to point to a set of data that will be
+overlayed on top of the standard data. The structure of the files in this directory should mirror those in the data path that Carmen ships with.
+
+To adda new country to the system, you would create a directory (let's use `my_data` as an example), and create a `world.yml` file inside it. Then set Carmen to use the
+new overlay path:
+
+    Carmen.overlay_path = File.expand_path('../my_data', __FILE___)
+
+Elements within the data files are identified using their `code` values (or, in the case of countries, `alpha_2_code`). Create a new block for the country you wish to add inside `my_data/world.yml`:
+
+    ---
+    - alpha_2_code: ZZ
+      alpha_3_code: ZZZ
+      numeric_code: "999"
+      type: country
+
+Now, modify the fields you wish to change, and delete the others. Be sure to specify `alpha_2_code` for countries and `code` for subregions, as those values are used internally by Carmen to match your customized data with the corresponding data in the default dataset.
+
+Now, Carmen will reflect your personal view of the world:
+
+    Carmen::Country.coded('ZZ').type
+    => "country"
+
+You will also want to create a localization file with the names for the new
+region. See the section 'Customizing an existing locale', below.
+
+### Modifying existing elements
+
+Existing regions can be modified by copying their existing data block into
+a new file at the correct overlay path, and modifying the values as desired.
+
+### Disabling elements
+
+It is also possible to remove an element from the dataset by setting its `_enabled` value to [anything YAML considers false](http://yaml.org/type/bool.html), such as 'false' or 'no':
+
+    - alpha_2_code: EU
+	  _enabled: false
+
+This will cause Carmen to not return that element from any query:
+
+    Carmen::Country.coded('EU')
+    => nil
+
+## Localization
+
+Carmen ships with very simple I18n support. You can tell Carmen to use your own
+I18n backend:
+
+    Carmen.i18n_backend = YourI18nBackend.new
+
+The object used as a backend must respond to `t` with a single argument (the
+key being looked up). This key will look something like `en.world.us.il.name`.
+
+## Setting the locale
+
+If you use the built in I18n support, you can set the locale:
+
+    Carmen.i18n_backend.locale = :es
+
+Each region is assigned
+a localization key based on the formula world.PARENT\_CODE.CODE. The
+key used for the United States is `world.us`.
+
+## Customizing an existing locale
+
+The library ships with a set of YAML files that contain localizations of many
+country names (and some states). If you want to override any of these values,
+create a YAML file that contains a nested hash structure, where each segment of
+the key is a hash:
+
+    en:
+      world:
+        us:
+          official_name: These Crazy States
+
+This file can live anywhere, but it is recommended that it be stored in
+a structure similar to the one Carmen uses for its locale storage.
+
+To tell Carmen to load this file, add the directory it is contained in to the
+set of locale paths used by the backend:
+
+    Carmen.i18n_backend.append_locale_path('/path/to/your/locale/files')
+
+If you are using your own backend, then follow the steps necessary to have it
+load your additional files instead.

data/iso_data/world.yml

@@ -0,0 +1,997 @@
+---
+- alpha_2_code: AD
+  alpha_3_code: AND
+  numeric_code: '020'
+  type: country
+- alpha_2_code: AE
+  alpha_3_code: ARE
+  numeric_code: '784'
+  type: country
+- alpha_2_code: AF
+  alpha_3_code: AFG
+  numeric_code: '004'
+  type: country
+- alpha_2_code: AG
+  alpha_3_code: ATG
+  numeric_code: '028'
+  type: country
+- alpha_2_code: AI
+  alpha_3_code: AIA
+  numeric_code: '660'
+  type: country
+- alpha_2_code: AL
+  alpha_3_code: ALB
+  numeric_code: '008'
+  type: country
+- alpha_2_code: AM
+  alpha_3_code: ARM
+  numeric_code: '051'
+  type: country
+- alpha_2_code: AO
+  alpha_3_code: AGO
+  numeric_code: '024'
+  type: country
+- alpha_2_code: AQ
+  alpha_3_code: ATA
+  numeric_code: '010'
+  type: country
+- alpha_2_code: AR
+  alpha_3_code: ARG
+  numeric_code: '032'
+  type: country
+- alpha_2_code: AS
+  alpha_3_code: ASM
+  numeric_code: '016'
+  type: country
+- alpha_2_code: AT
+  alpha_3_code: AUT
+  numeric_code: '040'
+  type: country
+- alpha_2_code: AU
+  alpha_3_code: AUS
+  numeric_code: '036'
+  type: country
+- alpha_2_code: AW
+  alpha_3_code: ABW
+  numeric_code: '533'
+  type: country
+- alpha_2_code: AX
+  alpha_3_code: ALA
+  numeric_code: '248'
+  type: country
+- alpha_2_code: AZ
+  alpha_3_code: AZE
+  numeric_code: '031'
+  type: country
+- alpha_2_code: BA
+  alpha_3_code: BIH
+  numeric_code: '070'
+  type: country
+- alpha_2_code: BB
+  alpha_3_code: BRB
+  numeric_code: '052'
+  type: country
+- alpha_2_code: BD
+  alpha_3_code: BGD
+  numeric_code: '050'
+  type: country
+- alpha_2_code: BE
+  alpha_3_code: BEL
+  numeric_code: '056'
+  type: country
+- alpha_2_code: BF
+  alpha_3_code: BFA
+  numeric_code: '854'
+  type: country
+- alpha_2_code: BG
+  alpha_3_code: BGR
+  numeric_code: '100'
+  type: country
+- alpha_2_code: BH
+  alpha_3_code: BHR
+  numeric_code: '048'
+  type: country
+- alpha_2_code: BI
+  alpha_3_code: BDI
+  numeric_code: '108'
+  type: country
+- alpha_2_code: BJ
+  alpha_3_code: BEN
+  numeric_code: '204'
+  type: country
+- alpha_2_code: BL
+  alpha_3_code: BLM
+  numeric_code: '652'
+  type: country
+- alpha_2_code: BM
+  alpha_3_code: BMU
+  numeric_code: '060'
+  type: country
+- alpha_2_code: BN
+  alpha_3_code: BRN
+  numeric_code: '096'
+  type: country
+- alpha_2_code: BO
+  alpha_3_code: BOL
+  numeric_code: '068'
+  type: country
+- alpha_2_code: BQ
+  alpha_3_code: BES
+  numeric_code: '535'
+  type: country
+- alpha_2_code: BR
+  alpha_3_code: BRA
+  numeric_code: '076'
+  type: country
+- alpha_2_code: BS
+  alpha_3_code: BHS
+  numeric_code: '044'
+  type: country
+- alpha_2_code: BT
+  alpha_3_code: BTN
+  numeric_code: '064'
+  type: country
+- alpha_2_code: BV
+  alpha_3_code: BVT
+  numeric_code: '074'
+  type: country
+- alpha_2_code: BW
+  alpha_3_code: BWA
+  numeric_code: '072'
+  type: country
+- alpha_2_code: BY
+  alpha_3_code: BLR
+  numeric_code: '112'
+  type: country
+- alpha_2_code: BZ
+  alpha_3_code: BLZ
+  numeric_code: '084'
+  type: country
+- alpha_2_code: CA
+  alpha_3_code: CAN
+  numeric_code: '124'
+  type: country
+- alpha_2_code: CC
+  alpha_3_code: CCK
+  numeric_code: '166'
+  type: country
+- alpha_2_code: CD
+  alpha_3_code: COD
+  numeric_code: '180'
+  type: country
+- alpha_2_code: CF
+  alpha_3_code: CAF
+  numeric_code: '140'
+  type: country
+- alpha_2_code: CG
+  alpha_3_code: COG
+  numeric_code: '178'
+  type: country
+- alpha_2_code: CH
+  alpha_3_code: CHE
+  numeric_code: '756'
+  type: country
+- alpha_2_code: CI
+  alpha_3_code: CIV
+  numeric_code: '384'
+  type: country
+- alpha_2_code: CK
+  alpha_3_code: COK
+  numeric_code: '184'
+  type: country
+- alpha_2_code: CL
+  alpha_3_code: CHL
+  numeric_code: '152'
+  type: country
+- alpha_2_code: CM
+  alpha_3_code: CMR
+  numeric_code: '120'
+  type: country
+- alpha_2_code: CN
+  alpha_3_code: CHN
+  numeric_code: '156'
+  type: country
+- alpha_2_code: CO
+  alpha_3_code: COL
+  numeric_code: '170'
+  type: country
+- alpha_2_code: CR
+  alpha_3_code: CRI
+  numeric_code: '188'
+  type: country
+- alpha_2_code: CU
+  alpha_3_code: CUB
+  numeric_code: '192'
+  type: country
+- alpha_2_code: CV
+  alpha_3_code: CPV
+  numeric_code: '132'
+  type: country
+- alpha_2_code: CW
+  alpha_3_code: CUW
+  numeric_code: '531'
+  type: country
+- alpha_2_code: CX
+  alpha_3_code: CXR
+  numeric_code: '162'
+  type: country
+- alpha_2_code: CY
+  alpha_3_code: CYP
+  numeric_code: '196'
+  type: country
+- alpha_2_code: CZ
+  alpha_3_code: CZE
+  numeric_code: '203'
+  type: country
+- alpha_2_code: DE
+  alpha_3_code: DEU
+  numeric_code: '276'
+  type: country
+- alpha_2_code: DJ
+  alpha_3_code: DJI
+  numeric_code: '262'
+  type: country
+- alpha_2_code: DK
+  alpha_3_code: DNK
+  numeric_code: '208'
+  type: country
+- alpha_2_code: DM
+  alpha_3_code: DMA
+  numeric_code: '212'
+  type: country
+- alpha_2_code: DO
+  alpha_3_code: DOM
+  numeric_code: '214'
+  type: country
+- alpha_2_code: DZ
+  alpha_3_code: DZA
+  numeric_code: '012'
+  type: country
+- alpha_2_code: EC
+  alpha_3_code: ECU
+  numeric_code: '218'
+  type: country
+- alpha_2_code: EE
+  alpha_3_code: EST
+  numeric_code: '233'
+  type: country
+- alpha_2_code: EG
+  alpha_3_code: EGY
+  numeric_code: '818'
+  type: country
+- alpha_2_code: EH
+  alpha_3_code: ESH
+  numeric_code: '732'
+  type: country
+- alpha_2_code: ER
+  alpha_3_code: ERI
+  numeric_code: '232'
+  type: country
+- alpha_2_code: ES
+  alpha_3_code: ESP
+  numeric_code: '724'
+  type: country
+- alpha_2_code: ET
+  alpha_3_code: ETH
+  numeric_code: '231'
+  type: country
+- alpha_2_code: FI
+  alpha_3_code: FIN
+  numeric_code: '246'
+  type: country
+- alpha_2_code: FJ
+  alpha_3_code: FJI
+  numeric_code: '242'
+  type: country
+- alpha_2_code: FK
+  alpha_3_code: FLK
+  numeric_code: '238'
+  type: country
+- alpha_2_code: FM
+  alpha_3_code: FSM
+  numeric_code: '583'
+  type: country
+- alpha_2_code: FO
+  alpha_3_code: FRO
+  numeric_code: '234'
+  type: country
+- alpha_2_code: FR
+  alpha_3_code: FRA
+  numeric_code: '250'
+  type: country
+- alpha_2_code: GA
+  alpha_3_code: GAB
+  numeric_code: '266'
+  type: country
+- alpha_2_code: GB
+  alpha_3_code: GBR
+  numeric_code: '826'
+  type: country
+- alpha_2_code: GD
+  alpha_3_code: GRD
+  numeric_code: '308'
+  type: country
+- alpha_2_code: GE
+  alpha_3_code: GEO
+  numeric_code: '268'
+  type: country
+- alpha_2_code: GF
+  alpha_3_code: GUF
+  numeric_code: '254'
+  type: country
+- alpha_2_code: GG
+  alpha_3_code: GGY
+  numeric_code: '831'
+  type: country
+- alpha_2_code: GH
+  alpha_3_code: GHA
+  numeric_code: '288'
+  type: country
+- alpha_2_code: GI
+  alpha_3_code: GIB
+  numeric_code: '292'
+  type: country
+- alpha_2_code: GL
+  alpha_3_code: GRL
+  numeric_code: '304'
+  type: country
+- alpha_2_code: GM
+  alpha_3_code: GMB
+  numeric_code: '270'
+  type: country
+- alpha_2_code: GN
+  alpha_3_code: GIN
+  numeric_code: '324'
+  type: country
+- alpha_2_code: GP
+  alpha_3_code: GLP
+  numeric_code: '312'
+  type: country
+- alpha_2_code: GQ
+  alpha_3_code: GNQ
+  numeric_code: '226'
+  type: country
+- alpha_2_code: GR
+  alpha_3_code: GRC
+  numeric_code: '300'
+  type: country
+- alpha_2_code: GS
+  alpha_3_code: SGS
+  numeric_code: '239'
+  type: country
+- alpha_2_code: GT
+  alpha_3_code: GTM
+  numeric_code: '320'
+  type: country
+- alpha_2_code: GU
+  alpha_3_code: GUM
+  numeric_code: '316'
+  type: country
+- alpha_2_code: GW
+  alpha_3_code: GNB
+  numeric_code: '624'
+  type: country
+- alpha_2_code: GY
+  alpha_3_code: GUY
+  numeric_code: '328'
+  type: country
+- alpha_2_code: HK
+  alpha_3_code: HKG
+  numeric_code: '344'
+  type: country
+- alpha_2_code: HM
+  alpha_3_code: HMD
+  numeric_code: '334'
+  type: country
+- alpha_2_code: HN
+  alpha_3_code: HND
+  numeric_code: '340'
+  type: country
+- alpha_2_code: HR
+  alpha_3_code: HRV
+  numeric_code: '191'
+  type: country
+- alpha_2_code: HT
+  alpha_3_code: HTI
+  numeric_code: '332'
+  type: country
+- alpha_2_code: HU
+  alpha_3_code: HUN
+  numeric_code: '348'
+  type: country
+- alpha_2_code: ID
+  alpha_3_code: IDN
+  numeric_code: '360'
+  type: country
+- alpha_2_code: IE
+  alpha_3_code: IRL
+  numeric_code: '372'
+  type: country
+- alpha_2_code: IL
+  alpha_3_code: ISR
+  numeric_code: '376'
+  type: country
+- alpha_2_code: IM
+  alpha_3_code: IMN
+  numeric_code: '833'
+  type: country
+- alpha_2_code: IN
+  alpha_3_code: IND
+  numeric_code: '356'
+  type: country
+- alpha_2_code: IO
+  alpha_3_code: IOT
+  numeric_code: '086'
+  type: country
+- alpha_2_code: IQ
+  alpha_3_code: IRQ
+  numeric_code: '368'
+  type: country
+- alpha_2_code: IR
+  alpha_3_code: IRN
+  numeric_code: '364'
+  type: country
+- alpha_2_code: IS
+  alpha_3_code: ISL
+  numeric_code: '352'
+  type: country
+- alpha_2_code: IT
+  alpha_3_code: ITA
+  numeric_code: '380'
+  type: country
+- alpha_2_code: JE
+  alpha_3_code: JEY
+  numeric_code: '832'
+  type: country
+- alpha_2_code: JM
+  alpha_3_code: JAM
+  numeric_code: '388'
+  type: country
+- alpha_2_code: JO
+  alpha_3_code: JOR
+  numeric_code: '400'
+  type: country
+- alpha_2_code: JP
+  alpha_3_code: JPN
+  numeric_code: '392'
+  type: country
+- alpha_2_code: KE
+  alpha_3_code: KEN
+  numeric_code: '404'
+  type: country
+- alpha_2_code: KG
+  alpha_3_code: KGZ
+  numeric_code: '417'
+  type: country
+- alpha_2_code: KH
+  alpha_3_code: KHM
+  numeric_code: '116'
+  type: country
+- alpha_2_code: KI
+  alpha_3_code: KIR
+  numeric_code: '296'
+  type: country
+- alpha_2_code: KM
+  alpha_3_code: COM
+  numeric_code: '174'
+  type: country
+- alpha_2_code: KN
+  alpha_3_code: KNA
+  numeric_code: '659'
+  type: country
+- alpha_2_code: KP
+  alpha_3_code: PRK
+  numeric_code: '408'
+  type: country
+- alpha_2_code: KR
+  alpha_3_code: KOR
+  numeric_code: '410'
+  type: country
+- alpha_2_code: KW
+  alpha_3_code: KWT
+  numeric_code: '414'
+  type: country
+- alpha_2_code: KY
+  alpha_3_code: CYM
+  numeric_code: '136'
+  type: country
+- alpha_2_code: KZ
+  alpha_3_code: KAZ
+  numeric_code: '398'
+  type: country
+- alpha_2_code: LA
+  alpha_3_code: LAO
+  numeric_code: '418'
+  type: country
+- alpha_2_code: LB
+  alpha_3_code: LBN
+  numeric_code: '422'
+  type: country
+- alpha_2_code: LC
+  alpha_3_code: LCA
+  numeric_code: '662'
+  type: country
+- alpha_2_code: LI
+  alpha_3_code: LIE
+  numeric_code: '438'
+  type: country
+- alpha_2_code: LK
+  alpha_3_code: LKA
+  numeric_code: '144'
+  type: country
+- alpha_2_code: LR
+  alpha_3_code: LBR
+  numeric_code: '430'
+  type: country
+- alpha_2_code: LS
+  alpha_3_code: LSO
+  numeric_code: '426'
+  type: country
+- alpha_2_code: LT
+  alpha_3_code: LTU
+  numeric_code: '440'
+  type: country
+- alpha_2_code: LU
+  alpha_3_code: LUX
+  numeric_code: '442'
+  type: country
+- alpha_2_code: LV
+  alpha_3_code: LVA
+  numeric_code: '428'
+  type: country
+- alpha_2_code: LY
+  alpha_3_code: LBY
+  numeric_code: '434'
+  type: country
+- alpha_2_code: MA
+  alpha_3_code: MAR
+  numeric_code: '504'
+  type: country
+- alpha_2_code: MC
+  alpha_3_code: MCO
+  numeric_code: '492'
+  type: country
+- alpha_2_code: MD
+  alpha_3_code: MDA
+  numeric_code: '498'
+  type: country
+- alpha_2_code: ME
+  alpha_3_code: MNE
+  numeric_code: '499'
+  type: country
+- alpha_2_code: MF
+  alpha_3_code: MAF
+  numeric_code: '663'
+  type: country
+- alpha_2_code: MG
+  alpha_3_code: MDG
+  numeric_code: '450'
+  type: country
+- alpha_2_code: MH
+  alpha_3_code: MHL
+  numeric_code: '584'
+  type: country
+- alpha_2_code: MK
+  alpha_3_code: MKD
+  numeric_code: '807'
+  type: country
+- alpha_2_code: ML
+  alpha_3_code: MLI
+  numeric_code: '466'
+  type: country
+- alpha_2_code: MM
+  alpha_3_code: MMR
+  numeric_code: '104'
+  type: country
+- alpha_2_code: MN
+  alpha_3_code: MNG
+  numeric_code: '496'
+  type: country
+- alpha_2_code: MO
+  alpha_3_code: MAC
+  numeric_code: '446'
+  type: country
+- alpha_2_code: MP
+  alpha_3_code: MNP
+  numeric_code: '580'
+  type: country
+- alpha_2_code: MQ
+  alpha_3_code: MTQ
+  numeric_code: '474'
+  type: country
+- alpha_2_code: MR
+  alpha_3_code: MRT
+  numeric_code: '478'
+  type: country
+- alpha_2_code: MS
+  alpha_3_code: MSR
+  numeric_code: '500'
+  type: country
+- alpha_2_code: MT
+  alpha_3_code: MLT
+  numeric_code: '470'
+  type: country
+- alpha_2_code: MU
+  alpha_3_code: MUS
+  numeric_code: '480'
+  type: country
+- alpha_2_code: MV
+  alpha_3_code: MDV
+  numeric_code: '462'
+  type: country
+- alpha_2_code: MW
+  alpha_3_code: MWI
+  numeric_code: '454'
+  type: country
+- alpha_2_code: MX
+  alpha_3_code: MEX
+  numeric_code: '484'
+  type: country
+- alpha_2_code: MY
+  alpha_3_code: MYS
+  numeric_code: '458'
+  type: country
+- alpha_2_code: MZ
+  alpha_3_code: MOZ
+  numeric_code: '508'
+  type: country
+- alpha_2_code: NA
+  alpha_3_code: NAM
+  numeric_code: '516'
+  type: country
+- alpha_2_code: NC
+  alpha_3_code: NCL
+  numeric_code: '540'
+  type: country
+- alpha_2_code: NE
+  alpha_3_code: NER
+  numeric_code: '562'
+  type: country
+- alpha_2_code: NF
+  alpha_3_code: NFK
+  numeric_code: '574'
+  type: country
+- alpha_2_code: NG
+  alpha_3_code: NGA
+  numeric_code: '566'
+  type: country
+- alpha_2_code: NI
+  alpha_3_code: NIC
+  numeric_code: '558'
+  type: country
+- alpha_2_code: NL
+  alpha_3_code: NLD
+  numeric_code: '528'
+  type: country
+- alpha_2_code: 'NO'
+  alpha_3_code: NOR
+  numeric_code: '578'
+  type: country
+- alpha_2_code: NP
+  alpha_3_code: NPL
+  numeric_code: '524'
+  type: country
+- alpha_2_code: NR
+  alpha_3_code: NRU
+  numeric_code: '520'
+  type: country
+- alpha_2_code: NU
+  alpha_3_code: NIU
+  numeric_code: '570'
+  type: country
+- alpha_2_code: NZ
+  alpha_3_code: NZL
+  numeric_code: '554'
+  type: country
+- alpha_2_code: OM
+  alpha_3_code: OMN
+  numeric_code: '512'
+  type: country
+- alpha_2_code: PA
+  alpha_3_code: PAN
+  numeric_code: '591'
+  type: country
+- alpha_2_code: PE
+  alpha_3_code: PER
+  numeric_code: '604'
+  type: country
+- alpha_2_code: PF
+  alpha_3_code: PYF
+  numeric_code: '258'
+  type: country
+- alpha_2_code: PG
+  alpha_3_code: PNG
+  numeric_code: '598'
+  type: country
+- alpha_2_code: PH
+  alpha_3_code: PHL
+  numeric_code: '608'
+  type: country
+- alpha_2_code: PK
+  alpha_3_code: PAK
+  numeric_code: '586'
+  type: country
+- alpha_2_code: PL
+  alpha_3_code: POL
+  numeric_code: '616'
+  type: country
+- alpha_2_code: PM
+  alpha_3_code: SPM
+  numeric_code: '666'
+  type: country
+- alpha_2_code: PN
+  alpha_3_code: PCN
+  numeric_code: '612'
+  type: country
+- alpha_2_code: PR
+  alpha_3_code: PRI
+  numeric_code: '630'
+  type: country
+- alpha_2_code: PS
+  alpha_3_code: PSE
+  numeric_code: '275'
+  type: country
+- alpha_2_code: PT
+  alpha_3_code: PRT
+  numeric_code: '620'
+  type: country
+- alpha_2_code: PW
+  alpha_3_code: PLW
+  numeric_code: '585'
+  type: country
+- alpha_2_code: PY
+  alpha_3_code: PRY
+  numeric_code: '600'
+  type: country
+- alpha_2_code: QA
+  alpha_3_code: QAT
+  numeric_code: '634'
+  type: country
+- alpha_2_code: RE
+  alpha_3_code: REU
+  numeric_code: '638'
+  type: country
+- alpha_2_code: RO
+  alpha_3_code: ROU
+  numeric_code: '642'
+  type: country
+- alpha_2_code: RS
+  alpha_3_code: SRB
+  numeric_code: '688'
+  type: country
+- alpha_2_code: RU
+  alpha_3_code: RUS
+  numeric_code: '643'
+  type: country
+- alpha_2_code: RW
+  alpha_3_code: RWA
+  numeric_code: '646'
+  type: country
+- alpha_2_code: SA
+  alpha_3_code: SAU
+  numeric_code: '682'
+  type: country
+- alpha_2_code: SB
+  alpha_3_code: SLB
+  numeric_code: '090'
+  type: country
+- alpha_2_code: SC
+  alpha_3_code: SYC
+  numeric_code: '690'
+  type: country
+- alpha_2_code: SD
+  alpha_3_code: SDN
+  numeric_code: '729'
+  type: country
+- alpha_2_code: SE
+  alpha_3_code: SWE
+  numeric_code: '752'
+  type: country
+- alpha_2_code: SG
+  alpha_3_code: SGP
+  numeric_code: '702'
+  type: country
+- alpha_2_code: SH
+  alpha_3_code: SHN
+  numeric_code: '654'
+  type: country
+- alpha_2_code: SI
+  alpha_3_code: SVN
+  numeric_code: '705'
+  type: country
+- alpha_2_code: SJ
+  alpha_3_code: SJM
+  numeric_code: '744'
+  type: country
+- alpha_2_code: SK
+  alpha_3_code: SVK
+  numeric_code: '703'
+  type: country
+- alpha_2_code: SL
+  alpha_3_code: SLE
+  numeric_code: '694'
+  type: country
+- alpha_2_code: SM
+  alpha_3_code: SMR
+  numeric_code: '674'
+  type: country
+- alpha_2_code: SN
+  alpha_3_code: SEN
+  numeric_code: '686'
+  type: country
+- alpha_2_code: SO
+  alpha_3_code: SOM
+  numeric_code: '706'
+  type: country
+- alpha_2_code: SR
+  alpha_3_code: SUR
+  numeric_code: '740'
+  type: country
+- alpha_2_code: SS
+  alpha_3_code: SSD
+  numeric_code: '728'
+  type: country
+- alpha_2_code: ST
+  alpha_3_code: STP
+  numeric_code: '678'
+  type: country
+- alpha_2_code: SV
+  alpha_3_code: SLV
+  numeric_code: '222'
+  type: country
+- alpha_2_code: SX
+  alpha_3_code: SXM
+  numeric_code: '702'
+  type: country
+- alpha_2_code: SY
+  alpha_3_code: SYR
+  numeric_code: '760'
+  type: country
+- alpha_2_code: SZ
+  alpha_3_code: SWZ
+  numeric_code: '748'
+  type: country
+- alpha_2_code: TC
+  alpha_3_code: TCA
+  numeric_code: '796'
+  type: country
+- alpha_2_code: TD
+  alpha_3_code: TCD
+  numeric_code: '148'
+  type: country
+- alpha_2_code: TF
+  alpha_3_code: ATF
+  numeric_code: '260'
+  type: country
+- alpha_2_code: TG
+  alpha_3_code: TGO
+  numeric_code: '768'
+  type: country
+- alpha_2_code: TH
+  alpha_3_code: THA
+  numeric_code: '764'
+  type: country
+- alpha_2_code: TJ
+  alpha_3_code: TJK
+  numeric_code: '762'
+  type: country
+- alpha_2_code: TK
+  alpha_3_code: TKL
+  numeric_code: '772'
+  type: country
+- alpha_2_code: TL
+  alpha_3_code: TLS
+  numeric_code: '626'
+  type: country
+- alpha_2_code: TM
+  alpha_3_code: TKM
+  numeric_code: '795'
+  type: country
+- alpha_2_code: TN
+  alpha_3_code: TUN
+  numeric_code: '788'
+  type: country
+- alpha_2_code: TO
+  alpha_3_code: TON
+  numeric_code: '776'
+  type: country
+- alpha_2_code: TR
+  alpha_3_code: TUR
+  numeric_code: '792'
+  type: country
+- alpha_2_code: TT
+  alpha_3_code: TTO
+  numeric_code: '780'
+  type: country
+- alpha_2_code: TV
+  alpha_3_code: TUV
+  numeric_code: '798'
+  type: country
+- alpha_2_code: TW
+  alpha_3_code: TWN
+  numeric_code: '158'
+  type: country
+- alpha_2_code: TZ
+  alpha_3_code: TZA
+  numeric_code: '834'
+  type: country
+- alpha_2_code: UA
+  alpha_3_code: UKR
+  numeric_code: '804'
+  type: country
+- alpha_2_code: UG
+  alpha_3_code: UGA
+  numeric_code: '800'
+  type: country
+- alpha_2_code: UM
+  alpha_3_code: UMI
+  numeric_code: '581'
+  type: country
+- alpha_2_code: US
+  alpha_3_code: USA
+  numeric_code: '840'
+  type: country
+- alpha_2_code: UY
+  alpha_3_code: URY
+  numeric_code: '858'
+  type: country
+- alpha_2_code: UZ
+  alpha_3_code: UZB
+  numeric_code: '860'
+  type: country
+- alpha_2_code: VA
+  alpha_3_code: VAT
+  numeric_code: '336'
+  type: country
+- alpha_2_code: VC
+  alpha_3_code: VCT
+  numeric_code: '670'
+  type: country
+- alpha_2_code: VE
+  alpha_3_code: VEN
+  numeric_code: '862'
+  type: country
+- alpha_2_code: VG
+  alpha_3_code: VGB
+  numeric_code: '092'
+  type: country
+- alpha_2_code: VI
+  alpha_3_code: VIR
+  numeric_code: '850'
+  type: country
+- alpha_2_code: VN
+  alpha_3_code: VNM
+  numeric_code: '704'
+  type: country
+- alpha_2_code: VU
+  alpha_3_code: VUT
+  numeric_code: '548'
+  type: country
+- alpha_2_code: WF
+  alpha_3_code: WLF
+  numeric_code: '876'
+  type: country
+- alpha_2_code: WS
+  alpha_3_code: WSM
+  numeric_code: '882'
+  type: country
+- alpha_2_code: YE
+  alpha_3_code: YEM
+  numeric_code: '887'
+  type: country
+- alpha_2_code: YT
+  alpha_3_code: MYT
+  numeric_code: '175'
+  type: country
+- alpha_2_code: ZA
+  alpha_3_code: ZAF
+  numeric_code: '710'
+  type: country
+- alpha_2_code: ZM
+  alpha_3_code: ZMB
+  numeric_code: '894'
+  type: country
+- alpha_2_code: ZW
+  alpha_3_code: ZWE
+  numeric_code: '716'
+  type: country