geo_states 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d0aedae067e7276a505d4a23c6bf594c9db0cf9f1e23d3713b0a82923512b65
-  data.tar.gz: 9f4a6960b3e6334a579af5f5d4e7a2da36c284d4753625a87288ded90eb5e54e
+  metadata.gz: 57ccab397c3c359acab87f1b0123fb5b8030bda122a6bbf80c211f945abc07e3
+  data.tar.gz: a16b689c9cd2a7105cf0606aca37690d719630ef1ca49298f2be66e4ebfd0fd4
 SHA512:
-  metadata.gz: 22945f22f63d71c653d2a900bdf5ea4396cb763c07ca8046d39823ec1915e01a7229f6b69bffe2b61380860ba4612f03a7341e26231454b975dfe246538e9732
-  data.tar.gz: 3cffe4fa3fe31b687956a6008ffbb133f305194a9fd56dfad3e2d5149407741bee62dbfad358b309e0eb70b4967f5bdb08657ca97344da120f07f9c2773acf2b
+  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.0"
+  VERSION = "0.1.2"
 end

data/lib/geo_states.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "geo_states/version"
+require "geo_states/data_loader"
 
 module GeoStates
   class Error < StandardError; end
@@ -11,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]
@@ -32,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.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Alberto Osnaya (@elosnaya)
@@ -21,6 +21,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- geo_states-0.1.0.gem
 - geo_states/data/countries.json
 - lib/geo_states.rb
 - lib/geo_states/data/countries.json