address_geocoder 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7d28807cbcb73761882a1d8f7d136038f500cfc4
+  data.tar.gz: 0fa2b3eec737ca656ee84463d62dff46eaf55f18
+SHA512:
+  metadata.gz: f8f7d47c258d9e9e600dc5e330b3b5828d648cb428de525bd9eb2212cbfd8ae4179d1f1513c41c2ba497a03c03230e4ad75907ca3d445020c37f2e890a426071
+  data.tar.gz: 0bd932a2ee0a09b962caa1cafd974f23e5d4914d33c21f8fcc6a80243585e1671391cfb0be9db6024bff1894126df4aab1bfa70ce53970423142370513813915

data/.gitignore

@@ -0,0 +1,19 @@
+.DS_Store
+lib/.DS_Store
+.env
+/tmp/
+/Gemfile.lock
+/.bundle/
+
+# RSpec
+.rspec
+/log
+/tmp
+/pkg/
+/coverage/
+/spec/reports/
+
+# Yardoc
+/.yardoc
+/_yardoc/
+/doc

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 2.2.3
+before_install: gem install bundler -v 1.11.2
+script:
+  - 'bundle exec yard -n'
+  - 'bundle exec rspec --color --require spec_helper'

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting a project maintainer at ctlong.970@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. Maintainers are
+obligated to maintain confidentiality with regard to the reporter of an
+incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+
+group :development, :test do
+  gem 'bundler', '~> 1.11'
+  gem 'rake', '~> 10.0'
+  gem 'pry', '~> 0.10.3'
+  gem 'rspec', '~> 3.4.0'
+  gem 'yard'
+end
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Carson Long
+
+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.rdoc

@@ -0,0 +1,72 @@
+= AddressGeocoder
+
+{<img src="https://codeclimate.com/github/ctlong/address_geocoder/badges/gpa.svg" />}[https://codeclimate.com/github/ctlong/address_geocoder]
+{<img src="https://travis-ci.org/ctlong/address_geocoder.svg?branch=master" />}[https://travis-ci.org/ctlong/address_geocoder.svg?branch=master]
+
+<b>AddressGeocoder</b> is a Ruby interface to certain Maps APIs that allow you to validate and geocode addresses.
+
+Some APIs may require certain credentials to access.
+
+== Getting started
+
+AddressGeocoder was written and tested on Rails >= 4.2.5. You can install it by adding in to your Gemfile with:
+
+  gem 'address_geocoder'
+
+Run the bundle command to install it.
+
+== Basic usage
+
+Require the library:
+
+  require 'address_geocoder'
+
+Create a client:
+
+  client = MapsApi::Google::Client.new
+
+You can set some or all of the address information when or after creating the client (country names are {ISO 3166-1 Alpha-2}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] codes):
+
+  client = MapsApi::Google::Client.new(
+    country: 'Your country',
+    state: 'Your state',
+    city: 'Your city',
+    postal_code: 'Your postal code',
+    street: 'Your street',
+    language: 'The language to return your response in',
+    api_key: 'Your api key for an API'
+  )
+
+  client.street = 'A different street'
+
+Validating an address:
+
+  client.valid_address? # returns true or false
+
+Finding suggested addresses:
+
+  client.suggested_addresses # returns a list of addresses that most closely match your inputted addresss
+
+Additional methods:
+
+  client.response       # returns the marketplace's actual response
+  client.address        # returns the current user inputted address
+  client.former_address # returns the last address that was used in a call, nil if no call has been made.
+
+== The APIs
+
+=== Google
+
+Currently the only API we have integrated. All validations are done using {Google's Geocoding API}[https://developers.google.com/maps/documentation/geocoding/intro]. Although an {API key}[https://developers.google.com/maps/documentation/geocoding/get-api-key] is not required, it is recommended to track usage and upgrade your call limit if required. Google provides a maximum of 2,000 free calls per day to either your IP address or API key.
+
+== How it works
+
+<b>AddressGeocoder</b> sends addresses in varying formats to the Maps API of your choice. A positive response indicates that the address is valid. After a positive response the gem can parse returned elements to suggest a formatted address.
+
+== Development and tests
+
+We are open to suggestions and improvements. Just don't forget to write tests before the pull request.
+
+== Bug reporting
+
+If you discover a problem with our gem, please let us know about it: {ctlong/address_geocoder/issues}[https://github.com/ctlong/address_geocoder/issues]

data/Rakefile

@@ -0,0 +1,4 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+task default: :spec

data/address_geocoder.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'address_geocoder/version'
+
+Gem::Specification.new do |s|
+  s.name    = 'address_geocoder'
+  s.version = AddressGeocoder::VERSION
+  s.authors = ['Carson Long', 'Wing Leung Choi']
+  s.email   = ['ctlong.970@gmail.com', 'wingleungchoi@gmail.com']
+
+  s.summary     = 'Address validation and geocoding'
+  s.description = 'Calls and parses various maps APIs for accurate address validation and geocoding'
+  s.homepage    = 'https://github.com/ctlong/address_geocoder'
+  s.license     = 'MIT'
+  s.platform    = Gem::Platform::RUBY
+
+  s.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  s.bindir        = 'bin'
+  s.executables   = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  s.require_paths = ['lib']
+
+  s.post_install_message = 'Happy mapping!'
+
+  s.add_dependency 'httparty', '~> 0.13.7'
+end

data/bin/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'address_geocoder'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require 'irb'
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/countries.yaml

@@ -0,0 +1,1000 @@
+AD:
+  :country_name: Andorra
+  :alpha3: AND
+  :has_postal_code: true
+AE:
+  :country_name: United Arab Emirates
+  :alpha3: ARE
+  :has_postal_code: false
+AF:
+  :country_name: Afghanistan
+  :alpha3: AFG
+  :has_postal_code: true
+AG:
+  :country_name: Antigua and Barbuda
+  :alpha3: ATG
+  :has_postal_code: false
+AI:
+  :country_name: Anguilla
+  :alpha3: AIA
+  :has_postal_code: true
+AL:
+  :country_name: Albania
+  :alpha3: ALB
+  :has_postal_code: true
+AM:
+  :country_name: Armenia
+  :alpha3: ARM
+  :has_postal_code: true
+AO:
+  :country_name: Angola
+  :alpha3: AGO
+  :has_postal_code: false
+AQ:
+  :country_name: Antarctica
+  :alpha3: ATA
+  :has_postal_code: true
+AR:
+  :country_name: Argentina
+  :alpha3: ARG
+  :has_postal_code: true
+AS:
+  :country_name: American Samoa
+  :alpha3: ASM
+  :has_postal_code: true
+AT:
+  :country_name: Austria
+  :alpha3: AUT
+  :has_postal_code: true
+AU:
+  :country_name: Australia
+  :alpha3: AUS
+  :has_postal_code: true
+AW:
+  :country_name: Aruba
+  :alpha3: ABW
+  :has_postal_code: false
+AX:
+  :country_name: Åland
+  :alpha3: ALA
+  :has_postal_code: true
+AZ:
+  :country_name: Azerbaijan
+  :alpha3: AZE
+  :has_postal_code: true
+BA:
+  :country_name: Bosnia and Herzegovina
+  :alpha3: BIH
+  :has_postal_code: true
+BB:
+  :country_name: Barbados
+  :alpha3: BRB
+  :has_postal_code: true
+BD:
+  :country_name: Bangladesh
+  :alpha3: BGD
+  :has_postal_code: true
+BE:
+  :country_name: Belgium
+  :alpha3: BEL
+  :has_postal_code: true
+BF:
+  :country_name: Burkina Faso
+  :alpha3: BFA
+  :has_postal_code: false
+BG:
+  :country_name: Bulgaria
+  :alpha3: BGR
+  :has_postal_code: true
+BH:
+  :country_name: Bahrain
+  :alpha3: BHR
+  :has_postal_code: true
+BI:
+  :country_name: Burundi
+  :alpha3: BDI
+  :has_postal_code: false
+BJ:
+  :country_name: Benin
+  :alpha3: BEN
+  :has_postal_code: false
+BL:
+  :country_name: Saint Barthélemy
+  :alpha3: BLM
+  :has_postal_code: true
+BM:
+  :country_name: Bermuda
+  :alpha3: BMU
+  :has_postal_code: true
+BN:
+  :country_name: Brunei
+  :alpha3: BRN
+  :has_postal_code: true
+BO:
+  :country_name: Bolivia
+  :alpha3: BOL
+  :has_postal_code: true
+BQ:
+  :country_name: Bonaire
+  :alpha3: BES
+  :has_postal_code: true
+BR:
+  :country_name: Brazil
+  :alpha3: BRA
+  :has_postal_code: true
+BS:
+  :country_name: Bahamas
+  :alpha3: BHS
+  :has_postal_code: false
+BT:
+  :country_name: Bhutan
+  :alpha3: BTN
+  :has_postal_code: true
+BV:
+  :country_name: Bouvet Island
+  :alpha3: BVT
+  :has_postal_code: true
+BW:
+  :country_name: Botswana
+  :alpha3: BWA
+  :has_postal_code: false
+BY:
+  :country_name: Belarus
+  :alpha3: BLR
+  :has_postal_code: true
+BZ:
+  :country_name: Belize
+  :alpha3: BLZ
+  :has_postal_code: false
+CA:
+  :country_name: Canada
+  :alpha3: CAN
+  :has_postal_code: true
+CC:
+  :country_name: Cocos [Keeling] Islands
+  :alpha3: CCK
+  :has_postal_code: true
+CD:
+  :country_name: Democratic Republic of the Congo
+  :alpha3: COD
+  :has_postal_code: false
+CF:
+  :country_name: Central African Republic
+  :alpha3: CAF
+  :has_postal_code: false
+CG:
+  :country_name: Republic of the Congo
+  :alpha3: COG
+  :has_postal_code: false
+CH:
+  :country_name: Switzerland
+  :alpha3: CHE
+  :has_postal_code: true
+CI:
+  :country_name: Ivory Coast
+  :alpha3: CIV
+  :has_postal_code: false
+CK:
+  :country_name: Cook Islands
+  :alpha3: COK
+  :has_postal_code: false
+CL:
+  :country_name: Chile
+  :alpha3: CHL
+  :has_postal_code: true
+CM:
+  :country_name: Cameroon
+  :alpha3: CMR
+  :has_postal_code: false
+CN:
+  :country_name: China
+  :alpha3: CHN
+  :has_postal_code: true
+CO:
+  :country_name: Colombia
+  :alpha3: COL
+  :has_postal_code: true
+CR:
+  :country_name: Costa Rica
+  :alpha3: CRI
+  :has_postal_code: true
+CU:
+  :country_name: Cuba
+  :alpha3: CUB
+  :has_postal_code: true
+CV:
+  :country_name: Cape Verde
+  :alpha3: CPV
+  :has_postal_code: true
+CW:
+  :country_name: Curacao
+  :alpha3: CUW
+  :has_postal_code: true
+CX:
+  :country_name: Christmas Island
+  :alpha3: CXR
+  :has_postal_code: true
+CY:
+  :country_name: Cyprus
+  :alpha3: CYP
+  :has_postal_code: true
+CZ:
+  :country_name: Czech Republic
+  :alpha3: CZE
+  :has_postal_code: true
+DE:
+  :country_name: Germany
+  :alpha3: DEU
+  :has_postal_code: true
+DJ:
+  :country_name: Djibouti
+  :alpha3: DJI
+  :has_postal_code: false
+DK:
+  :country_name: Denmark
+  :alpha3: DNK
+  :has_postal_code: true
+DM:
+  :country_name: Dominica
+  :alpha3: DMA
+  :has_postal_code: false
+DO:
+  :country_name: Dominican Republic
+  :alpha3: DOM
+  :has_postal_code: true
+DZ:
+  :country_name: Algeria
+  :alpha3: DZA
+  :has_postal_code: true
+EC:
+  :country_name: Ecuador
+  :alpha3: ECU
+  :has_postal_code: true
+EE:
+  :country_name: Estonia
+  :alpha3: EST
+  :has_postal_code: true
+EG:
+  :country_name: Egypt
+  :alpha3: EGY
+  :has_postal_code: true
+EH:
+  :country_name: Western Sahara
+  :alpha3: ESH
+  :has_postal_code: true
+ER:
+  :country_name: Eritrea
+  :alpha3: ERI
+  :has_postal_code: false
+ES:
+  :country_name: Spain
+  :alpha3: ESP
+  :has_postal_code: true
+ET:
+  :country_name: Ethiopia
+  :alpha3: ETH
+  :has_postal_code: true
+FI:
+  :country_name: Finland
+  :alpha3: FIN
+  :has_postal_code: true
+FJ:
+  :country_name: Fiji
+  :alpha3: FJI
+  :has_postal_code: false
+FK:
+  :country_name: Falkland Islands
+  :alpha3: FLK
+  :has_postal_code: true
+FM:
+  :country_name: Micronesia
+  :alpha3: FSM
+  :has_postal_code: true
+FO:
+  :country_name: Faroe Islands
+  :alpha3: FRO
+  :has_postal_code: true
+FR:
+  :country_name: France
+  :alpha3: FRA
+  :has_postal_code: true
+GA:
+  :country_name: Gabon
+  :alpha3: GAB
+  :has_postal_code: true
+GB:
+  :country_name: United Kingdom
+  :alpha3: GBR
+  :has_postal_code: true
+GD:
+  :country_name: Grenada
+  :alpha3: GRD
+  :has_postal_code: false
+GE:
+  :country_name: Georgia
+  :alpha3: GEO
+  :has_postal_code: true
+GF:
+  :country_name: French Guiana
+  :alpha3: GUF
+  :has_postal_code: true
+GG:
+  :country_name: Guernsey
+  :alpha3: GGY
+  :has_postal_code: true
+GH:
+  :country_name: Ghana
+  :alpha3: GHA
+  :has_postal_code: false
+GI:
+  :country_name: Gibraltar
+  :alpha3: GIB
+  :has_postal_code: true
+GL:
+  :country_name: Greenland
+  :alpha3: GRL
+  :has_postal_code: true
+GM:
+  :country_name: Gambia
+  :alpha3: GMB
+  :has_postal_code: false
+GN:
+  :country_name: Guinea
+  :alpha3: GIN
+  :has_postal_code: false
+GP:
+  :country_name: Guadeloupe
+  :alpha3: GLP
+  :has_postal_code: true
+GQ:
+  :country_name: Equatorial Guinea
+  :alpha3: GNQ
+  :has_postal_code: false
+GR:
+  :country_name: Greece
+  :alpha3: GRC
+  :has_postal_code: true
+GS:
+  :country_name: South Georgia and the South Sandwich Islands
+  :alpha3: SGS
+  :has_postal_code: true
+GT:
+  :country_name: Guatemala
+  :alpha3: GTM
+  :has_postal_code: true
+GU:
+  :country_name: Guam
+  :alpha3: GUM
+  :has_postal_code: true
+GW:
+  :country_name: Guinea-Bissau
+  :alpha3: GNB
+  :has_postal_code: true
+GY:
+  :country_name: Guyana
+  :alpha3: GUY
+  :has_postal_code: false
+HK:
+  :country_name: Hong Kong
+  :alpha3: HKG
+  :has_postal_code: false
+HM:
+  :country_name: Heard Island and McDonald Islands
+  :alpha3: HMD
+  :has_postal_code: true
+HN:
+  :country_name: Honduras
+  :alpha3: HND
+  :has_postal_code: true
+HR:
+  :country_name: Croatia
+  :alpha3: HRV
+  :has_postal_code: true
+HT:
+  :country_name: Haiti
+  :alpha3: HTI
+  :has_postal_code: true
+HU:
+  :country_name: Hungary
+  :alpha3: HUN
+  :has_postal_code: true
+ID:
+  :country_name: Indonesia
+  :alpha3: IDN
+  :has_postal_code: true
+IE:
+  :country_name: Ireland
+  :alpha3: IRL
+  :has_postal_code: false
+IL:
+  :country_name: Israel
+  :alpha3: ISR
+  :has_postal_code: true
+IM:
+  :country_name: Isle of Man
+  :alpha3: IMN
+  :has_postal_code: true
+IN:
+  :country_name: India
+  :alpha3: IND
+  :has_postal_code: true
+IO:
+  :country_name: British Indian Ocean Territory
+  :alpha3: IOT
+  :has_postal_code: true
+IQ:
+  :country_name: Iraq
+  :alpha3: IRQ
+  :has_postal_code: true
+IR:
+  :country_name: Iran
+  :alpha3: IRN
+  :has_postal_code: true
+IS:
+  :country_name: Iceland
+  :alpha3: ISL
+  :has_postal_code: true
+IT:
+  :country_name: Italy
+  :alpha3: ITA
+  :has_postal_code: true
+JE:
+  :country_name: Jersey
+  :alpha3: JEY
+  :has_postal_code: true
+JM:
+  :country_name: Jamaica
+  :alpha3: JAM
+  :has_postal_code: false
+JO:
+  :country_name: Jordan
+  :alpha3: JOR
+  :has_postal_code: true
+JP:
+  :country_name: Japan
+  :alpha3: JPN
+  :has_postal_code: true
+KE:
+  :country_name: Kenya
+  :alpha3: KEN
+  :has_postal_code: false
+KG:
+  :country_name: Kyrgyzstan
+  :alpha3: KGZ
+  :has_postal_code: true
+KH:
+  :country_name: Cambodia
+  :alpha3: KHM
+  :has_postal_code: true
+KI:
+  :country_name: Kiribati
+  :alpha3: KIR
+  :has_postal_code: false
+KM:
+  :country_name: Comoros
+  :alpha3: COM
+  :has_postal_code: false
+KN:
+  :country_name: Saint Kitts and Nevis
+  :alpha3: KNA
+  :has_postal_code: false
+KP:
+  :country_name: North Korea
+  :alpha3: PRK
+  :has_postal_code: false
+KR:
+  :country_name: South Korea
+  :alpha3: KOR
+  :has_postal_code: true
+KW:
+  :country_name: Kuwait
+  :alpha3: KWT
+  :has_postal_code: true
+KY:
+  :country_name: Cayman Islands
+  :alpha3: CYM
+  :has_postal_code: true
+KZ:
+  :country_name: Kazakhstan
+  :alpha3: KAZ
+  :has_postal_code: true
+LA:
+  :country_name: Laos
+  :alpha3: LAO
+  :has_postal_code: true
+LB:
+  :country_name: Lebanon
+  :alpha3: LBN
+  :has_postal_code: true
+LC:
+  :country_name: Saint Lucia
+  :alpha3: LCA
+  :has_postal_code: false
+LI:
+  :country_name: Liechtenstein
+  :alpha3: LIE
+  :has_postal_code: true
+LK:
+  :country_name: Sri Lanka
+  :alpha3: LKA
+  :has_postal_code: true
+LR:
+  :country_name: Liberia
+  :alpha3: LBR
+  :has_postal_code: true
+LS:
+  :country_name: Lesotho
+  :alpha3: LSO
+  :has_postal_code: true
+LT:
+  :country_name: Lithuania
+  :alpha3: LTU
+  :has_postal_code: true
+LU:
+  :country_name: Luxembourg
+  :alpha3: LUX
+  :has_postal_code: true
+LV:
+  :country_name: Latvia
+  :alpha3: LVA
+  :has_postal_code: true
+LY:
+  :country_name: Libya
+  :alpha3: LBY
+  :has_postal_code: true
+MA:
+  :country_name: Morocco
+  :alpha3: MAR
+  :has_postal_code: true
+MC:
+  :country_name: Monaco
+  :alpha3: MCO
+  :has_postal_code: true
+MD:
+  :country_name: Moldova
+  :alpha3: MDA
+  :has_postal_code: true
+ME:
+  :country_name: Montenegro
+  :alpha3: MNE
+  :has_postal_code: true
+MF:
+  :country_name: Saint Martin
+  :alpha3: MAF
+  :has_postal_code: true
+MG:
+  :country_name: Madagascar
+  :alpha3: MDG
+  :has_postal_code: true
+MH:
+  :country_name: Marshall Islands
+  :alpha3: MHL
+  :has_postal_code: true
+MK:
+  :country_name: Macedonia
+  :alpha3: MKD
+  :has_postal_code: true
+ML:
+  :country_name: Mali
+  :alpha3: MLI
+  :has_postal_code: false
+MM:
+  :country_name: Myanmar [Burma]
+  :alpha3: MMR
+  :has_postal_code: true
+MN:
+  :country_name: Mongolia
+  :alpha3: MNG
+  :has_postal_code: true
+MO:
+  :country_name: Macao
+  :alpha3: MAC
+  :has_postal_code: false
+MP:
+  :country_name: Northern Mariana Islands
+  :alpha3: MNP
+  :has_postal_code: true
+MQ:
+  :country_name: Martinique
+  :alpha3: MTQ
+  :has_postal_code: true
+MR:
+  :country_name: Mauritania
+  :alpha3: MRT
+  :has_postal_code: false
+MS:
+  :country_name: Montserrat
+  :alpha3: MSR
+  :has_postal_code: false
+MT:
+  :country_name: Malta
+  :alpha3: MLT
+  :has_postal_code: true
+MU:
+  :country_name: Mauritius
+  :alpha3: MUS
+  :has_postal_code: false
+MV:
+  :country_name: Maldives
+  :alpha3: MDV
+  :has_postal_code: true
+MW:
+  :country_name: Malawi
+  :alpha3: MWI
+  :has_postal_code: false
+MX:
+  :country_name: Mexico
+  :alpha3: MEX
+  :has_postal_code: true
+MY:
+  :country_name: Malaysia
+  :alpha3: MYS
+  :has_postal_code: true
+MZ:
+  :country_name: Mozambique
+  :alpha3: MOZ
+  :has_postal_code: true
+NA:
+  :country_name: Namibia
+  :alpha3: NAM
+  :has_postal_code: true
+NC:
+  :country_name: New Caledonia
+  :alpha3: NCL
+  :has_postal_code: true
+NE:
+  :country_name: Niger
+  :alpha3: NER
+  :has_postal_code: true
+NF:
+  :country_name: Norfolk Island
+  :alpha3: NFK
+  :has_postal_code: true
+NG:
+  :country_name: Nigeria
+  :alpha3: NGA
+  :has_postal_code: true
+NI:
+  :country_name: Nicaragua
+  :alpha3: NIC
+  :has_postal_code: true
+NL:
+  :country_name: Netherlands
+  :alpha3: NLD
+  :has_postal_code: true
+NO:
+  :country_name: Norway
+  :alpha3: NOR
+  :has_postal_code: true
+NP:
+  :country_name: Nepal
+  :alpha3: NPL
+  :has_postal_code: true
+NR:
+  :country_name: Nauru
+  :alpha3: NRU
+  :has_postal_code: false
+NU:
+  :country_name: Niue
+  :alpha3: NIU
+  :has_postal_code: false
+NZ:
+  :country_name: New Zealand
+  :alpha3: NZL
+  :has_postal_code: true
+OM:
+  :country_name: Oman
+  :alpha3: OMN
+  :has_postal_code: true
+PA:
+  :country_name: Panama
+  :alpha3: PAN
+  :has_postal_code: false
+PE:
+  :country_name: Peru
+  :alpha3: PER
+  :has_postal_code: true
+PF:
+  :country_name: French Polynesia
+  :alpha3: PYF
+  :has_postal_code: true
+PG:
+  :country_name: Papua New Guinea
+  :alpha3: PNG
+  :has_postal_code: true
+PH:
+  :country_name: Philippines
+  :alpha3: PHL
+  :has_postal_code: true
+PK:
+  :country_name: Pakistan
+  :alpha3: PAK
+  :has_postal_code: true
+PL:
+  :country_name: Poland
+  :alpha3: POL
+  :has_postal_code: true
+PM:
+  :country_name: Saint Pierre and Miquelon
+  :alpha3: SPM
+  :has_postal_code: true
+PN:
+  :country_name: Pitcairn Islands
+  :alpha3: PCN
+  :has_postal_code: true
+PR:
+  :country_name: Puerto Rico
+  :alpha3: PRI
+  :has_postal_code: true
+PS:
+  :country_name: Palestine
+  :alpha3: PSE
+  :has_postal_code: true
+PT:
+  :country_name: Portugal
+  :alpha3: PRT
+  :has_postal_code: true
+PW:
+  :country_name: Palau
+  :alpha3: PLW
+  :has_postal_code: true
+PY:
+  :country_name: Paraguay
+  :alpha3: PRY
+  :has_postal_code: true
+QA:
+  :country_name: Qatar
+  :alpha3: QAT
+  :has_postal_code: false
+RE:
+  :country_name: Réunion
+  :alpha3: REU
+  :has_postal_code: true
+RO:
+  :country_name: Romania
+  :alpha3: ROU
+  :has_postal_code: true
+RS:
+  :country_name: Serbia
+  :alpha3: SRB
+  :has_postal_code: true
+RU:
+  :country_name: Russia
+  :alpha3: RUS
+  :has_postal_code: true
+RW:
+  :country_name: Rwanda
+  :alpha3: RWA
+  :has_postal_code: false
+SA:
+  :country_name: Saudi Arabia
+  :alpha3: SAU
+  :has_postal_code: false
+SB:
+  :country_name: Solomon Islands
+  :alpha3: SLB
+  :has_postal_code: false
+SC:
+  :country_name: Seychelles
+  :alpha3: SYC
+  :has_postal_code: false
+SD:
+  :country_name: Sudan
+  :alpha3: SDN
+  :has_postal_code: true
+SE:
+  :country_name: Sweden
+  :alpha3: SWE
+  :has_postal_code: true
+SG:
+  :country_name: Singapore
+  :alpha3: SGP
+  :has_postal_code: true
+SH:
+  :country_name: Saint Helena
+  :alpha3: SHN
+  :has_postal_code: true
+SI:
+  :country_name: Slovenia
+  :alpha3: SVN
+  :has_postal_code: true
+SJ:
+  :country_name: Svalbard and Jan Mayen
+  :alpha3: SJM
+  :has_postal_code: true
+SK:
+  :country_name: Slovakia
+  :alpha3: SVK
+  :has_postal_code: true
+SL:
+  :country_name: Sierra Leone
+  :alpha3: SLE
+  :has_postal_code: false
+SM:
+  :country_name: San Marino
+  :alpha3: SMR
+  :has_postal_code: true
+SN:
+  :country_name: Senegal
+  :alpha3: SEN
+  :has_postal_code: true
+SO:
+  :country_name: Somalia
+  :alpha3: SOM
+  :has_postal_code: false
+SR:
+  :country_name: Suriname
+  :alpha3: SUR
+  :has_postal_code: false
+SS:
+  :country_name: South Sudan
+  :alpha3: SSD
+  :has_postal_code: true
+ST:
+  :country_name: São Tomé and Príncipe
+  :alpha3: STP
+  :has_postal_code: false
+SV:
+  :country_name: El Salvador
+  :alpha3: SLV
+  :has_postal_code: true
+SX:
+  :country_name: Sint Maarten
+  :alpha3: SXM
+  :has_postal_code: true
+SY:
+  :country_name: Syria
+  :alpha3: SYR
+  :has_postal_code: false
+SZ:
+  :country_name: Swaziland
+  :alpha3: SWZ
+  :has_postal_code: true
+TC:
+  :country_name: Turks and Caicos Islands
+  :alpha3: TCA
+  :has_postal_code: true
+TD:
+  :country_name: Chad
+  :alpha3: TCD
+  :has_postal_code: true
+TF:
+  :country_name: French Southern Territories
+  :alpha3: ATF
+  :has_postal_code: false
+TG:
+  :country_name: Togo
+  :alpha3: TGO
+  :has_postal_code: true
+TH:
+  :country_name: Thailand
+  :alpha3: THA
+  :has_postal_code: true
+TJ:
+  :country_name: Tajikistan
+  :alpha3: TJK
+  :has_postal_code: true
+TK:
+  :country_name: Tokelau
+  :alpha3: TKL
+  :has_postal_code: false
+TL:
+  :country_name: East Timor
+  :alpha3: TLS
+  :has_postal_code: false
+TM:
+  :country_name: Turkmenistan
+  :alpha3: TKM
+  :has_postal_code: true
+TN:
+  :country_name: Tunisia
+  :alpha3: TUN
+  :has_postal_code: true
+TO:
+  :country_name: Tonga
+  :alpha3: TON
+  :has_postal_code: false
+TR:
+  :country_name: Turkey
+  :alpha3: TUR
+  :has_postal_code: true
+TT:
+  :country_name: Trinidad and Tobago
+  :alpha3: TTO
+  :has_postal_code: false
+TV:
+  :country_name: Tuvalu
+  :alpha3: TUV
+  :has_postal_code: true
+TW:
+  :country_name: Taiwan
+  :alpha3: TWN
+  :has_postal_code: true
+TZ:
+  :country_name: Tanzania
+  :alpha3: TZA
+  :has_postal_code: false
+UA:
+  :country_name: Ukraine
+  :alpha3: UKR
+  :has_postal_code: true
+UG:
+  :country_name: Uganda
+  :alpha3: UGA
+  :has_postal_code: false
+UM:
+  :country_name: U.S. Minor Outlying Islands
+  :alpha3: UMI
+  :has_postal_code: true
+US:
+  :country_name: United States
+  :alpha3: USA
+  :has_postal_code: true
+UY:
+  :country_name: Uruguay
+  :alpha3: URY
+  :has_postal_code: true
+UZ:
+  :country_name: Uzbekistan
+  :alpha3: UZB
+  :has_postal_code: true
+VA:
+  :country_name: Vatican City
+  :alpha3: VAT
+  :has_postal_code: true
+VC:
+  :country_name: Saint Vincent and the Grenadines
+  :alpha3: VCT
+  :has_postal_code: true
+VE:
+  :country_name: Venezuela
+  :alpha3: VEN
+  :has_postal_code: true
+VG:
+  :country_name: British Virgin Islands
+  :alpha3: VGB
+  :has_postal_code: true
+VI:
+  :country_name: U.S. Virgin Islands
+  :alpha3: VIR
+  :has_postal_code: true
+VN:
+  :country_name: Vietnam
+  :alpha3: VNM
+  :has_postal_code: true
+VU:
+  :country_name: Vanuatu
+  :alpha3: VUT
+  :has_postal_code: false
+WF:
+  :country_name: Wallis and Futuna
+  :alpha3: WLF
+  :has_postal_code: true
+WS:
+  :country_name: Samoa
+  :alpha3: WSM
+  :has_postal_code: true
+XK:
+  :country_name: Kosovo
+  :alpha3: XKX
+  :has_postal_code: true
+YE:
+  :country_name: Yemen
+  :alpha3: YEM
+  :has_postal_code: false
+YT:
+  :country_name: Mayotte
+  :alpha3: MYT
+  :has_postal_code: true
+ZA:
+  :country_name: South Africa
+  :alpha3: ZAF
+  :has_postal_code: false
+ZM:
+  :country_name: Zambia
+  :alpha3: ZMB
+  :has_postal_code: true
+ZW:
+  :country_name: Zimbabwe
+  :alpha3: ZWE
+  :has_postal_code: false