addressing 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f0bf8936e1edf97987fbcca8e6b47a9ca45e07fa8c2e3a120360cd6730c422a7
+  data.tar.gz: 9b7aa33a67b425cf514d8c182bdc0583de2a9ade137afcb6d682c641d50612bb
+SHA512:
+  metadata.gz: 4e8efd58bed3c59c920f66a4f144196338214d9f91a7af7185147f459752686c831f2a947326d1bedc8fd1b368af2f7b3984eaed038c5a17113986122c64682e
+  data.tar.gz: f597210f7076721c355b99782c0fe445fad1c370db22df59d8af1143329568b0167f31f4e78d879c36e7ba699335cf9caa5e222e85eb799141ed74952b465256

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+All notable changes to `addressing` will be documented in this file.
+
+## 0.1.0 (UNRELEASED)
+
+- Initial release

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Robin van der Vleuten <robinvdvleuten@gmail.com>
+
+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,207 @@
+# Addressing
+
+A Ruby addressing library, powered by CLDR and Google's address data.
+
+- Countries, with translations for over 250 locales
+- Address formats for over 200 countries
+- Subdivisions (administrative areas, localities, dependent localities) for 44 countries
+- Both latin and local subdivision names, when relevant (e.g: Okinawa / 沖縄県)
+- Formatting, both in HTML and plain text
+
+All data is [stored locally](data) as JSON and automatically updated through scheduled Github Actions. Countries are generated from [CLDR v40](https://github.com/unicode-org/cldr-json.git). Address formats and subdivisions are generated from [Google's Address Data Service](https://chromium-i18n.appspot.com/ssl-address).
+
+[![Build Status](https://img.shields.io/github/workflow/status/robinvdvleuten/addressing/test.svg)](https://github.com/robinvdvleuten/addressing/actions?query=workflow%3Atest)
+[![MIT license](https://img.shields.io/github/license/robinvdvleuten/addressing.svg)](https://github.com/robinvdvleuten/addressing/blob/main/LICENSE)
+
+## Installation
+
+Add this line to your application’s Gemfile:
+
+```rb
+gem "addressing"
+```
+
+## Getting Started
+
+The [Address](lib/addressing/address.rb) class represents a postal adddress, with attributes for the following fields:
+
+- Country code
+- Administrative area
+- Locality (City)
+- Dependent Locality
+- Postal code
+- Sorting code
+- Address line 1
+- Address line 2
+- Organization
+- Given name (First name)
+- Additional name (Middle name / Patronymic)
+- Family name (Last name)
+
+Field names follow the OASIS [eXtensible Address Language (xAL)](http://www.oasis-open.org/committees/ciq/download.shtml) standard.
+
+```rb
+# Create a new Address instance.
+address = Addressing::Address.new(
+  country_code: "US",
+  administrative_area: "CA",
+  locality: "Mountain View",
+  dependent_locality: "MV",
+  postal_code: "94043",
+  sorting_code: "94044",
+  address_line1: "1600 Amphitheatre Parkway",
+  address_line2: "Google Bldg 41",
+  organization: "Google Inc.",
+  given_name: "John",
+  additional_name: "L.",
+  family_name: "Smith",
+  locale: "en"
+)
+
+# Modify an existing instance through chainable methods.
+address = address.with_country_code('US')
+                 .with_administrative_area('CA')
+```
+
+The [AddressFormat](lib/addressing/address_format.rb) class provides the following information:
+
+- Which fields are used, and in which order
+- Which fields are required
+- Which fields need to be uppercased for the actual mailing (to facilitate automated sorting of mail)
+- The labels for the administrative area (state, province, parish, etc.), locality (city/post town/district, etc.), dependent locality (neighborhood, suburb, district, etc) and the postal code (postal code or ZIP code)
+- The regular expression pattern for validating postal codes
+
+```rb
+# Get the address format for Brazil.
+address_format = Addressing::AddressFormat.get('BR')
+```
+
+The [Country](lib/addressing/country.rb) class provides the following information:
+
+- The country name.
+- The numeric and three-letter country codes.
+- The official currency code, when known.
+- The timezones which the country spans.
+
+```rb
+# Get the country instance for Brazil.
+brazil = Addressing::Country.get('BR')
+p brazil.three_letter_code # BRA
+p brazil.name # Brazil
+p brazil.currency_code # BRL
+p brazil.timezones
+
+# Get all country instances.
+countries = Addressing::Country.all
+
+# Get the country list ({ country_code => name }), in French.
+country_list = Addressing::Country.list('fr-FR')
+```
+
+The [Subdivision](lib/addressing/subdivision.rb) class provides the following information:
+
+- The subdivision code (used to represent the subdivison on a parcel/envelope, e.g. CA for California)
+- The subdivison name (shown to the user in a dropdown)
+- The local code and name, if the country uses a non-latin script (e.g. Cyrilic in Russia).
+- The postal code prefix (used to ensure that a postal code begins with the expected characters)
+
+Subdivisions are hierarchical and can have up to three levels: Administrative Area -> Locality -> Dependent Locality.
+
+```rb
+# Get the subdivisions for Brazil.
+states = Addressing::Subdivision.all(['BR'])
+states.each do |state|
+  municipalities = state.children
+end
+
+# Get the subdivisions for Brazilian state Ceará.
+municipalities = Addressing::Subdivision.all(['BR', 'CE'])
+municipalities.each do |municipality|
+  p municipality.name
+end
+```
+
+### Formatting addresses
+
+Addresses are formatted according to the address format, in HTML or text.
+
+#### DefaultFormatter
+
+Formats an address for display, always adds the localized country name.
+
+```rb
+address = Addressing::Address.new
+address = address.with_country_code('US')
+                 .with_administrative_area('CA')
+                 .with_locality('Mountain View')
+                 .with_address_line1('1098 Alta Ave')
+
+formatter = Addressing::DefaultFormatter.new
+p formatter.format(address)
+
+# Output:
+# <p translate="no">
+# <span class="address-line1">1098 Alta Ave</span><br>
+# <span class="locality">Mountain View</span>, <span class="administrative-area">CA</span><br>
+# <span class="country">United States</span>
+# </p>
+```
+
+#### PostalLabelFormatter
+
+Takes care of uppercasing fields where required by the format (to facilitate automated mail sorting).
+
+Requires specifying the origin country code, allowing it to differentiate between domestic and international mail. In case of domestic mail, the country name is not displayed at all. In case of international mail:
+
+1. The postal code is prefixed with the destination's postal code prefix.
+2. The country name is added to the formatted address, in both the current locale and English. This matches the recommendation given by the Universal Postal Union, to avoid difficulties in countries of transit.
+
+```rb
+address = Addressing::Address.new
+address = address.with_country_code('US')
+                 .with_administrative_area('CA')
+                 .with_locality('Mountain View')
+                 .with_address_line1('1098 Alta Ave')
+
+formatter = Addressing::PostalLabelFormatter.new
+p formatter.format(address, origin_country: "FR")
+
+# Output:
+# 1098 Alta Ave
+# MOUNTAIN VIEW, CA 94043
+# ÉTATS-UNIS - UNITED STATES
+```
+
+## Changelog
+
+Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
+
+## Acknowledgements
+
+This gem wouldn't exist when there wasn't the awesome PHP [addressing](https://github.com/commerceguys/addressing) library. The [CommerceGuys](https://github.com/commerceguys) did an excellent job figuring out how to parse Google's address data, as described by their [backstory](https://drupalcommerce.org/blog/16864/commerce-2x-stories-addressing). Unfortunately for me, they created a PHP library where I needed a Ruby gem so this project was born.
+
+## Contributing
+
+Everyone is encouraged to help improve this project. Here are a few ways you can help:
+
+- [Report bugs](https://github.com/robinvdvleuten/addressing/issues)
+- Fix bugs and [submit pull requests](https://github.com/robinvdvleuten/addressing/pulls)
+- Write, clarify, or fix documentation
+- Suggest or add new features
+
+To get started with development:
+
+```
+git clone https://github.com/robinvdvleuten/addressing.git
+cd addressing
+bundle install
+bundle exec rake test
+```
+
+Feel free to open an issue to get feedback on your idea before spending too much time on it.
+
+## License
+
+The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
+
+https://github.com/countries/countries/blob/eddb4af3889e5c8b66d897f9789d43c4a1ee0598/spec/thread_safety_spec.rb

data/data/address_formats.json

@@ -0,0 +1,206 @@
+{"country_code": "ZZ","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality","required_fields": ["address_line1","locality"],"uppercase_fields": ["locality"],"administrative_area_type": "province","locality_type": "city","dependent_locality_type": "suburb","postal_code_type": "postal","subdivision_depth": 0}
+{"country_code": "AC","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","postal_code_pattern": "ASCN 1ZZ"}
+{"country_code": "AD","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "AD[1-7]0\\d","subdivision_depth": 1}
+{"country_code": "AE","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%administrative_area","required_fields": ["address_line1","administrative_area"],"administrative_area_type": "emirate","subdivision_depth": 1}
+{"country_code": "AF","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","postal_code_pattern": "\\d{4}"}
+{"country_code": "AG","required_fields": ["address_line1"]}
+{"country_code": "AI","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","postal_code_pattern": "(?:AI-)?2640"}
+{"country_code": "AL","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code\n%locality","postal_code_pattern": "\\d{4}"}
+{"country_code": "AM","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code\n%locality\n%administrative_area","postal_code_pattern": "(?:37)?\\d{4}","subdivision_depth": 1}
+{"country_code": "AR","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality\n%administrative_area","uppercase_fields": ["address_line1","address_line2","locality","postal_code"],"postal_code_pattern": "((?:[A-HJ-NP-Z])?\\d{4})([A-Z]{3})?","subdivision_depth": 1}
+{"country_code": "AS","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","family_name","additional_name","given_name","organization","administrative_area"],"administrative_area_type": "state","postal_code_type": "zip","postal_code_pattern": "(96799)(?:[ \\-](\\d{4}))?"}
+{"country_code": "AT","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{4}"}
+{"country_code": "AU","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["locality","administrative_area"],"administrative_area_type": "state","locality_type": "suburb","postal_code_pattern": "\\d{4}","subdivision_depth": 1}
+{"country_code": "AX","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2-%postal_code %locality\nÅLAND","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "22\\d{3}","postal_code_prefix": "AX-"}
+{"country_code": "AZ","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2 %postal_code %locality","postal_code_pattern": "\\d{4}","postal_code_prefix": "AZ "}
+{"country_code": "BA","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{5}"}
+{"country_code": "BB","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality, %administrative_area %postal_code","administrative_area_type": "parish","postal_code_pattern": "BB\\d{5}"}
+{"country_code": "BD","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality - %postal_code","postal_code_pattern": "\\d{4}"}
+{"country_code": "BE","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{4}"}
+{"country_code": "BF","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %sorting_code"}
+{"country_code": "BG","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{4}"}
+{"country_code": "BH","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "(?:^|\b)(?:1[0-2]|[1-9])d{2}(?:$|\b)"}
+{"country_code": "BJ","uppercase_fields": ["address_line1","address_line2","locality"]}
+{"country_code": "BL","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality %sorting_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","sorting_code"],"postal_code_pattern": "9[78][01]\\d{2}"}
+{"country_code": "BM","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "[A-Z]{2} ?[A-Z0-9]{2}"}
+{"country_code": "BN","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "[A-Z]{2} ?\\d{4}"}
+{"country_code": "BO","uppercase_fields": ["address_line1","address_line2","locality"]}
+{"country_code": "BR","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%dependent_locality\n%locality-%administrative_area\n%postal_code","required_fields": ["address_line1","administrative_area","locality","postal_code"],"uppercase_fields": ["locality","administrative_area"],"administrative_area_type": "state","dependent_locality_type": "neighborhood","postal_code_pattern": "\\d{5}-?\\d{3}","subdivision_depth": 2}
+{"country_code": "BS","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality, %administrative_area","administrative_area_type": "island","subdivision_depth": 1}
+{"country_code": "BT","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "\\d{5}"}
+{"country_code": "BY","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code, %locality\n%administrative_area","postal_code_pattern": "\\d{6}"}
+{"country_code": "CA","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","family_name","additional_name","given_name","organization","administrative_area","postal_code"],"postal_code_pattern": "[ABCEGHJKLMNPRSTVXY]\\d[ABCEGHJ-NPRSTV-Z] ?\\d[ABCEGHJ-NPRSTV-Z]\\d","subdivision_depth": 1}
+{"country_code": "CC","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","uppercase_fields": ["locality","administrative_area"],"postal_code_pattern": "6799"}
+{"country_code": "CH","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2-%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": [],"postal_code_pattern": "\\d{4}","postal_code_prefix": "CH-"}
+{"country_code": "CI","format": "%given_name %family_name\n%organization\n%sorting_code %address_line1\n%address_line2 %locality %sorting_code"}
+{"country_code": "CL","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality\n%administrative_area","postal_code_pattern": "\\d{7}","subdivision_depth": 2}
+{"country_code": "CN","locale": "zh-Hans","format": "%family_name %given_name\n%organization\n%address_line1\n%address_line2\n%dependent_locality\n%locality\n%administrative_area, %postal_code","local_format": "%postal_code\n%administrative_area%locality%dependent_locality\n%address_line1\n%address_line2\n%organization\n%family_name %given_name","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["administrative_area"],"dependent_locality_type": "district","postal_code_pattern": "\\d{6}","subdivision_depth": 3}
+{"country_code": "CO","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality, %administrative_area, %postal_code","required_fields": ["address_line1","locality","administrative_area"],"administrative_area_type": "department","postal_code_pattern": "\\d{6}","subdivision_depth": 1}
+{"country_code": "CR","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%administrative_area, %locality\n%postal_code","required_fields": ["address_line1","locality","administrative_area"],"postal_code_pattern": "\\d{4,5}|\\d{3}-\\d{4}"}
+{"country_code": "CU","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %administrative_area\n%postal_code","postal_code_pattern": "\\d{5}","subdivision_depth": 1}
+{"country_code": "CV","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality\n%administrative_area","administrative_area_type": "island","postal_code_pattern": "\\d{4}","subdivision_depth": 1}
+{"country_code": "CX","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","uppercase_fields": ["locality","administrative_area"],"postal_code_pattern": "6798"}
+{"country_code": "CY","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{4}"}
+{"country_code": "CZ","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{3} ?\\d{2}"}
+{"country_code": "DE","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postalCode %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{5}"}
+{"country_code": "DK","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{4}"}
+{"country_code": "DO","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{5}"}
+{"country_code": "DZ","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{5}"}
+{"country_code": "EC","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code\n%locality","uppercase_fields": ["locality","postal_code"],"postal_code_pattern": "\\d{6}"}
+{"country_code": "EE","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality %administrative_area","required_fields": ["address_line1","locality","postal_code"],"administrative_area_type": "county","postal_code_pattern": "\\d{5}"}
+{"country_code": "EG","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area\n%postal_code","postal_code_pattern": "\\d{5}","subdivision_depth": 1}
+{"country_code": "EH","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{5}"}
+{"country_code": "ES","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality %administrative_area","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["locality","administrative_area"],"postal_code_pattern": "\\d{5}","subdivision_depth": 1}
+{"country_code": "ET","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{4}"}
+{"country_code": "FI","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2-%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{5}","postal_code_prefix": "FI-"}
+{"country_code": "FK","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["locality","postal_code"],"postal_code_pattern": "FIQQ 1ZZ"}
+{"country_code": "FM","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","family_name","additional_name","given_name","organization","administrative_area"],"administrative_area_type": "state","postal_code_type": "zip","postal_code_pattern": "(9694[1-4])(?:[ \\-](\\d{4}))?"}
+{"country_code": "FO","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2%postal_code %locality","postal_code_pattern": "\\d{3}","postal_code_prefix": "FO"}
+{"country_code": "FR","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality %sorting_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["locality","sorting_code"],"postal_code_pattern": "\\d{2} ?\\d{3}"}
+{"country_code": "GB","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["locality","postal_code"],"locality_type": "post_town","postal_code_pattern": "GIR ?0AA|(?:(?:AB|AL|B|BA|BB|BD|BF|BH|BL|BN|BR|BS|BT|BX|CA|CB|CF|CH|CM|CO|CR|CT|CV|CW|DA|DD|DE|DG|DH|DL|DN|DT|DY|E|EC|EH|EN|EX|FK|FY|G|GL|GY|GU|HA|HD|HG|HP|HR|HS|HU|HX|IG|IM|IP|IV|JE|KA|KT|KW|KY|L|LA|LD|LE|LL|LN|LS|LU|M|ME|MK|ML|N|NE|NG|NN|NP|NR|NW|OL|OX|PA|PE|PH|PL|PO|PR|RG|RH|RM|S|SA|SE|SG|SK|SL|SM|SN|SO|SP|SR|SS|ST|SW|SY|TA|TD|TF|TN|TQ|TR|TS|TW|UB|W|WA|WC|WD|WF|WN|WR|WS|WV|YO|ZE)(?:\\d[\\dA-Z]? ?\\d[ABD-HJLN-UW-Z]{2}))|BFPO ?\\d{1,4}"}
+{"country_code": "GE","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{4}"}
+{"country_code": "GF","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality %sorting_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","sorting_code"],"postal_code_pattern": "9[78]3\\d{2}"}
+{"country_code": "GG","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["locality","postal_code"],"postal_code_pattern": "GY\\d[\\dA-Z]? ?\\d[ABD-HJLN-UW-Z]{2}"}
+{"country_code": "GI","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code","required_fields": ["address_line1"],"postal_code_pattern": "GX11 1AA"}
+{"country_code": "GL","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "39\\d{2}"}
+{"country_code": "GN","format": "%given_name %family_name\n%organization\n%postal_code %address_line1\n%address_line2 %locality","postal_code_pattern": "\\d{3}"}
+{"country_code": "GP","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality %sorting_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","sorting_code"],"postal_code_pattern": "9[78][01]\\d{2}"}
+{"country_code": "GR","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{3} ?\\d{2}"}
+{"country_code": "GS","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n\n%locality\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["locality","postal_code"],"postal_code_pattern": "SIQQ 1ZZ"}
+{"country_code": "GT","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code- %locality","postal_code_pattern": "\\d{5}"}
+{"country_code": "GU","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","family_name","additional_name","given_name","organization"],"postal_code_type": "zip","postal_code_pattern": "(969(?:[12]\\d|3[12]))(?:[ \\-](\\d{4}))?"}
+{"country_code": "GW","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{4}"}
+{"country_code": "HK","locale": "zh-Hant","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area","local_format": "%administrative_area\n%locality\n%address_line1\n%address_line2\n%organization\n%given_name %family_name","required_fields": ["address_line1","administrative_area"],"uppercase_fields": ["administrative_area"],"administrative_area_type": "area","locality_type": "district","subdivision_depth": 2}
+{"country_code": "HM","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","uppercase_fields": ["locality","administrative_area"],"postal_code_pattern": "\\d{4}"}
+{"country_code": "HN","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality, %administrative_area\n%postal_code","required_fields": ["address_line1","locality","administrative_area"],"administrative_area_type": "department","postal_code_pattern": "\\d{5}"}
+{"country_code": "HR","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2-%postal_code %locality","postal_code_pattern": "\\d{5}","postal_code_prefix": "HR-"}
+{"country_code": "HT","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2%postal_code %locality","postal_code_pattern": "\\d{4}","postal_code_prefix": "HT"}
+{"country_code": "HU","format": "%family_name %given_name\n%organization\n%locality\n%address_line1\n%address_line2\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","family_name","additional_name","given_name","organization"],"postal_code_pattern": "\\d{4}"}
+{"country_code": "ID","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area %postal_code","required_fields": ["address_line1","administrative_area"],"postal_code_pattern": "\\d{5}","subdivision_depth": 1}
+{"country_code": "IE","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%dependent_locality\n%locality\n%administrative_area\n%postal_code","administrative_area_type": "county","dependent_locality_type": "townland","postal_code_type": "eircode","postal_code_pattern": "[\\dA-Z]{3} ?[\\dA-Z]{4}","subdivision_depth": 1}
+{"country_code": "IL","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "\\d{5}(?:\\d{2})?"}
+{"country_code": "IM","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["locality","postal_code"],"postal_code_pattern": "IM\\d[\\dA-Z]? ?\\d[ABD-HJLN-UW-Z]{2}"}
+{"country_code": "IN","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code\n%administrative_area","required_fields": ["address_line1","locality","administrative_area","postal_code"],"administrative_area_type": "state","postal_code_type": "pin","postal_code_pattern": "\\d{6}","subdivision_depth": 1}
+{"country_code": "IO","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["locality","postal_code"],"postal_code_pattern": "BBND 1ZZ"}
+{"country_code": "IQ","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%locality, %administrative_area\n%postal_code","required_fields": ["address_line1","locality","administrative_area"],"uppercase_fields": ["locality","administrative_area"],"postal_code_pattern": "\\d{5}"}
+{"country_code": "IR","format": "%organization\n%given_name %family_name\n%administrative_area\n%locality, %dependent_locality\n%address_line1\n%address_line2\n%postal_code","dependent_locality_type": "neighborhood","postal_code_pattern": "\\d{5}-?\\d{5}","subdivision_depth": 1}
+{"country_code": "IS","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{3}"}
+{"country_code": "IT","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality %administrative_area","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["locality","administrative_area"],"postal_code_pattern": "\\d{5}","subdivision_depth": 1}
+{"country_code": "JE","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["locality","postal_code"],"postal_code_pattern": "JE\\d[\\dA-Z]? ?\\d[ABD-HJLN-UW-Z]{2}"}
+{"country_code": "JM","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area %sorting_code","required_fields": ["address_line1","locality","administrative_area"],"administrative_area_type": "parish","subdivision_depth": 1}
+{"country_code": "JO","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "\\d{5}"}
+{"country_code": "JP","locale": "ja","format": "%family_name %given_name\n%organization\n%address_line1\n%address_line2\n%locality, %administrative_area\n%postal_code","local_format": "〒%postal_code\n%administrative_area%locality\n%address_line1\n%address_line2\n%organization\n%family_name %given_name","required_fields": ["address_line1","administrative_area","postal_code"],"uppercase_fields": ["administrative_area"],"administrative_area_type": "prefecture","postal_code_pattern": "\\d{3}-?\\d{4}","subdivision_depth": 1}
+{"country_code": "KE","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","postal_code_pattern": "\\d{5}"}
+{"country_code": "KG","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{6}"}
+{"country_code": "KH","format": "%family_name %given_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "\\d{5,6}"}
+{"country_code": "KI","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%administrative_area\n%locality","uppercase_fields": ["address_line1","address_line2","locality","family_name","additional_name","given_name","organization","administrative_area"],"administrative_area_type": "island"}
+{"country_code": "KM","uppercase_fields": ["address_line1","address_line2","locality"]}
+{"country_code": "KN","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality, %administrative_area","required_fields": ["address_line1","locality","administrative_area"],"administrative_area_type": "island","subdivision_depth": 1}
+{"country_code": "KP","locale": "ko","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area, %postal_code","local_format": "%postal_code\n%administrative_area\n%locality\n%address_line1\n%address_line2\n%organization\n%given_name %family_name","subdivision_depth": 1}
+{"country_code": "KR","locale": "ko","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%dependent_locality\n%locality\n%administrative_area\n%postal_code","local_format": "%administrative_area %locality%dependent_locality\n%address_line1\n%address_line2\n%organization\n%given_name %family_name\n%postal_code","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["postal_code"],"administrative_area_type": "do_si","dependent_locality_type": "district","postal_code_pattern": "\\d{5}","subdivision_depth": 3}
+{"country_code": "KW","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{5}"}
+{"country_code": "KY","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%administrative_area %postal_code","required_fields": ["address_line1","administrative_area"],"administrative_area_type": "island","postal_code_pattern": "KY\\d-\\d{4}","subdivision_depth": 1}
+{"country_code": "KZ","format": "%postal_code\n%administrative_area\n%locality\n%address_line1\n%address_line2\n%organization\n%given_name %family_name","postal_code_pattern": "\\d{6}"}
+{"country_code": "LA","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{5}"}
+{"country_code": "LB","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "(?:\\d{4})(?: ?(?:\\d{4}))?"}
+{"country_code": "LI","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2-%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "948[5-9]|949[0-8]","postal_code_prefix": "FL-"}
+{"country_code": "LK","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","postal_code_pattern": "\\d{5}"}
+{"country_code": "LR","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{4}"}
+{"country_code": "LS","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "\\d{3}"}
+{"country_code": "LT","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality %administrative_area","required_fields": ["address_line1","locality","postal_code"],"administrative_area_type": "county","postal_code_pattern": "\\d{5}","postal_code_prefix": "LT-"}
+{"country_code": "LU","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2-%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{4}","postal_code_prefix": "L-"}
+{"country_code": "LV","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality, %postal_code","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "LV-\\d{4}"}
+{"country_code": "MA","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{5}"}
+{"country_code": "MC","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2-%postal_code %locality %sorting_code","postal_code_pattern": "980\\d{2}","postal_code_prefix": "MC-"}
+{"country_code": "MD","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2-%postal_code %locality","postal_code_pattern": "\\d{4}","postal_code_prefix": "MD-"}
+{"country_code": "ME","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "8\\d{4}"}
+{"country_code": "MF","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality %sorting_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","sorting_code"],"postal_code_pattern": "9[78][01]\\d{2}"}
+{"country_code": "MG","format": "%family_name %given_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{3}"}
+{"country_code": "MH","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","family_name","additional_name","given_name","organization","administrative_area"],"administrative_area_type": "state","postal_code_type": "zip","postal_code_pattern": "(969[67]\\d)(?:[ \\-](\\d{4}))?"}
+{"country_code": "MK","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{4}"}
+{"country_code": "MM","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality, %postal_code","postal_code_pattern": "\\d{5}"}
+{"country_code": "MN","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area %postal_code","postal_code_pattern": "\\d{5}"}
+{"country_code": "MO","locale": "zh-Hans","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2","local_format": "%address_line1\n%address_line2\n%organization\n%given_name %family_name","required_fields": ["address_line1"]}
+{"country_code": "MP","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","family_name","additional_name","given_name","organization","administrative_area"],"administrative_area_type": "state","postal_code_type": "zip","postal_code_pattern": "(9695[012])(?:[ \\-](\\d{4}))?"}
+{"country_code": "MQ","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality %sorting_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","sorting_code"],"postal_code_pattern": "9[78]2\\d{2}"}
+{"country_code": "MR","uppercase_fields": ["address_line1","address_line2","locality"]}
+{"country_code": "MT","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","uppercase_fields": ["locality","postal_code"],"postal_code_pattern": "[A-Z]{3} ?\\d{2,4}"}
+{"country_code": "MU","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code\n%locality","uppercase_fields": ["locality","postal_code"],"postal_code_pattern": "\\d{3}(?:\\d{2}|[A-Z]{2}\\d{3})"}
+{"country_code": "MV","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "\\d{5}"}
+{"country_code": "MW","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %sorting_code"}
+{"country_code": "MX","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%dependent_locality\n%postal_code %locality, %administrative_area","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["locality","administrative_area","postal_code"],"administrative_area_type": "state","dependent_locality_type": "neighborhood","postal_code_pattern": "\\d{5}","subdivision_depth": 1}
+{"country_code": "MY","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%dependent_locality\n%postal_code %locality\n%administrative_area","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["locality","administrative_area"],"administrative_area_type": "state","dependent_locality_type": "village_township","postal_code_pattern": "\\d{5}","subdivision_depth": 1}
+{"country_code": "MZ","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality%administrative_area","postal_code_pattern": "\\d{4}","subdivision_depth": 1}
+{"country_code": "NA","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","postal_code_pattern": "\\d{5}"}
+{"country_code": "NC","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality %sorting_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","sorting_code"],"postal_code_pattern": "988\\d{2}"}
+{"country_code": "NE","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{4}"}
+{"country_code": "NF","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","uppercase_fields": ["locality","administrative_area"],"postal_code_pattern": "2899"}
+{"country_code": "NG","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%dependent_locality\n%locality %postal_code\n%administrative_area","uppercase_fields": ["locality","administrative_area"],"administrative_area_type": "state","postal_code_pattern": "\\d{6}","subdivision_depth": 1}
+{"country_code": "NI","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code\n%locality, %administrative_area","uppercase_fields": ["locality","administrative_area"],"administrative_area_type": "department","postal_code_pattern": "\\d{5}","subdivision_depth": 1}
+{"country_code": "NL","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{4} ?[A-Z]{2}"}
+{"country_code": "NO","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"locality_type": "post_town","postal_code_pattern": "\\d{4}"}
+{"country_code": "NP","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "\\d{5}"}
+{"country_code": "NR","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%administrative_area","required_fields": ["address_line1","administrative_area"],"administrative_area_type": "district","subdivision_depth": 1}
+{"country_code": "NZ","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%dependent_locality\n%locality %postal_code","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{4}"}
+{"country_code": "OM","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code\n%locality","postal_code_pattern": "(?:PC )?\\d{3}"}
+{"country_code": "PA","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area","uppercase_fields": ["locality","administrative_area"]}
+{"country_code": "PE","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code\n%administrative_area","locality_type": "district","postal_code_pattern": "(?:LIMA \\d{1,2}|CALLAO 0?\\d)|[0-2]\\d{4}","subdivision_depth": 1}
+{"country_code": "PF","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality %administrative_area","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["locality","administrative_area"],"administrative_area_type": "island","postal_code_pattern": "987\\d{2}"}
+{"country_code": "PG","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code %administrative_area","required_fields": ["address_line1","locality","administrative_area"],"postal_code_pattern": "\\d{3}"}
+{"country_code": "PH","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%dependent_locality, %locality\n%postal_code %administrative_area","postal_code_pattern": "\\d{4}","subdivision_depth": 1}
+{"country_code": "PK","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality-%postal_code","postal_code_pattern": "\\d{5}"}
+{"country_code": "PL","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{2}-\\d{3}"}
+{"country_code": "PM","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality %sorting_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","sorting_code"],"postal_code_pattern": "9[78]5\\d{2}"}
+{"country_code": "PN","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["locality","postal_code"],"postal_code_pattern": "PCRN 1ZZ"}
+{"country_code": "PR","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","family_name","additional_name","given_name","organization"],"postal_code_type": "zip","postal_code_pattern": "(00[679]\\d{2})(?:[ \\-](\\d{4}))?","postal_code_prefix": "PR "}
+{"country_code": "PT","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{4}-\\d{3}"}
+{"country_code": "PW","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","family_name","additional_name","given_name","organization","administrative_area"],"administrative_area_type": "state","postal_code_type": "zip","postal_code_pattern": "(969(?:39|40))(?:[ \\-](\\d{4}))?"}
+{"country_code": "PY","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{4}"}
+{"country_code": "QA","uppercase_fields": ["address_line1","address_line2","locality"]}
+{"country_code": "RE","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality %sorting_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","sorting_code"],"postal_code_pattern": "9[78]4\\d{2}"}
+{"country_code": "RO","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality"],"postal_code_pattern": "\\d{6}"}
+{"country_code": "RS","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{5,6}"}
+{"country_code": "RU","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area\n%postal_code","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality"],"administrative_area_type": "oblast","postal_code_pattern": "\\d{6}","subdivision_depth": 1}
+{"country_code": "RW","uppercase_fields": ["address_line1","address_line2","locality"]}
+{"country_code": "SA","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "\\d{5}"}
+{"country_code": "SC","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area","uppercase_fields": ["administrative_area"],"administrative_area_type": "island"}
+{"country_code": "SD","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","locality_type": "district","postal_code_pattern": "\\d{5}"}
+{"country_code": "SE","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2-%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"locality_type": "post_town","postal_code_pattern": "\\d{3} ?\\d{2}","postal_code_prefix": "SE-"}
+{"country_code": "SG","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2 %postal_code","required_fields": ["address_line1","postal_code"],"postal_code_pattern": "\\d{6}"}
+{"country_code": "SH","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["locality","postal_code"],"postal_code_pattern": "(?:ASCN|STHL) 1ZZ"}
+{"country_code": "SI","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2-%postal_code %locality","postal_code_pattern": "\\d{4}","postal_code_prefix": "SI-"}
+{"country_code": "SJ","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"locality_type": "post_town","postal_code_pattern": "\\d{4}"}
+{"country_code": "SK","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{3} ?\\d{2}"}
+{"country_code": "SM","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","required_fields": ["address_line1","postal_code"],"postal_code_pattern": "4789\\d"}
+{"country_code": "SN","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{5}"}
+{"country_code": "SO","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality, %administrative_area %postal_code","required_fields": ["address_line1","locality","administrative_area"],"uppercase_fields": ["address_line1","address_line2","locality","administrative_area"],"postal_code_pattern": "[A-Z]{2} ?\\d{5}","subdivision_depth": 1}
+{"country_code": "SR","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area","uppercase_fields": ["address_line1","address_line2","administrative_area"],"subdivision_depth": 1}
+{"country_code": "SV","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code-%locality\n%administrative_area","required_fields": ["address_line1","locality","administrative_area"],"uppercase_fields": ["locality","administrative_area","postal_code"],"postal_code_pattern": "CP [1-3][1-7][0-2]\\d","subdivision_depth": 1}
+{"country_code": "SY","locality_type": "district"}
+{"country_code": "SZ","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","uppercase_fields": ["address_line1","address_line2","locality","postal_code"],"postal_code_pattern": "[HLMS]\\d{3}"}
+{"country_code": "TA","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","postal_code_pattern": "TDCU 1ZZ"}
+{"country_code": "TC","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["locality","postal_code"],"postal_code_pattern": "TKCA 1ZZ"}
+{"country_code": "TH","locale": "th","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%dependent_locality, %locality\n%administrative_area %postal_code","local_format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%dependent_locality %locality\n%administrative_area %postal_code","uppercase_fields": ["administrative_area"],"postal_code_pattern": "\\d{5}","subdivision_depth": 1}
+{"country_code": "TJ","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{6}"}
+{"country_code": "TM","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{6}"}
+{"country_code": "TN","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{4}"}
+{"country_code": "TR","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality/%administrative_area","required_fields": ["address_line1","locality","postal_code"],"locality_type": "district","postal_code_pattern": "\\d{5}","subdivision_depth": 1}
+{"country_code": "TV","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area","uppercase_fields": ["address_line1","address_line2","locality","administrative_area"],"administrative_area_type": "island","subdivision_depth": 1}
+{"country_code": "TW","locale": "zh-Hant","format": "%family_name %given_name\n%organization\n%address_line1\n%address_line2\n%locality, %administrative_area %postal_code","local_format": "%postal_code\n%administrative_area%locality\n%address_line1\n%address_line2\n%organization\n%family_name %given_name","required_fields": ["address_line1","locality","administrative_area","postal_code"],"administrative_area_type": "county","postal_code_pattern": "\\d{3}(?:\\d{2,3})?","subdivision_depth": 2}
+{"country_code": "TZ","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{4,5}"}
+{"country_code": "UA","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"administrative_area_type": "oblast","postal_code_pattern": "\\d{5}","subdivision_depth": 1}
+{"country_code": "UM","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","required_fields": ["address_line1","locality","administrative_area"],"uppercase_fields": ["address_line1","address_line2","locality","family_name","additional_name","given_name","organization","administrative_area"],"administrative_area_type": "state","postal_code_type": "zip","postal_code_pattern": "96898"}
+{"country_code": "US","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality, %administrative_area %postal_code","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["locality","administrative_area"],"administrative_area_type": "state","postal_code_type": "zip","postal_code_pattern": "(\\d{5})(?:[ \\-](\\d{4}))?","subdivision_depth": 1}
+{"country_code": "UY","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality %administrative_area","uppercase_fields": ["locality","administrative_area"],"postal_code_pattern": "\\d{5}","subdivision_depth": 1}
+{"country_code": "UZ","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality\n%administrative_area","uppercase_fields": ["locality","administrative_area"],"postal_code_pattern": "\\d{6}"}
+{"country_code": "VA","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "00120"}
+{"country_code": "VC","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code","postal_code_pattern": "VC\\d{4}"}
+{"country_code": "VE","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %postal_code, %administrative_area","required_fields": ["address_line1","locality","administrative_area"],"uppercase_fields": ["locality","administrative_area"],"administrative_area_type": "state","postal_code_pattern": "\\d{4}","subdivision_depth": 1}
+{"country_code": "VG","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality\n%postal_code","required_fields": ["address_line1"],"postal_code_pattern": "VG\\d{4}"}
+{"country_code": "VI","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%locality %administrative_area %postal_code","required_fields": ["address_line1","locality","administrative_area","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","family_name","additional_name","given_name","organization","administrative_area"],"administrative_area_type": "state","postal_code_type": "zip","postal_code_pattern": "(008(?:(?:[0-4]\\d)|(?:5[01])))(?:[ \\-](\\d{4}))?"}
+{"country_code": "VN","format": "%family_name %given_name\n%organization\n%address_line1\n%address_line2\n%locality\n%administrative_area %postal_code","postal_code_pattern": "\\d{5}\\d?","subdivision_depth": 1}
+{"country_code": "WF","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality %sorting_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","sorting_code"],"postal_code_pattern": "986\\d{2}"}
+{"country_code": "XK","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "[1-7]\\d{4}"}
+{"country_code": "YT","format": "%organization\n%given_name %family_name\n%address_line1\n%address_line2\n%postal_code %locality %sorting_code","required_fields": ["address_line1","locality","postal_code"],"uppercase_fields": ["address_line1","address_line2","locality","sorting_code"],"postal_code_pattern": "976\\d{2}"}
+{"country_code": "ZA","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%dependent_locality\n%locality\n%postal_code","required_fields": ["address_line1","locality","postal_code"],"postal_code_pattern": "\\d{4}"}
+{"country_code": "ZM","format": "%given_name %family_name\n%organization\n%address_line1\n%address_line2\n%postal_code %locality","postal_code_pattern": "\\d{5}"}