calling-carmen 1.0.0.1

data/CHANGELOG.md

@@ -0,0 +1,75 @@
+###1.0.0
+* Updated version numbering and pushed 1.0.0pre to v1.0.0.
+* Merged in updates to German locations, via a patch from @leifg
+
+### 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)
+* Update a few contru names to match ISO naming (belt)
+* Fall back to default locale if selected locale is missing (twinge)
+* Added Russian country translations (grlm)
+* Added South Sudan as a country (edshadi)
+* Renamed Libyan Arab Jamahiriya to Libya (mdimas)
+* Fixed an issue where trying find a country for a blank string would
+  match everything (smathieu)
+* Added Italian country names (Arkham)
+* Add Polish, slovak and czech translations (Pajk)
+* Various corrections to country names (wolframarnold)
+* Add Chinese counties (liwh)
+* Add Dutch province names (ariejan)
+* Add Saint Barthelemy (BL) and Saint Martin (French Part) (MF) (nengxu)
+* Add Japanese countries localization (bonsaiben)
+* Prevent Carmen::state_name('NO','NO') from crashing (mhourahine)
+* Change "Taiwan, Province of China" to "Taiwan" (camilleroux)
+* Add spanish translation for countries (federomero)
+
+### 0.2.8
+* Use a shorter name for US Armed Forces States (cgs)
+* Added Gujarat to the list of states in India (swaroopch)
+* Added American Samoa to the list of US States
+* Added Dutch country translations (Arie)
+* Added Kosovo to German Translation (Christopher Thorpe)
+* Added the ability to list countries at the top of the list (jjthrash)
+* Added country names in Hindi (sukeerthiadiga)
+
+### 0.2.7
+* Fix a gemspec disaster.
+
+### 0.2.6 (pulled)
+* Suppress a deprecation warning in Rails 3 (anupamc)
+* Remove init.rb altogether and use requires under Rails
+* Added Indian states and union territories (orthodoc)
+
+### 0.2.5
+* Data corrections (mikepinde)
+
+### 0.2.4
+* Fixed autoloading under Rails 3
+
+### 0.2.2
+* Added state and country exclusion (kalafut)
+
+### 0.2.1
+* Added regions for New Zealand (yehezkielbs)
+
+### 0.2.0
+* Merge in Maximilian Schulz's locale fork, refactor internals to better support locales, and update documentation.
+* Remove Carmen::STATES and Carmen::COUNTRIES constants in favor of module instance variables and proper accessors.
+* Add a test_helper and remove dependency on RubyGems.
+
+### 0.1.3
+* DEPRECATE Carmen::COUNTRIES in favor of Carmen.countries

data/MIT-LICENSE

@@ -0,0 +1,34 @@
+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
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,179 @@
+# 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.0 is now out, after more than a year in beta.  This release is a rewrite of the library, separating 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 now requires Ruby 1.9.** The [ruby-18 branch](https://github.com/jim/carmen/tree/ruby-18) contains the
+last stable version of Carmen that will run on Ruby 1.8.x.
+
+Carmen 1.0 features the following:
+
+* A new, cleaner API
+* More complete data via the iso-codes Debian package (idea borrowed from [here](https://github.com/pluginaweek/has_addresses))
+* A sane approach to internationalization
+
+Changes in Calling-Carmen:
+
+* Added ISD (International Calling Code) for countries
+
+# 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
+separately from the strings that represent a region's names. The default 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
+maintains an array of paths to load data from in: `Carmen.data_paths`. The structure of
+files in each of these paths should mirror those in the `iso_data` path Carmen ships with.
+
+To add a 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 add the path to Carman:
+
+    Carmen.append_data_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/isd_data/world.yml

@@ -0,0 +1,748 @@
+---
+- alpha_2_code: AD
+  alpha_3_code: AND
+  calling_code: 376
+- alpha_2_code: AE
+  alpha_3_code: ARE
+  calling_code: 971
+- alpha_2_code: AF
+  alpha_3_code: AFG
+  calling_code: 93
+- alpha_2_code: AG
+  alpha_3_code: ATG
+  calling_code: 1 268
+- alpha_2_code: AI
+  alpha_3_code: AIA
+  calling_code: 1 264
+- alpha_2_code: AL
+  alpha_3_code: ALB
+  calling_code: 355
+- alpha_2_code: AM
+  alpha_3_code: ARM
+  calling_code: 374
+- alpha_2_code: AO
+  alpha_3_code: AGO
+  calling_code: 244
+- alpha_2_code: AQ
+  alpha_3_code: ATA
+  calling_code: 672
+- alpha_2_code: AR
+  alpha_3_code: ARG
+  calling_code: 54
+- alpha_2_code: AS
+  alpha_3_code: ASM
+  calling_code: 1 684
+- alpha_2_code: AT
+  alpha_3_code: AUT
+  calling_code: 43
+- alpha_2_code: AU
+  alpha_3_code: AUS
+  calling_code: 61
+- alpha_2_code: AW
+  alpha_3_code: ABW
+  calling_code: 297
+- alpha_2_code: AX
+  alpha_3_code: ALA
+  calling_code: 358 18
+- alpha_2_code: AZ
+  alpha_3_code: AZE
+  calling_code: 994
+- alpha_2_code: BA
+  alpha_3_code: BIH
+  calling_code: 387
+- alpha_2_code: BB
+  alpha_3_code: BRB
+  calling_code: 1 246
+- alpha_2_code: BD
+  alpha_3_code: BGD
+  calling_code: 880
+- alpha_2_code: BE
+  alpha_3_code: BEL
+  calling_code: 32
+- alpha_2_code: BF
+  alpha_3_code: BFA
+  calling_code: 226
+- alpha_2_code: BG
+  alpha_3_code: BGR
+  calling_code: 359
+- alpha_2_code: BH
+  alpha_3_code: BHR
+  calling_code: 973
+- alpha_2_code: BI
+  alpha_3_code: BDI
+  calling_code: 257
+- alpha_2_code: BJ
+  alpha_3_code: BEN
+  calling_code: 229
+- alpha_2_code: BL
+  alpha_3_code: BLM
+  calling_code: 590
+- alpha_2_code: BM
+  alpha_3_code: BMU
+  calling_code: 1 441
+- alpha_2_code: BN
+  alpha_3_code: BRN
+  calling_code: 673
+- alpha_2_code: BO
+  alpha_3_code: BOL
+  calling_code: 591
+- alpha_2_code: BQ
+  alpha_3_code: BES
+  calling_code: 599
+- alpha_2_code: BR
+  alpha_3_code: BRA
+  calling_code: 55
+- alpha_2_code: BS
+  alpha_3_code: BHS
+  calling_code: 1 242
+- alpha_2_code: BT
+  alpha_3_code: BTN
+  calling_code: 975
+- alpha_2_code: BV
+  alpha_3_code: BVT
+  calling_code: 47
+- alpha_2_code: BW
+  alpha_3_code: BWA
+  calling_code: 267
+- alpha_2_code: BY
+  alpha_3_code: BLR
+  calling_code: 375
+- alpha_2_code: BZ
+  alpha_3_code: BLZ
+  calling_code: 501
+- alpha_2_code: CA
+  alpha_3_code: CAN
+  calling_code: 1
+- alpha_2_code: CC
+  alpha_3_code: CCK
+  calling_code: 61
+- alpha_2_code: CD
+  alpha_3_code: COD
+  calling_code: 243
+- alpha_2_code: CF
+  alpha_3_code: CAF
+  calling_code: 236
+- alpha_2_code: CG
+  alpha_3_code: COG
+  calling_code: 242
+- alpha_2_code: CH
+  alpha_3_code: CHE
+  calling_code: 41
+- alpha_2_code: CI
+  alpha_3_code: CIV
+  calling_code: 225
+- alpha_2_code: CK
+  alpha_3_code: COK
+  calling_code: 682
+- alpha_2_code: CL
+  alpha_3_code: CHL
+  calling_code: 56
+- alpha_2_code: CM
+  alpha_3_code: CMR
+  calling_code: 237
+- alpha_2_code: CN
+  alpha_3_code: CHN
+  calling_code: 86
+- alpha_2_code: CO
+  alpha_3_code: COL
+  calling_code: 57
+- alpha_2_code: CR
+  alpha_3_code: CRI
+  calling_code: 506
+- alpha_2_code: CU
+  alpha_3_code: CUB
+  calling_code: 53
+- alpha_2_code: CV
+  alpha_3_code: CPV
+  calling_code: 238
+- alpha_2_code: CW
+  alpha_3_code: CUW
+  calling_code: 599 9
+- alpha_2_code: CX
+  alpha_3_code: CXR
+  calling_code: 61
+- alpha_2_code: CY
+  alpha_3_code: CYP
+  calling_code: 357
+- alpha_2_code: CZ
+  alpha_3_code: CZE
+  calling_code: 420
+- alpha_2_code: DE
+  alpha_3_code: DEU
+  calling_code: 49
+- alpha_2_code: DJ
+  alpha_3_code: DJI
+  calling_code: 253
+- alpha_2_code: DK
+  alpha_3_code: DNK
+  calling_code: 45
+- alpha_2_code: DM
+  alpha_3_code: DMA
+  calling_code: 1 767
+- alpha_2_code: DO
+  alpha_3_code: DOM
+  calling_code: 1 809
+- alpha_2_code: DZ
+  alpha_3_code: DZA
+  calling_code: 213
+- alpha_2_code: EC
+  alpha_3_code: ECU
+  calling_code: 593
+- alpha_2_code: EE
+  alpha_3_code: EST
+  calling_code: 372
+- alpha_2_code: EG
+  alpha_3_code: EGY
+  calling_code: 20
+- alpha_2_code: EH
+  alpha_3_code: ESH
+  calling_code: 212 5288 / 5289
+- alpha_2_code: ER
+  alpha_3_code: ERI
+  calling_code: 291
+- alpha_2_code: ES
+  alpha_3_code: ESP
+  calling_code: 34
+- alpha_2_code: ET
+  alpha_3_code: ETH
+  calling_code: 251
+- alpha_2_code: FI
+  alpha_3_code: FIN
+  calling_code: 358
+- alpha_2_code: FJ
+  alpha_3_code: FJI
+  calling_code: 679
+- alpha_2_code: FK
+  alpha_3_code: FLK
+  calling_code: 500
+- alpha_2_code: FM
+  alpha_3_code: FSM
+  calling_code: 691
+- alpha_2_code: FO
+  alpha_3_code: FRO
+  calling_code: 298
+- alpha_2_code: FR
+  alpha_3_code: FRA
+  calling_code: 33
+- alpha_2_code: GA
+  alpha_3_code: GAB
+  calling_code: 241
+- alpha_2_code: GB
+  alpha_3_code: GBR
+  calling_code: 44
+- alpha_2_code: GD
+  alpha_3_code: GRD
+  calling_code: 1 473
+- alpha_2_code: GE
+  alpha_3_code: GEO
+  calling_code: 995
+- alpha_2_code: GF
+  alpha_3_code: GUF
+  calling_code: 594
+- alpha_2_code: GG
+  alpha_3_code: GGY
+  calling_code: 44
+- alpha_2_code: GH
+  alpha_3_code: GHA
+  calling_code: 233
+- alpha_2_code: GI
+  alpha_3_code: GIB
+  calling_code: 350
+- alpha_2_code: GL
+  alpha_3_code: GRL
+  calling_code: 299
+- alpha_2_code: GM
+  alpha_3_code: GMB
+  calling_code: 220
+- alpha_2_code: GN
+  alpha_3_code: GIN
+  calling_code: 224
+- alpha_2_code: GP
+  alpha_3_code: GLP
+  calling_code: 502
+- alpha_2_code: GQ
+  alpha_3_code: GNQ
+  calling_code: 240
+- alpha_2_code: GR
+  alpha_3_code: GRC
+  calling_code: 30
+- alpha_2_code: GS
+  alpha_3_code: SGS
+  calling_code: 500
+- alpha_2_code: GT
+  alpha_3_code: GTM
+  calling_code: 502
+- alpha_2_code: GU
+  alpha_3_code: GUM
+  calling_code: 1 671
+- alpha_2_code: GW
+  alpha_3_code: GNB
+  calling_code: 245
+- alpha_2_code: GY
+  alpha_3_code: GUY
+  calling_code: 592
+- alpha_2_code: HK
+  alpha_3_code: HKG
+  calling_code: 852
+- alpha_2_code: HM
+  alpha_3_code: HMD
+  calling_code: 61
+- alpha_2_code: HN
+  alpha_3_code: HND
+  calling_code: 504
+- alpha_2_code: HR
+  alpha_3_code: HRV
+  calling_code: 385
+- alpha_2_code: HT
+  alpha_3_code: HTI
+  calling_code: 509
+- alpha_2_code: HU
+  alpha_3_code: HUN
+  calling_code: 36
+- alpha_2_code: ID
+  alpha_3_code: IDN
+  calling_code: 62
+- alpha_2_code: IE
+  alpha_3_code: IRL
+  calling_code: 353
+- alpha_2_code: IL
+  alpha_3_code: ISR
+  calling_code: 972
+- alpha_2_code: IM
+  alpha_3_code: IMN
+  calling_code: 44
+- alpha_2_code: IN
+  alpha_3_code: IND
+  calling_code: 91
+- alpha_2_code: IO
+  alpha_3_code: IOT
+  calling_code: 246
+- alpha_2_code: IQ
+  alpha_3_code: IRQ
+  calling_code: 964
+- alpha_2_code: IR
+  alpha_3_code: IRN
+  calling_code: 98
+- alpha_2_code: IS
+  alpha_3_code: ISL
+  calling_code: 354
+- alpha_2_code: IT
+  alpha_3_code: ITA
+  calling_code: 39
+- alpha_2_code: JE
+  alpha_3_code: JEY
+  calling_code: 44 1534
+- alpha_2_code: JM
+  alpha_3_code: JAM
+  calling_code: 1 876
+- alpha_2_code: JO
+  alpha_3_code: JOR
+  calling_code: 962
+- alpha_2_code: JP
+  alpha_3_code: JPN
+  calling_code: 81
+- alpha_2_code: KE
+  alpha_3_code: KEN
+  calling_code: 254
+- alpha_2_code: KG
+  alpha_3_code: KGZ
+  calling_code: 996
+- alpha_2_code: KH
+  alpha_3_code: KHM
+  calling_code: 855
+- alpha_2_code: KI
+  alpha_3_code: KIR
+  calling_code: 686
+- alpha_2_code: KM
+  alpha_3_code: COM
+  calling_code: 269
+- alpha_2_code: KN
+  alpha_3_code: KNA
+  calling_code: 1 869
+- alpha_2_code: KP
+  alpha_3_code: PRK
+  calling_code: 850
+- alpha_2_code: KR
+  alpha_3_code: KOR
+  calling_code: 82
+- alpha_2_code: KW
+  alpha_3_code: KWT
+  calling_code: 965
+- alpha_2_code: KY
+  alpha_3_code: CYM
+  calling_code: 1 345
+- alpha_2_code: KZ
+  alpha_3_code: KAZ
+  calling_code: 7
+- alpha_2_code: LA
+  alpha_3_code: LAO
+  calling_code: 856
+- alpha_2_code: LB
+  alpha_3_code: LBN
+  calling_code: 961
+- alpha_2_code: LC
+  alpha_3_code: LCA
+  calling_code: 1 758
+- alpha_2_code: LI
+  alpha_3_code: LIE
+  calling_code: 423
+- alpha_2_code: LK
+  alpha_3_code: LKA
+  calling_code: 94
+- alpha_2_code: LR
+  alpha_3_code: LBR
+  calling_code: 231
+- alpha_2_code: LS
+  alpha_3_code: LSO
+  calling_code: 266
+- alpha_2_code: LT
+  alpha_3_code: LTU
+  calling_code: 370
+- alpha_2_code: LU
+  alpha_3_code: LUX
+  calling_code: 352
+- alpha_2_code: LV
+  alpha_3_code: LVA
+  calling_code: 371
+- alpha_2_code: LY
+  alpha_3_code: LBY
+  calling_code: 218
+- alpha_2_code: MA
+  alpha_3_code: MAR
+  calling_code: 212
+- alpha_2_code: MC
+  alpha_3_code: MCO
+  calling_code: 377
+- alpha_2_code: MD
+  alpha_3_code: MDA
+  calling_code: 373
+- alpha_2_code: ME
+  alpha_3_code: MNE
+  calling_code: 382
+- alpha_2_code: MF
+  alpha_3_code: MAF
+  calling_code: 1 599
+- alpha_2_code: MG
+  alpha_3_code: MDG
+  calling_code: 261
+- alpha_2_code: MH
+  alpha_3_code: MHL
+  calling_code: 692
+- alpha_2_code: MK
+  alpha_3_code: MKD
+  calling_code: 389
+- alpha_2_code: ML
+  alpha_3_code: MLI
+  calling_code: 223
+- alpha_2_code: MM
+  alpha_3_code: MMR
+  calling_code: 95
+- alpha_2_code: MN
+  alpha_3_code: MNG
+  calling_code: 976
+- alpha_2_code: MO
+  alpha_3_code: MAC
+  calling_code: 853
+- alpha_2_code: MP
+  alpha_3_code: MNP
+  calling_code: 1 670
+- alpha_2_code: MQ
+  alpha_3_code: MTQ
+  calling_code: 596
+- alpha_2_code: MR
+  alpha_3_code: MRT
+  calling_code: 222
+- alpha_2_code: MS
+  alpha_3_code: MSR
+  calling_code: 1 664
+- alpha_2_code: MT
+  alpha_3_code: MLT
+  calling_code: 356
+- alpha_2_code: MU
+  alpha_3_code: MUS
+  calling_code: 230
+- alpha_2_code: MV
+  alpha_3_code: MDV
+  calling_code: 960
+- alpha_2_code: MW
+  alpha_3_code: MWI
+  calling_code: 265
+- alpha_2_code: MX
+  alpha_3_code: MEX
+  calling_code: 52
+- alpha_2_code: MY
+  alpha_3_code: MYS
+  calling_code: 60
+- alpha_2_code: MZ
+  alpha_3_code: MOZ
+  calling_code: 258
+- alpha_2_code: NA
+  alpha_3_code: NAM
+  calling_code: 264
+- alpha_2_code: NC
+  alpha_3_code: NCL
+  calling_code: 687
+- alpha_2_code: NE
+  alpha_3_code: NER
+  calling_code: 227
+- alpha_2_code: NF
+  alpha_3_code: NFK
+  calling_code: 672
+- alpha_2_code: NG
+  alpha_3_code: NGA
+  calling_code: 234
+- alpha_2_code: NI
+  alpha_3_code: NIC
+  calling_code: 505
+- alpha_2_code: NL
+  alpha_3_code: NLD
+  calling_code: 31
+- alpha_2_code: NO
+  alpha_3_code: NOR
+  calling_code: 47
+- alpha_2_code: NP
+  alpha_3_code: NPL
+  calling_code: 977
+- alpha_2_code: NR
+  alpha_3_code: NRU
+  calling_code: 674
+- alpha_2_code: NU
+  alpha_3_code: NIU
+  calling_code: 683
+- alpha_2_code: NZ
+  alpha_3_code: NZL
+  calling_code: 64
+- alpha_2_code: OM
+  alpha_3_code: OMN
+  calling_code: 968
+- alpha_2_code: PA
+  alpha_3_code: PAN
+  calling_code: 507
+- alpha_2_code: PE
+  alpha_3_code: PER
+  calling_code: 51
+- alpha_2_code: PF
+  alpha_3_code: PYF
+  calling_code: 689
+- alpha_2_code: PG
+  alpha_3_code: PNG
+  calling_code: 675
+- alpha_2_code: PH
+  alpha_3_code: PHL
+  calling_code: 63
+- alpha_2_code: PK
+  alpha_3_code: PAK
+  calling_code: 92
+- alpha_2_code: PL
+  alpha_3_code: POL
+  calling_code: 48
+- alpha_2_code: PM
+  alpha_3_code: SPM
+  calling_code: 508
+- alpha_2_code: PN
+  alpha_3_code: PCN
+  calling_code: 870
+- alpha_2_code: PR
+  alpha_3_code: PRI
+  calling_code: 1
+- alpha_2_code: PS
+  alpha_3_code: PSE
+  calling_code: 970
+- alpha_2_code: PT
+  alpha_3_code: PRT
+  calling_code: 351
+- alpha_2_code: PW
+  alpha_3_code: PLW
+  calling_code: 680
+- alpha_2_code: PY
+  alpha_3_code: PRY
+  calling_code: 595
+- alpha_2_code: QA
+  alpha_3_code: QAT
+  calling_code: 974
+- alpha_2_code: RE
+  alpha_3_code: REU
+  calling_code: 262
+- alpha_2_code: RO
+  alpha_3_code: ROU
+  calling_code: 40
+- alpha_2_code: RS
+  alpha_3_code: SRB
+  calling_code: 381
+- alpha_2_code: RU
+  alpha_3_code: RUS
+  calling_code: 7
+- alpha_2_code: RW
+  alpha_3_code: RWA
+  calling_code: 250
+- alpha_2_code: SA
+  alpha_3_code: SAU
+  calling_code: 966
+- alpha_2_code: SB
+  alpha_3_code: SLB
+  calling_code: 677
+- alpha_2_code: SC
+  alpha_3_code: SYC
+  calling_code: 248
+- alpha_2_code: SD
+  alpha_3_code: SDN
+  calling_code: 249
+- alpha_2_code: SE
+  alpha_3_code: SWE
+  calling_code: 46
+- alpha_2_code: SG
+  alpha_3_code: SGP
+  calling_code: 65
+- alpha_2_code: SH
+  alpha_3_code: SHN
+  calling_code: 290
+- alpha_2_code: SI
+  alpha_3_code: SVN
+  calling_code: 386
+- alpha_2_code: SJ
+  alpha_3_code: SJM
+  calling_code: 47 79
+- alpha_2_code: SK
+  alpha_3_code: SVK
+  calling_code: 421
+- alpha_2_code: SL
+  alpha_3_code: SLE
+  calling_code: 232
+- alpha_2_code: SM
+  alpha_3_code: SMR
+  calling_code: 378
+- alpha_2_code: SN
+  alpha_3_code: SEN
+  calling_code: 221
+- alpha_2_code: SO
+  alpha_3_code: SOM
+  calling_code: 252
+- alpha_2_code: SR
+  alpha_3_code: SUR
+  calling_code: 597
+- alpha_2_code: SS
+  alpha_3_code: SSD
+  calling_code: 211
+- alpha_2_code: ST
+  alpha_3_code: STP
+  calling_code: 239
+- alpha_2_code: SV
+  alpha_3_code: SLV
+  calling_code: 503
+- alpha_2_code: SX
+  alpha_3_code: SXM
+  calling_code: 1 721
+- alpha_2_code: SY
+  alpha_3_code: SYR
+  calling_code: 963
+- alpha_2_code: SZ
+  alpha_3_code: SWZ
+  calling_code: 268
+- alpha_2_code: TC
+  alpha_3_code: TCA
+  calling_code: 1 649
+- alpha_2_code: TD
+  alpha_3_code: TCD
+  calling_code: 235
+- alpha_2_code: TF
+  alpha_3_code: ATF
+  calling_code: 33
+- alpha_2_code: TG
+  alpha_3_code: TGO
+  calling_code: 228
+- alpha_2_code: TH
+  alpha_3_code: THA
+  calling_code: 66
+- alpha_2_code: TJ
+  alpha_3_code: TJK
+  calling_code: 992
+- alpha_2_code: TK
+  alpha_3_code: TKL
+  calling_code: 690
+- alpha_2_code: TL
+  alpha_3_code: TLS
+  calling_code: 670
+- alpha_2_code: TM
+  alpha_3_code: TKM
+  calling_code: 993
+- alpha_2_code: TN
+  alpha_3_code: TUN
+  calling_code: 216
+- alpha_2_code: TO
+  alpha_3_code: TON
+  calling_code: 676
+- alpha_2_code: TR
+  alpha_3_code: TUR
+  calling_code: 90
+- alpha_2_code: TT
+  alpha_3_code: TTO
+  calling_code: 1 868
+- alpha_2_code: TV
+  alpha_3_code: TUV
+  calling_code: 688
+- alpha_2_code: TW
+  alpha_3_code: TWN
+  calling_code: 886
+- alpha_2_code: TZ
+  alpha_3_code: TZA
+  calling_code: 255
+- alpha_2_code: UA
+  alpha_3_code: UKR
+  calling_code: 380
+- alpha_2_code: UG
+  alpha_3_code: UGA
+  calling_code: 256
+- alpha_2_code: UM
+  alpha_3_code: UMI
+  calling_code: 699
+- alpha_2_code: US
+  alpha_3_code: USA
+  calling_code: 1
+- alpha_2_code: UY
+  alpha_3_code: URY
+  calling_code: 598
+- alpha_2_code: UZ
+  alpha_3_code: UZB
+  calling_code: 998
+- alpha_2_code: VA
+  alpha_3_code: VAT
+  calling_code: 39
+- alpha_2_code: VC
+  alpha_3_code: VCT
+  calling_code: 1 784
+- alpha_2_code: VE
+  alpha_3_code: VEN
+  calling_code: 58
+- alpha_2_code: VG
+  alpha_3_code: VGB
+  calling_code: 1 284
+- alpha_2_code: VI
+  alpha_3_code: VIR
+  calling_code: 1 340
+- alpha_2_code: VN
+  alpha_3_code: VNM
+  calling_code: 84
+- alpha_2_code: VU
+  alpha_3_code: VUT
+  calling_code: 678
+- alpha_2_code: WF
+  alpha_3_code: WLF
+  calling_code: 681
+- alpha_2_code: WS
+  alpha_3_code: WSM
+  calling_code: 685
+- alpha_2_code: YE
+  alpha_3_code: YEM
+  calling_code: 967
+- alpha_2_code: YT
+  alpha_3_code: MYT
+  calling_code: 262
+- alpha_2_code: ZA
+  alpha_3_code: ZAF
+  calling_code: 27
+- alpha_2_code: ZM
+  alpha_3_code: ZMB
+  calling_code: 260
+- alpha_2_code: ZW
+  alpha_3_code: ZWE
+  calling_code: 263