geo_states 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a0c6519178af969c2358e5ba7402bdec603bf7cd7dc69dd1afc4b43b4b20d48
-  data.tar.gz: 0676e02cd3f7d22b384b6a02b4175122e05029ca04b6e7262c085e4da123611e
+  metadata.gz: 57ccab397c3c359acab87f1b0123fb5b8030bda122a6bbf80c211f945abc07e3
+  data.tar.gz: a16b689c9cd2a7105cf0606aca37690d719630ef1ca49298f2be66e4ebfd0fd4
 SHA512:
-  metadata.gz: 3096bf0c3448fd39ad6044d1ef6fc2f75b588b941c43eee34621344480a2770cf2f9ac0a1ef62f6100b396349b838a3da93888d6232e711c8603a3910d537e69
-  data.tar.gz: dfefb60825e0befbf7414998d982526eff206f22a5dbf1638bbda03252d711f5b76f8e3caee8d612a5db4408444bc8517003d7fc3c2e7c58377032fb24e95f1f
+  metadata.gz: 2ad3fca95638be67289fc0c424e157c2be84456ff1a52f33b8e0e1c0d104bb98d57606e28b0be6a08c438cce7e7c860f385a5dd06adb4e4180a508a760747241
+  data.tar.gz: f0cca01a652a62ce867eeff381ac7053eea305796860cbe7115fbfbfcb5aa0b5446109034f492ff702f825f7bebf55919c112534aac921d42467ce63dd7ef9f4

data/lib/geo_states/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GeoStates
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/lib/geo_states.rb

@@ -12,20 +12,37 @@ module GeoStates
     DataLoader.countries
   end
 
-  # Find country by ISO 3166-1 alpha-2 (e.g. "MX", "US").
+  # Find country by any identifier (ISO2, ISO3, M49, or name).
+  # @param identifier [String] e.g. "MX", "MEX", "484", "Mexico"
+  # @return [Hash, nil]
+  def self.find_country(identifier)
+    find_country_by_iso2(identifier) ||
+      find_country_by_iso3(identifier) ||
+      find_country_by_m49(identifier) ||
+      find_country_by_name(identifier)
+  end
+
+  # Find country by ISO 3166-1 alpha-2 code (e.g. "MX", "US").
   # @param iso2 [String]
   # @return [Hash, nil]
-  def self.find_country(iso2)
+  def self.find_country_by_iso2(iso2)
     DataLoader.find_by_iso2(iso2)
   end
 
-  # Find country by ISO 3166-1 alpha-3 (e.g. "MEX", "USA").
+  # Find country by ISO 3166-1 alpha-3 code (e.g. "MEX", "USA").
   # @param iso3 [String]
   # @return [Hash, nil]
   def self.find_country_by_iso3(iso3)
     DataLoader.find_by_iso3(iso3)
   end
 
+  # Find country by UN M49 numeric code (e.g. "484", 484).
+  # @param m49 [String, Integer]
+  # @return [Hash, nil]
+  def self.find_country_by_m49(m49)
+    DataLoader.find_by_m49(m49)
+  end
+
   # Find country by name (case-insensitive).
   # @param name [String]
   # @return [Hash, nil]
@@ -33,13 +50,11 @@ module GeoStates
     DataLoader.find_by_name(name)
   end
 
-  # States for a country (by iso2, iso3, or country name).
-  # @param identifier [String] ISO2, ISO3, or country name
+  # Return states (subdivisions) for a country. Accepts ISO2, ISO3, M49, or name.
+  # @param identifier [String] ISO2, ISO3, M49, or country name
   # @return [Array<Hash>]
   def self.states_for(identifier)
-    country = find_country(identifier) ||
-              find_country_by_iso3(identifier) ||
-              find_country_by_name(identifier)
+    country = find_country(identifier)
     country&.dig(:states) || []
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: geo_states
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Alberto Osnaya (@elosnaya)