us_states_data_gem 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4b9779cef5b340d07f90b3478ce9f05e193f4d91a480c1a5d2717efa0538398c
+  data.tar.gz: c9042ae04f0d23348ecba2091934bf022d2f74e0542783acebc048051152234c
+SHA512:
+  metadata.gz: 35fa9086883c3960dfd5a7cf66ae0533e9ee618a72ba484cc1d93670f36f91aae4f69418ea989c7ea29643c7b996279ace2b63016a7203bad8808c48a4730352
+  data.tar.gz: ad0318436830618cc4cc5836186f022cdce97417706c695e802d9661b25627049d6cfcdbea924a7d2b25e367d53f0a10c81479f6d4ae10c7c3c1d753664976f9

data/lib/us_states_data.rb

@@ -0,0 +1,85 @@
+require 'yaml'
+
+module UsStatesData
+  STATES = YAML.load_file(File.join(__dir__, 'us_states_data.yml'))
+
+  def self.states
+    STATES.keys
+  end
+
+  def self.counties_for_state(state_name)
+    STATES[state_name.capitalize]["counties"]
+  end
+
+  def self.zip_codes_for_state(state_name)
+    STATES[state_name.capitalize]["zip_codes"]
+  end
+
+  def self.state_information(state_name)
+    STATES[state_name.capitalize]
+  end
+
+  def self.state_abbreviation(state_name)
+    STATES[state_name.capitalize]["abbreviation"]
+  end
+
+  def self.is_county_in_state?(county_name, state_name)
+    state = STATES[state_name.capitalize]
+    if state.nil?
+      raise ArgumentError, "State '#{state_name}' not found."
+    elsif state["counties"].map(&:downcase).include?(county_name.downcase)
+      return [true, 200]
+    else
+      return [false, 404,  "County '#{county_name}' not found in state '#{state_name}'."]
+    end
+  end
+
+
+  def self.is_zip_code_in_state?(zip_code, state_name)
+    unless STATES[state_name.capitalize]
+      raise ArgumentError, "State '#{state_name}' not found."
+    end
+
+    if !valid_zip_code?(zip_code)
+      raise ArgumentError, "Invalid zip code format."
+    elsif STATES[state_name.capitalize]["zip_codes"].include?(zip_code.to_s)
+      return [true, 200]
+    else
+      return [false, 404, "Zip code '#{zip_code}' not found in state '#{state_name}'."]
+    end
+  end
+
+  def self.valid_zip_code?(zip_code)
+    zip_code.to_s.match?(/\A\d{5}\z/)
+  end
+
+  def self.states_from_region(region_name)
+    region_name_downcase = region_name.downcase
+    matching_states = STATES.select { |_, data| data["region"].casecmp(region_name_downcase).zero? }.keys
+    if matching_states.empty?
+      available_regions = STATES.values.map { |data| data["region"] }.uniq.join(", ")
+      raise "Region '#{region_name}' doesn't exist. Available regions are: #{available_regions}"
+    else
+      matching_states
+    end
+  end
+
+  def self.states_from_division(division_name)
+    division_name_downcase = division_name.downcase
+    matching_states = STATES.select { |_, data| data["division"].casecmp(division_name_downcase).zero? }.keys
+    if matching_states.empty?
+      available_divisions = STATES.values.map { |data| data["division"] }.uniq.join(", ")
+      raise "Division '#{division_name}' doesn't exist. Available divisions are: #{available_divisions}"
+    else
+      matching_states
+    end
+  end
+
+  def self.sort_by_region
+    STATES.keys.sort_by { |state| STATES[state]["region"].downcase }
+  end
+
+  def self.sort_by_division
+    STATES.keys.sort_by { |state| STATES[state]["division"].downcase }
+  end
+end