worldwide 1.26.3 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7fafadf542d060d153b05e52fd503b7eba9c2348448c5206586fcea77148038
-  data.tar.gz: 93a6f8ec9eab7a34f9641c3fa004b6ab343f1eb8eb26ca6b870cfd305d9acfb9
+  metadata.gz: 909c8730bf69311da55d2880b5b246d70af5df8eedc3e9de3c162f537b585188
+  data.tar.gz: 2a7eb3d5613c11b63719ea415acec13b5347496284faa44b28223bd93420bd5d
 SHA512:
-  metadata.gz: 695024436d230a8cf893dfce768b8218428617d6ae1ebf13242e247367f16cf8982664d3ad19f9bf9e23402e1b6878698c54bc08c872f77eb8dbe94fbf23ee2b
-  data.tar.gz: '07621898fa7e6641e769f27aab9c5d70bff151a38ce6216eade00a3b911b279383a1ecc9f266c66193b64b4629adb56357cc7f6195de51b03fa43076b1a39022'
+  metadata.gz: 6ece942742ed16568e01763b5ef6033f05f873e9cbfb6fae933dfa3b5552bb81210e7c57f0f78dd916c1680c8b05f9c60e64da4901744a28d00dc7a01f337ae3
+  data.tar.gz: 5af292484d8cbe28f47ddf2acc3976d31c5fba811e140b9222844b3234cfbce3d14682bab4b4167ac684052772b614c7d97a1e7734b98dd0b550e23f0f1548bd

data/CHANGELOG.md

@@ -29,6 +29,21 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ---
 
+## [1.28.0] - 2026-09-21
+
+- Add `Region#iso_3166_code_assigned?` to distinguish currently assigned ISO 3166-1 alpha-2 codes from other region codes. [#598](https://github.com/Shopify/worldwide/pull/598)
+- Reject malformed currency codes before caching. [#596](https://github.com/Shopify/worldwide/pull/596)
+- Add IE Eircode routing keys `N39` (Longford) and `N41` (Carrick-on-Shannon) to each other's `zips_crossing_provinces` entries, so both are valid for Longford and Leitrim. [#601](https://github.com/Shopify/worldwide/pull/601)
+- Avoid retaining unknown locale codes in the global locale cache. [#597](https://github.com/Shopify/worldwide/pull/597)
+- Avoid excessive backtracking in Dutch address fallback parsing. [#599](https://github.com/Shopify/worldwide/pull/599)
+
+---
+
+## [1.27.0] - 2026-09-11
+- Add the 81 province (il) zones for Türkiye (`TR-01`..`TR-81`), staged behind `ignore_provinces` and `hide_provinces_from_addresses`. Each zone carries its plaka number as a `zip_prefix`, so a province can be inferred from the postal code. Address forms and validation are unchanged until the flags are removed.
+
+---
+
 ## [1.26.3] - 2026-09-01
 - Select CLDR storage based on i18n's config behavior instead of Ruby's Fiber API. [#586](https://github.com/Shopify/worldwide/pull/586)
 - No longer require building number for Chile. [#585](https://github.com/Shopify/worldwide/pull/585)

data/Gemfile.lock

@@ -13,7 +13,7 @@ GIT
 PATH
   remote: .
   specs:
-    worldwide (1.26.3)
+    worldwide (1.28.0)
       activesupport (>= 7.0)
       i18n (>= 1.15)
       phonelib (~> 0.8)
@@ -137,6 +137,7 @@ PLATFORMS
   arm64-darwin-22
   arm64-darwin-23
   arm64-darwin-24
+  arm64-darwin-25
   x86_64-linux
 
 DEPENDENCIES

data/README.md

@@ -230,6 +230,7 @@ and also answer questions about its status:
   - `continent?`: is this region a continent?
   - `country?`: is this region a "country"?  (Note that, for backward compatibility with legacy code in Shopify's ecosystem,  we do not consider dependent territories of Spain and the United States to be countries, but we do consider dependencies of Australia, Britain, Denmark, Finland, France and Norway to be "countries")
   - `deprecated?`: has this territory ceased to exist? (e.g. `AN` which dissolved in 2010)
+  - `iso_3166_code_assigned?`: is this region's own code currently assigned in ISO 3166-1 alpha-2? Returns false for reserved, withdrawn, user-assigned, unknown, subdivision, and numeric region codes. This checks the resolved region's code, not the original lookup input.
 
 ```ruby
 $ ca = Worldwide.region(code: "CA")

data/data/iso_3166_assigned_country_codes.yml

@@ -0,0 +1,252 @@
+---
+# Currently assigned ISO 3166-1 alpha-2 codes, checked on 2026-09-17.
+# https://www.iso.org/iso-3166-country-codes.html
+- AD
+- AE
+- AF
+- AG
+- AI
+- AL
+- AM
+- AO
+- AQ
+- AR
+- AS
+- AT
+- AU
+- AW
+- AX
+- AZ
+- BA
+- BB
+- BD
+- BE
+- BF
+- BG
+- BH
+- BI
+- BJ
+- BL
+- BM
+- BN
+- BO
+- BQ
+- BR
+- BS
+- BT
+- BV
+- BW
+- BY
+- BZ
+- CA
+- CC
+- CD
+- CF
+- CG
+- CH
+- CI
+- CK
+- CL
+- CM
+- CN
+- CO
+- CR
+- CU
+- CV
+- CW
+- CX
+- CY
+- CZ
+- DE
+- DJ
+- DK
+- DM
+- DO
+- DZ
+- EC
+- EE
+- EG
+- EH
+- ER
+- ES
+- ET
+- FI
+- FJ
+- FK
+- FM
+- FO
+- FR
+- GA
+- GB
+- GD
+- GE
+- GF
+- GG
+- GH
+- GI
+- GL
+- GM
+- GN
+- GP
+- GQ
+- GR
+- GS
+- GT
+- GU
+- GW
+- GY
+- HK
+- HM
+- HN
+- HR
+- HT
+- HU
+- ID
+- IE
+- IL
+- IM
+- IN
+- IO
+- IQ
+- IR
+- IS
+- IT
+- JE
+- JM
+- JO
+- JP
+- KE
+- KG
+- KH
+- KI
+- KM
+- KN
+- KP
+- KR
+- KW
+- KY
+- KZ
+- LA
+- LB
+- LC
+- LI
+- LK
+- LR
+- LS
+- LT
+- LU
+- LV
+- LY
+- MA
+- MC
+- MD
+- ME
+- MF
+- MG
+- MH
+- MK
+- ML
+- MM
+- MN
+- MO
+- MP
+- MQ
+- MR
+- MS
+- MT
+- MU
+- MV
+- MW
+- MX
+- MY
+- MZ
+- NA
+- NC
+- NE
+- NF
+- NG
+- NI
+- NL
+- 'NO'
+- NP
+- NR
+- NU
+- NZ
+- OM
+- PA
+- PE
+- PF
+- PG
+- PH
+- PK
+- PL
+- PM
+- PN
+- PR
+- PS
+- PT
+- PW
+- PY
+- QA
+- RE
+- RO
+- RS
+- RU
+- RW
+- SA
+- SB
+- SC
+- SD
+- SE
+- SG
+- SH
+- SI
+- SJ
+- SK
+- SL
+- SM
+- SN
+- SO
+- SR
+- SS
+- ST
+- SV
+- SX
+- SY
+- SZ
+- TC
+- TD
+- TF
+- TG
+- TH
+- TJ
+- TK
+- TL
+- TM
+- TN
+- TO
+- TR
+- TT
+- TV
+- TW
+- TZ
+- UA
+- UG
+- UM
+- US
+- UY
+- UZ
+- VA
+- VC
+- VE
+- VG
+- VI
+- VN
+- VU
+- WF
+- WS
+- YE
+- YT
+- ZA
+- ZM
+- ZW

data/data/regions/IE.yml

@@ -643,10 +643,12 @@ zips_crossing_provinces:
   - LD
   - CN
   - RN
+  - LM
   N41:
   - LM
   - CN
   - RN
+  - LD
   P36:
   - CO
   - WD

data/data/regions/NL.yml

@@ -33,7 +33,8 @@ format:
 format_extended:
   edit: "{country}_{firstName}{lastName}_{company}_{streetName}{streetNumber}_{address2}_{zip}{city}_{phone}"
 address1_regex:
-  - "^(?<streetName>(?:\\d+[a-z]+\\s+)?[^\\d]+)\\s+(?<streetNumber>\\d+(?:-[A-Za-z0-9]+)?(?: ?[A-Za-z])?)$"
+  # streetName already consumes extra whitespace; repeated separators cause backtracking.
+  - "^(?<streetName>(?:\\d+[a-z]+\\s)?[^\\d]+)\\s(?<streetNumber>\\d+(?:-[A-Za-z0-9]+)?(?: ?[A-Za-z])?)$"
 additional_address_fields:
   - name: streetName
     required: true

data/data/regions/TR.yml

@@ -6,6 +6,8 @@ currency: TRY
 unit_system: metric
 tax_name: KDV
 tax_inclusive: true
+ignore_provinces: true
+hide_provinces_from_addresses: true
 group: European Countries
 group_name: Europe
 zip_example: '01960'
@@ -34,7 +36,497 @@ languages:
 example_address:
   address1: Küçük Ayasofya Mahallesi
   address2: Camii Sokagi No:20 ⁠Küçük Ayasofya
-  city: Fatih/İstanbul
+  city: Fatih
   zip: '34122'
+  province_code: TR-34
   phone: "+90 212 491 16 63"
 timezone: Europe/Istanbul
+zones:
+- name: Adana
+  code: TR-01
+  iso_code: TR-01
+  tax: 0.0
+  zip_prefixes:
+  - '01'
+- name: Adıyaman
+  code: TR-02
+  iso_code: TR-02
+  tax: 0.0
+  zip_prefixes:
+  - '02'
+- name: Afyonkarahisar
+  code: TR-03
+  iso_code: TR-03
+  tax: 0.0
+  zip_prefixes:
+  - '03'
+- name: Ağrı
+  code: TR-04
+  iso_code: TR-04
+  tax: 0.0
+  zip_prefixes:
+  - '04'
+- name: Aksaray
+  code: TR-68
+  iso_code: TR-68
+  tax: 0.0
+  zip_prefixes:
+  - '68'
+- name: Amasya
+  code: TR-05
+  iso_code: TR-05
+  tax: 0.0
+  zip_prefixes:
+  - '05'
+- name: Ankara
+  code: TR-06
+  iso_code: TR-06
+  tax: 0.0
+  zip_prefixes:
+  - '06'
+- name: Antalya
+  code: TR-07
+  iso_code: TR-07
+  tax: 0.0
+  zip_prefixes:
+  - '07'
+- name: Ardahan
+  code: TR-75
+  iso_code: TR-75
+  tax: 0.0
+  zip_prefixes:
+  - '75'
+- name: Artvin
+  code: TR-08
+  iso_code: TR-08
+  tax: 0.0
+  zip_prefixes:
+  - '08'
+- name: Aydın
+  code: TR-09
+  iso_code: TR-09
+  tax: 0.0
+  zip_prefixes:
+  - '09'
+- name: Balıkesir
+  code: TR-10
+  iso_code: TR-10
+  tax: 0.0
+  zip_prefixes:
+  - '10'
+- name: Bartın
+  code: TR-74
+  iso_code: TR-74
+  tax: 0.0
+  zip_prefixes:
+  - '74'
+- name: Batman
+  code: TR-72
+  iso_code: TR-72
+  tax: 0.0
+  zip_prefixes:
+  - '72'
+- name: Bayburt
+  code: TR-69
+  iso_code: TR-69
+  tax: 0.0
+  zip_prefixes:
+  - '69'
+- name: Bilecik
+  code: TR-11
+  iso_code: TR-11
+  tax: 0.0
+  zip_prefixes:
+  - '11'
+- name: Bingöl
+  code: TR-12
+  iso_code: TR-12
+  tax: 0.0
+  zip_prefixes:
+  - '12'
+- name: Bitlis
+  code: TR-13
+  iso_code: TR-13
+  tax: 0.0
+  zip_prefixes:
+  - '13'
+- name: Bolu
+  code: TR-14
+  iso_code: TR-14
+  tax: 0.0
+  zip_prefixes:
+  - '14'
+- name: Burdur
+  code: TR-15
+  iso_code: TR-15
+  tax: 0.0
+  zip_prefixes:
+  - '15'
+- name: Bursa
+  code: TR-16
+  iso_code: TR-16
+  tax: 0.0
+  zip_prefixes:
+  - '16'
+- name: Çanakkale
+  code: TR-17
+  iso_code: TR-17
+  tax: 0.0
+  zip_prefixes:
+  - '17'
+- name: Çankırı
+  code: TR-18
+  iso_code: TR-18
+  tax: 0.0
+  zip_prefixes:
+  - '18'
+- name: Çorum
+  code: TR-19
+  iso_code: TR-19
+  tax: 0.0
+  zip_prefixes:
+  - '19'
+- name: Denizli
+  code: TR-20
+  iso_code: TR-20
+  tax: 0.0
+  zip_prefixes:
+  - '20'
+- name: Diyarbakır
+  code: TR-21
+  iso_code: TR-21
+  tax: 0.0
+  zip_prefixes:
+  - '21'
+- name: Düzce
+  code: TR-81
+  iso_code: TR-81
+  tax: 0.0
+  zip_prefixes:
+  - '81'
+- name: Edirne
+  code: TR-22
+  iso_code: TR-22
+  tax: 0.0
+  zip_prefixes:
+  - '22'
+- name: Elazığ
+  code: TR-23
+  iso_code: TR-23
+  tax: 0.0
+  zip_prefixes:
+  - '23'
+- name: Erzincan
+  code: TR-24
+  iso_code: TR-24
+  tax: 0.0
+  zip_prefixes:
+  - '24'
+- name: Erzurum
+  code: TR-25
+  iso_code: TR-25
+  tax: 0.0
+  zip_prefixes:
+  - '25'
+- name: Eskişehir
+  code: TR-26
+  iso_code: TR-26
+  tax: 0.0
+  zip_prefixes:
+  - '26'
+- name: Gaziantep
+  code: TR-27
+  iso_code: TR-27
+  tax: 0.0
+  zip_prefixes:
+  - '27'
+- name: Giresun
+  code: TR-28
+  iso_code: TR-28
+  tax: 0.0
+  zip_prefixes:
+  - '28'
+- name: Gümüşhane
+  code: TR-29
+  iso_code: TR-29
+  tax: 0.0
+  zip_prefixes:
+  - '29'
+- name: Hakkâri
+  code: TR-30
+  iso_code: TR-30
+  tax: 0.0
+  zip_prefixes:
+  - '30'
+- name: Hatay
+  code: TR-31
+  iso_code: TR-31
+  tax: 0.0
+  zip_prefixes:
+  - '31'
+- name: Iğdır
+  code: TR-76
+  iso_code: TR-76
+  tax: 0.0
+  zip_prefixes:
+  - '76'
+- name: Isparta
+  code: TR-32
+  iso_code: TR-32
+  tax: 0.0
+  zip_prefixes:
+  - '32'
+- name: Istanbul
+  code: TR-34
+  iso_code: TR-34
+  tax: 0.0
+  zip_prefixes:
+  - '34'
+- name: Izmir
+  code: TR-35
+  iso_code: TR-35
+  tax: 0.0
+  zip_prefixes:
+  - '35'
+- name: Kahramanmaraş
+  code: TR-46
+  iso_code: TR-46
+  tax: 0.0
+  zip_prefixes:
+  - '46'
+- name: Karabük
+  code: TR-78
+  iso_code: TR-78
+  tax: 0.0
+  zip_prefixes:
+  - '78'
+- name: Karaman
+  code: TR-70
+  iso_code: TR-70
+  tax: 0.0
+  zip_prefixes:
+  - '70'
+- name: Kars
+  code: TR-36
+  iso_code: TR-36
+  tax: 0.0
+  zip_prefixes:
+  - '36'
+- name: Kastamonu
+  code: TR-37
+  iso_code: TR-37
+  tax: 0.0
+  zip_prefixes:
+  - '37'
+- name: Kayseri
+  code: TR-38
+  iso_code: TR-38
+  tax: 0.0
+  zip_prefixes:
+  - '38'
+- name: Kilis
+  code: TR-79
+  iso_code: TR-79
+  tax: 0.0
+  zip_prefixes:
+  - '79'
+- name: Kırıkkale
+  code: TR-71
+  iso_code: TR-71
+  tax: 0.0
+  zip_prefixes:
+  - '71'
+- name: Kırklareli
+  code: TR-39
+  iso_code: TR-39
+  tax: 0.0
+  zip_prefixes:
+  - '39'
+- name: Kırşehir
+  code: TR-40
+  iso_code: TR-40
+  tax: 0.0
+  zip_prefixes:
+  - '40'
+- name: Kocaeli
+  code: TR-41
+  iso_code: TR-41
+  tax: 0.0
+  zip_prefixes:
+  - '41'
+- name: Konya
+  code: TR-42
+  iso_code: TR-42
+  tax: 0.0
+  zip_prefixes:
+  - '42'
+- name: Kütahya
+  code: TR-43
+  iso_code: TR-43
+  tax: 0.0
+  zip_prefixes:
+  - '43'
+- name: Malatya
+  code: TR-44
+  iso_code: TR-44
+  tax: 0.0
+  zip_prefixes:
+  - '44'
+- name: Manisa
+  code: TR-45
+  iso_code: TR-45
+  tax: 0.0
+  zip_prefixes:
+  - '45'
+- name: Mardin
+  code: TR-47
+  iso_code: TR-47
+  tax: 0.0
+  zip_prefixes:
+  - '47'
+- name: Mersin
+  code: TR-33
+  iso_code: TR-33
+  tax: 0.0
+  zip_prefixes:
+  - '33'
+  # Northern Cyprus is addressed via Türkiye as "Mersin 10" and uses the 99xxx postal code range
+  - '99'
+- name: Muğla
+  code: TR-48
+  iso_code: TR-48
+  tax: 0.0
+  zip_prefixes:
+  - '48'
+- name: Muş
+  code: TR-49
+  iso_code: TR-49
+  tax: 0.0
+  zip_prefixes:
+  - '49'
+- name: Nevşehir
+  code: TR-50
+  iso_code: TR-50
+  tax: 0.0
+  zip_prefixes:
+  - '50'
+- name: Niğde
+  code: TR-51
+  iso_code: TR-51
+  tax: 0.0
+  zip_prefixes:
+  - '51'
+- name: Ordu
+  code: TR-52
+  iso_code: TR-52
+  tax: 0.0
+  zip_prefixes:
+  - '52'
+- name: Osmaniye
+  code: TR-80
+  iso_code: TR-80
+  tax: 0.0
+  zip_prefixes:
+  - '80'
+- name: Rize
+  code: TR-53
+  iso_code: TR-53
+  tax: 0.0
+  zip_prefixes:
+  - '53'
+- name: Sakarya
+  code: TR-54
+  iso_code: TR-54
+  tax: 0.0
+  zip_prefixes:
+  - '54'
+- name: Samsun
+  code: TR-55
+  iso_code: TR-55
+  tax: 0.0
+  zip_prefixes:
+  - '55'
+- name: Şanlıurfa
+  code: TR-63
+  iso_code: TR-63
+  tax: 0.0
+  zip_prefixes:
+  - '63'
+- name: Siirt
+  code: TR-56
+  iso_code: TR-56
+  tax: 0.0
+  zip_prefixes:
+  - '56'
+- name: Sinop
+  code: TR-57
+  iso_code: TR-57
+  tax: 0.0
+  zip_prefixes:
+  - '57'
+- name: Şırnak
+  code: TR-73
+  iso_code: TR-73
+  tax: 0.0
+  zip_prefixes:
+  - '73'
+- name: Sivas
+  code: TR-58
+  iso_code: TR-58
+  tax: 0.0
+  zip_prefixes:
+  - '58'
+- name: Tekirdağ
+  code: TR-59
+  iso_code: TR-59
+  tax: 0.0
+  zip_prefixes:
+  - '59'
+- name: Tokat
+  code: TR-60
+  iso_code: TR-60
+  tax: 0.0
+  zip_prefixes:
+  - '60'
+- name: Trabzon
+  code: TR-61
+  iso_code: TR-61
+  tax: 0.0
+  zip_prefixes:
+  - '61'
+- name: Tunceli
+  code: TR-62
+  iso_code: TR-62
+  tax: 0.0
+  zip_prefixes:
+  - '62'
+- name: Uşak
+  code: TR-64
+  iso_code: TR-64
+  tax: 0.0
+  zip_prefixes:
+  - '64'
+- name: Van
+  code: TR-65
+  iso_code: TR-65
+  tax: 0.0
+  zip_prefixes:
+  - '65'
+- name: Yalova
+  code: TR-77
+  iso_code: TR-77
+  tax: 0.0
+  zip_prefixes:
+  - '77'
+- name: Yozgat
+  code: TR-66
+  iso_code: TR-66
+  tax: 0.0
+  zip_prefixes:
+  - '66'
+- name: Zonguldak
+  code: TR-67
+  iso_code: TR-67
+  tax: 0.0
+  zip_prefixes:
+  - '67'

data/lib/worldwide/currency.rb

@@ -28,10 +28,10 @@ module Worldwide
 
     def initialize(code:)
       adjusted_code = code.to_s.upcase.rjust(3, "0")
-      if adjusted_code.match?(/[A-Z][A-Z][A-Z]/)
+      if adjusted_code.match?(/\A[A-Z]{3}\z/)
         @currency_code = adjusted_code
         @numeric_code = Currencies.numeric_code_for(adjusted_code)
-      elsif adjusted_code.match?(/[0-9]+/)
+      elsif adjusted_code.match?(/\A[0-9]{3}\z/)
         @currency_code = Currencies.alpha_code_for(adjusted_code)
         @numeric_code = adjusted_code
       else

data/lib/worldwide/region.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "set"
+
 module Worldwide
   class Region
     # When faced with the question, "Is a postal code required in this country?", we treat the answer
@@ -9,6 +11,12 @@ module Worldwide
     RECOMMENDED = "recommended"
     OPTIONAL = "optional"
 
+    ISO_3166_ASSIGNED_COUNTRY_CODES = YAML.safe_load_file(
+      File.join(Worldwide::Paths::DATA_ROOT, "iso_3166_assigned_country_codes.yml"),
+      freeze: true,
+    ).to_set.freeze
+    private_constant :ISO_3166_ASSIGNED_COUNTRY_CODES
+
     # Accpetable format types of the postal code.
     FORMAT_TYPES = {
       ALPHANUMERIC: "ALPHANUMERIC",
@@ -372,6 +380,11 @@ module Worldwide
       @deprecated
     end
 
+    # Is this region's own code currently assigned in ISO 3166-1 alpha-2?
+    def iso_3166_code_assigned?
+      ISO_3166_ASSIGNED_COUNTRY_CODES.include?(iso_code)
+    end
+
     # An Worldwide::Field that can be used to ask about the field, including
     # labels, error messages, and an autofill value if there is one.
     def field(key:)

data/lib/worldwide/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Worldwide
-  VERSION = "1.26.3"
+  VERSION = "1.28.0"
 end

data/lib/worldwide.rb

@@ -69,7 +69,11 @@ module Worldwide
     end
 
     def locale(code:)
-      @locales_cache[code] ||= Locale.new(code)
+      @locales_cache.fetch(code) do
+        locale = Locale.new(code)
+        @locales_cache[code] = locale if locales.include?(locale.code)
+        locale
+      end
     end
 
     def locales

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: worldwide
 version: !ruby/object:Gem::Version
-  version: 1.26.3
+  version: 1.28.0
 platform: ruby
 authors:
 - Shopify
@@ -4715,6 +4715,7 @@ files:
 - data/country_codes.yml
 - data/extant_outcodes.yml
 - data/iana_to_rails_time_zone.yml
+- data/iso_3166_assigned_country_codes.yml
 - data/other/currency/bg.yml
 - data/other/currency/cs.yml
 - data/other/currency/da.yml
@@ -8736,7 +8737,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.19
+rubygems_version: 4.0.21
 specification_version: 4
 summary: Internationalization and localization APIs
 test_files: []