cse 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1eac2bdb36416e89ad8933688ce7bd9f8cdeccbbffb77033f920e238236f4734
+  data.tar.gz: 50c23e0c21d26491b280ecc669e0da3de1d168edda3c0a6f0b61d65fd1f721da
+SHA512:
+  metadata.gz: 8c06572c54baf8bc4b8d4818e2e5f1d12729d4d0718a7f09317b064842d18fb0ba84897e68298a069514029aeb65170968bdfb25f043123d96d91c9736c9f0bc
+  data.tar.gz: 2188639de4d9e2e91d92a74d94be622b6431435c721bb500b676a81af940ff9038c9d15161fb53f4c15164230a29384d28238287ab40312eec787a1226678c83

data/.gitignore

@@ -0,0 +1,18 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+*.gem
+cities.*
+states.*
+db/countries.yml

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in CityState.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2020 Daniel Loureiro
+
+MIT License
+
+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,41 @@
+# CS ruby gem
+
+**cs** gem is simple city-state gem with some tweaks. Like for country with no states cities are available now.
+
+### Put this gem at your Gemfile:
+```ruby
+gem 'cs'
+```
+
+### Simple Usage:
+
+```ruby
+CS.countries
+# => {:AD=>"Andorra", :AE=>"United Arab Emirates", :AF=>"Afghanistan", :AG=>"Antigua and Barbuda", :AI=>"Anguilla", :AL=>"Albania", :AM=>"Armenia", :AO=>"Angola", :AQ=>"Antarctica", :AR=>"Argentina", :AS=>"American Samoa", :AT=>"Austria", :AU=>"Australia", :AW=>"Aruba", :AX=>"Åland", :AZ=>"Azerbaijanndi", :BJ=>"Benin", :BL=>"Saint-Barthélemy", :BM=>"Bermuda", :BN=>"Brunei", :BO=>"Bolivia", :BQ=>"Bonaire", :BR=>"Brazil", :BS=>"Bahamas", :BT=>"BhutaCOUNTRY_ISO_CODE=>"country_name", :CR=>"Costa Rica", :CU=>"Cuba", :CV=>"Cape Verde", :CW=>"Curaçao", :CX=>"Christmas Island", :CY=>"Cyprus", :CZ=>"Czech Republic", :DE=>"Germany", :DJ=>"Djibouti", :DK=>"Denmark", :DM=>"Dominica", :DO=>"Dominican Republic", :DZ=>"Algeria", :EC=>"Ecuador", :EE=>"Estonia", :EG=>"Egypt", :ER=>"Eritrea", :ES=>"Spain", :ET=>"Ethiopia", :FI=>"Finland", :FJ=>"Fiji", :FK=>"Falkland Islands", :FM=>"Federated States of Micronesia", :FO=>"Faroe Islands", :FR=>"France", :GA=>"Gabon", :GB=>"United Kingdom", :GD=>"Grenada", :GE=>"Georgia", :GF=>"French Guiana", :GG=>"GuernseOcean Territory", :IQ=>"Iraq", :IR=>"Iran", :IS=>"Iceland", :IT=>"Italy", :JE=>"Jersey", :JM=>"Jamaica", :JO=>"Hashemite Kingdom of Jordan", :JP=>"Japic of Korea", :KW=>"Kuwait", :KY=>"Cayman Islands", :KZ=>"Kazakhstan", :LA=>"Laos", :LB=>"Lebanon", :LC=>"Saint Lucia", :LI=>"Liechtenstein", :LK=>"Sri Lanka", :LR=>"Liberia", :LS=>"Lesotho", :LT=>"Republic of Lithuania", :LU=>"Luxembourg", :LV=>"Latvia", :LY=>"Libya", :MA=>"Morocco", :MC=>"Monaco", :MD=>"Republic of Moldova", :ME=>"Montenegro", :MF=>"Saint Martin", :MG=>"Madagascar", :MH=>"Marshall Islands", :MK=>"Macedonia", :ML=>"Mali", :MM=>"ger", :NF=>"Norfolk Island", :NG=>"Nigeria", :NI=>"Nicaragua", :NL=>"Netherlands", :NO=>"Norway", :NP=>"Nepal", :NR=>"Nauru", :NU=>"Niue", :NZ=>"New Zealand", :OM=>"Oman", :PA=>"Panama", :PE=>"Peru", :PF=>"French Polynesia", :PG=>"Papua New Guinea", :PH=>"Philippines", :PK=>"Pakistan", :PL=>"Poland", :PM=>"Saint Pierre and Miquelon", :PN=>"Pitcairn Islands", :PR=>"Puerto Rico", :PS=>"Palestine", :PT=>"Portugal", :PW=>"Palau", :PY=>"Paraguay", :QA=>"Qatar", :RE=>"Réunion", :RO=>"Romania", :RS=>"Serbia", :RU=>"Russia", :RW=>"Rwanda", :SA=>"Saudi Arabia", :SB=>"Solomon Islands", :SC=>"Seychelles", :SD=>"Sudan", :SE=>"Sweden", :SG=>"Singapore", :SH=>"Saint Helena", :SI=>"Slovenia", :SJ=>"Svalbard and Jan Mayen", :SK=>"Slovakia", :SL=>"Sierra Leone", :SM=>"San Marino", :SN=>"Senegal", :SO=>"Somalia", :SR=>"Suriname", :SS=>"South Sudan", :ST=>"São Tomé and Príncipe", :SV=>"El Salvador", :SX=>"Sint Maarten", :SY=>"Syria", :SZ=>"Swaziland", :TC=>"Turks and Caicos Islands", :TD=>"Chad", :TF=>"French Southern Territories", :TG=>"Togo", :TH=>"Thailand", :TJ=>"Tajikistan", :TK=>"Tokelau", :TL=>"East Timor", :TM=>"Turkmenistan", :TN=>"Tunisia", :TO=>"Tonga", :TR=>"Turkey", :TT=>"Trinidad and Tobago", :TV=>"Tuvalu", :TW=>"Taiwan", :TZ=>"Tanzania", :UA=>"Ukraine", :UG=>"Uganda", :UM=>"U.S. Minor Outlying Islands", :US=>"United States", :UY=>"Uruguay", :UZ=>"Uzbekistan", :VA=>"Vatican City", :VC=>"Saint Vincent and the Grenadines", :VE=>"Venezuela", :VG=>"British Virgin Islands", :VI=>"U.S. Virgin Islands", :VN=>"Vietnam", :VU=>"Vanuatu", :WF=>"Wallis and Futuna", :WS=>"Samoa", :XK=>"Kosovo", :YE=>"Yemen", :YT=>"Mayotte", :ZA=>"South Africa", :ZM=>"Zambia", :ZW=>"Zimbabwe"}
+```
+
+```ruby
+CS.states(:IN)
+# => {:AN=>"Andaman and Nicobar", :AP=>"Andhra Pradesh", :AR=>"Arunachal Pradesh", :AS=>"Assam", :BR=>"Bihar", :CH=>"Chandigarh", :CT=>"Chhattisgarh", :DD=>"Daman and Diu", :DL=>"National Capital Territory of Delhi", :DN=>"Dadra and Nagar Haveli", :GA=>"Goa", :GJ=>"Gujarat", :HP=>"Himachal Pradesh", :HR=>"Haryana", :JH=>"Jharkhand", :JK=>"Jammu and Kashmir", :KA=>"Karnataka", :KL=>"Kerala", :LA=>"Ladakh", :LD=>"Lakshadweep", :MH=>"Maharashtra", :ML=>"Meghalaya", :MN=>"Manipur", :MP=>"Madhya Pradesh", :MZ=>"Mizoram", :NL=>"Nagaland", :OR=>"Odisha", :PB=>"Punjab", :PY=>"Union Territory of Puducherry", :RJ=>"Rajasthan", :SK=>"Sikkim", :TG=>"Telangana", :TN=>"Tamil Nadu", :TR=>"Tripura", :UP=>"Uttar Pradesh", :UT=>"Uttarakhand", :WB=>"West Bengal"} 
+```
+
+```ruby
+CS.cities(:UT, :IN)
+# => ["Almora", "Amsaur", "Araghar", "Bageshwar", "Bagoli", "Bazpur", "Belra", "Bhagwanpur", "Champawat", "Dehradun", "Dwarahat", "Gadarpur", "Garur", "Haldwani", "Haridwar", "Jaspur", "Jhabrera", "Kashipur", "Khatima", "Kichha", "Kotdwara", "Lalkua", "Mussoorie", "Nainital", "Pali", "Pantnagar", "Pauri", "Pithoragarh", "Ranikhet", "Rishikesh", "Roorkee", "Rudarpur", "Rudraprayag", "Sitarganj", "Srinagar", "Tanakpur", "Tehri", "Uttarkashi"] 
+```
+
+### More details about this city-state gem (Original Author)
+https://github.com/loureirorg/city-state
+
+# Changelog
+* 0.1.0:
+  - [Minor] Added cities with no states for a country
+  - [Minor] Can change cities name with empty states
+
+
+# CityState License
+**cs** is a tweak to the **city-state project by Daniel Loureiro** with a MIT license. Also, it uses MaxMind open source database.
+
+# MaxMind License
+Database and Contents Copyright (c) 2020 MaxMind, Inc.
+This work is licensed under the Creative Commons Attribution 3.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by/3.0/.

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/cs.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = "cse"
+  spec.version       = "0.0.2"
+  spec.authors       = ["Gaurav Deou"]
+  spec.email         = ["gauravdev720@gmail.com"]
+  spec.summary       = %q{Simple list of cities and states of the world with blank states.}
+  spec.description   = %q{A simple gem for country, state and cities list}
+  spec.homepage      = "https://github.com/garv720/cs"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", ">= 1.7"
+  spec.add_development_dependency "rake", ">= 10.0"
+  spec.add_runtime_dependency "rubyzip", ">= 1.1"
+end

data/lib/cs.rb

@@ -0,0 +1,349 @@
+require 'yaml'
+
+module CS
+  # CS constants
+  FILES_FOLDER = File.expand_path('../db', __FILE__)
+  MAXMIND_DB_FN = File.join(FILES_FOLDER, "GeoLite2-City-Locations-en.csv")
+  COUNTRIES_FN = File.join(FILES_FOLDER, "countries.yml")
+  DEFAULT_CITIES_LOOKUP_FN    = 'db/cities-lookup.yml'
+  DEFAULT_STATES_LOOKUP_FN    = 'db/states-lookup.yml'
+  DEFAULT_COUNTRIES_LOOKUP_FN = 'db/countries-lookup.yml'
+
+  @countries, @states, @cities = [{}, {}, {}]
+  @current_country = nil # :US, :BR, :GB, :JP, ...
+  @maxmind_zip_url = nil
+  @license_key = nil
+
+  # lookup tables for state/cities renaming
+  @cities_lookup_fn = nil
+  @cities_lookup = nil
+  @states_lookup_fn = nil
+  @states_lookup = nil
+  @countries_lookup_fn = nil
+  @countries_lookup = nil
+
+  def self.set_maxmind_zip_url(maxmind_zip_url)
+    @maxmind_zip_url = maxmind_zip_url
+  end
+
+  def self.set_license_key(license_key)
+    url = "https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-City-CSV&license_key=#{license_key}&suffix=zip"
+    @license_key = license_key
+    self.set_maxmind_zip_url(url)
+  end
+
+  def self.update_maxmind
+    require "open-uri"
+    require "zip"
+
+    # get zipped file
+    return false if !@maxmind_zip_url
+    f_zipped = open(@maxmind_zip_url)
+
+    # unzip file:
+    # recursively searches for "GeoLite2-City-Locations-en"
+    Zip::File.open(f_zipped) do |zip_file|
+      zip_file.each do |entry|
+        if self.present?(entry.name["GeoLite2-City-Locations-en"])
+          fn = entry.name.split("/").last
+          entry.extract(File.join(FILES_FOLDER, fn)) { true } # { true } is to overwrite
+          break
+        end
+      end
+    end
+    true
+  end
+
+  def self.update
+    self.update_maxmind # update via internet
+    Dir[File.join(FILES_FOLDER, "states.*")].each do |state_fn|
+      self.install(state_fn.split(".").last.upcase.to_sym) # reinstall country
+    end
+    @countries, @states, @cities = [{}, {}, {}] # invalidades cache
+    File.delete COUNTRIES_FN # force countries.yml to be generated at next call of CS.countries
+    true
+  end
+
+  # constants: CVS position
+  ID = 0
+  COUNTRY = 4
+  COUNTRY_LONG = 5
+  STATE = 6
+  STATE_LONG = 7
+  CITY = 10
+
+  def self.install(country)
+    # get CSV if doesn't exists
+    update_maxmind unless File.exists? MAXMIND_DB_FN
+
+    # normalize "country"
+    country = country.to_s.upcase
+
+    # some state codes are empty: we'll use "states-replace" in these cases
+    states_replace_fn = File.join(FILES_FOLDER, "states-replace.yml")
+    states_replace = self.symbolize_keys(YAML::load_file(states_replace_fn))
+    states_replace = states_replace[country.to_sym] || {} # we need just this country
+    states_replace_inv = states_replace.invert # invert key with value, to ease the search
+
+    # read CSV line by line
+    cities = {}
+    states = {}
+    File.foreach(MAXMIND_DB_FN) do |line|
+      rec = line.split(",")
+      next if rec[COUNTRY] != country
+      next if (self.blank?(rec[STATE]) && self.blank?(rec[STATE_LONG])) && self.blank?(rec[CITY])
+
+      # some state codes are empty: we'll use "states-replace" in these cases
+      rec[STATE] = states_replace_inv[rec[STATE_LONG]] if self.blank?(rec[STATE])
+      rec[STATE] = rec[STATE_LONG] if self.blank?(rec[STATE]) # there's no correspondent in states-replace: we'll use the long name as code
+
+      # some long names are empty: we'll use "states-replace" to get the code
+      rec[STATE_LONG] = states_replace[rec[STATE]] if self.blank?(rec[STATE_LONG])
+
+      # normalize
+      rec[STATE] = rec[STATE].to_sym
+      rec[CITY].gsub!(/\"/, "") # sometimes names come with a "\" char
+      rec[STATE_LONG].gsub!(/\"/, "") if !self.blank?(rec[STATE_LONG])# sometimes names come with a "\" char
+
+      # cities list: {TX: ["Texas City", "Another", "Another 2"]}
+      cities.merge!({rec[STATE] => []}) if ! states.has_key?(rec[STATE])
+      cities[rec[STATE]] << rec[CITY]
+
+      # states list: {TX: "Texas", CA: "California"}
+      if ! states.has_key?(rec[STATE])
+        state = {rec[STATE] => rec[STATE_LONG]}
+        states.merge!(state)
+      end
+    end
+
+    # sort
+    cities = Hash[cities.sort]
+    states = Hash[states.sort]
+    cities.each do |k, v| 
+      v.reject! {|i| i.empty? }
+      cities[k].sort!
+    end
+
+    # save to states.us and cities.us
+    states_fn = File.join(FILES_FOLDER, "states.#{country.downcase}")
+    cities_fn = File.join(FILES_FOLDER, "cities.#{country.downcase}")
+    File.open(states_fn, "w") { |f| f.write states.to_yaml }
+    File.open(cities_fn, "w") { |f| f.write cities.to_yaml }
+    File.chmod(0666, states_fn, cities_fn) # force permissions to rw_rw_rw_ (issue #3)
+    true
+  end
+
+  def self.current_country
+    return @current_country if self.present?(@current_country)
+
+    # we don't have used this method yet: discover by the file extension
+    fn = Dir[File.join(FILES_FOLDER, "cities.*")].last
+    @current_country = self.blank?(fn) ? nil : fn.split(".").last
+
+    # there's no files: we'll install and use :US
+    if self.blank?(@current_country)
+      @current_country = :US
+      self.install(@current_country)
+
+    # we find a file: normalize the extension to something like :US
+    else
+      @current_country = @current_country.to_s.upcase.to_sym
+    end
+
+    @current_country
+  end
+
+  def self.current_country=(country)
+    @current_country = country.to_s.upcase.to_sym
+  end
+
+  def self.cities(state, country = nil)
+    self.current_country = country if self.present?(country) # set as current_country
+    country = self.current_country
+    state = state.to_s.upcase.to_sym
+
+    # load the country file
+    if self.blank?(@cities[country])
+      cities_fn = File.join(FILES_FOLDER, "cities.#{country.to_s.downcase}")
+      self.install(country) if ! File.exists? cities_fn
+      @cities[country] = self.symbolize_keys(YAML::load_file(cities_fn))
+
+      # Remove duplicated cities
+      @cities[country].each do |key, value|
+        @cities[country][key] = value.uniq || []
+      end
+
+      # Process lookup table
+      lookup = get_cities_lookup(country, state)
+      if ! lookup.nil?
+        @cities[country][state] = [] if @cities[country][state].nil?
+        lookup.each do |old_value, new_value|
+          if new_value.nil? || self.blank?(new_value)
+            @cities[country][state].delete(old_value)
+          else
+            index = @cities[country][state].index(old_value)
+            if index.nil?
+              @cities[country][state] << new_value
+            else
+              @cities[country][state][index] = new_value
+            end
+          end
+        end
+        @cities[country][state] = @cities[country][state].sort # sort it alphabetically
+      end
+    end
+
+    # Return list
+    @cities[country][state]
+  end
+
+  def self.set_cities_lookup_file(filename)
+    @cities_lookup_fn = filename
+    @cities_lookup    = nil
+  end
+
+  def self.set_states_lookup_file(filename)
+    @states_lookup_fn = filename
+    @states_lookup    = nil
+  end
+
+  def self.set_countries_lookup_file(filename)
+    @countries_lookup_fn = filename
+    @countries_lookup    = nil
+  end
+
+  def self.get_cities_lookup(country, state)
+    # lookup file not loaded
+    if @cities_lookup.nil?
+      @cities_lookup_fn  = DEFAULT_CITIES_LOOKUP_FN if @cities_lookup_fn.nil?
+      @cities_lookup_fn  = File.expand_path(@cities_lookup_fn)
+      return nil if ! File.exists?(@cities_lookup_fn)
+      @cities_lookup = self.symbolize_keys(YAML::load_file(@cities_lookup_fn)) # force countries to be symbols
+      @cities_lookup.each { |key, value| @cities_lookup[key] = self.symbolize_keys(value) } # force states to be symbols
+    end
+
+    return nil if ! @cities_lookup.key?(country) || ! @cities_lookup[country].key?(state)
+    @cities_lookup[country][state]
+  end
+
+  def self.get_states_lookup(country)
+    # lookup file not loaded
+    if @states_lookup.nil?
+      @states_lookup_fn  = DEFAULT_STATES_LOOKUP_FN if @states_lookup_fn.nil?
+      @states_lookup_fn  = File.expand_path(@states_lookup_fn)
+      return nil if ! File.exists?(@states_lookup_fn)
+      @states_lookup = self.symbolize_keys(YAML::load_file(@states_lookup_fn)) # force countries to be symbols
+      @states_lookup.each { |key, value| @states_lookup[key] = self.symbolize_keys(value) } # force states to be symbols
+    end
+
+    return nil if ! @states_lookup.key?(country)
+    @states_lookup[country]
+  end
+
+  def self.get_countries_lookup
+    # lookup file not loaded
+    if @countries_lookup.nil?
+      @countries_lookup_fn  = DEFAULT_COUNTRIES_LOOKUP_FN if @countries_lookup_fn.nil?
+      @countries_lookup_fn  = File.expand_path(@countries_lookup_fn)
+      return nil if ! File.exists?(@countries_lookup_fn)
+      @countries_lookup = self.symbolize_keys(YAML::load_file(@countries_lookup_fn)) # force countries to be symbols
+    end
+
+    @countries_lookup
+  end
+
+  def self.states(country)
+    return {} if country.nil?
+
+    # Set it as current_country
+    self.current_country = country # set as current_country
+    country = self.current_country # normalized
+
+    # Load the country file
+    if self.blank?(@states[country])
+      states_fn = File.join(FILES_FOLDER, "states.#{country.to_s.downcase}")
+      self.install(country) if ! File.exists? states_fn
+      @states[country] = self.symbolize_keys(YAML::load_file(states_fn))
+      # Process lookup table
+      lookup = get_states_lookup(country)
+      if ! lookup.nil?
+        lookup.each do |key, value|
+          if value.nil? || self.blank?(value)
+            @states[country].delete(key)
+          else
+            @states[country][key] = value
+          end
+        end
+        @states[country] = @states[country].sort.to_h # sort it alphabetically
+      end
+    end
+
+    # Return list
+    @states[country] || {}
+  end
+
+  # list of all countries of the world (countries.yml)
+  def self.countries
+    if ! File.exists? COUNTRIES_FN
+      # countries.yml doesn't exists, extract from MAXMIND_DB
+      update_maxmind unless File.exists? MAXMIND_DB_FN
+
+      # reads CSV line by line
+      File.foreach(MAXMIND_DB_FN) do |line|
+        rec = line.split(",")
+        next if self.blank?(rec[COUNTRY]) || self.blank?(rec[COUNTRY_LONG]) # jump empty records
+        country = rec[COUNTRY].to_s.upcase.to_sym # normalize to something like :US, :BR
+        if self.blank?(@countries[country])
+          long = rec[COUNTRY_LONG].gsub(/\"/, "") # sometimes names come with a "\" char
+          @countries[country] = long
+        end
+      end
+
+      # sort and save to "countries.yml"
+      @countries = Hash[@countries.sort]
+      File.open(COUNTRIES_FN, "w") { |f| f.write @countries.to_yaml }
+      File.chmod(0666, COUNTRIES_FN) # force permissions to rw_rw_rw_ (issue #3)
+    else
+      # countries.yml exists, just read it
+      @countries = self.symbolize_keys(YAML::load_file(COUNTRIES_FN))
+    end
+
+    # Applies `countries-lookup.yml` if exists
+    lookup = self.get_countries_lookup()
+    if ! lookup.nil?
+      lookup.each do |key, value|
+        if value.nil? || self.blank?(value)
+          @countries.delete(key)
+        else
+          @countries[key] = value
+        end
+      end
+      @countries = @countries.sort.to_h # sort it alphabetically
+    end
+
+    # Return countries list
+    @countries
+  end
+
+  # get = countries, get(country) = states(country), get(country, state) = cities(state, country)
+  def self.get(country = nil, state = nil)
+    return self.countries if country.nil?
+    return self.states(country) if state.nil?
+    return self.cities(state, country)
+  end
+
+  # Emulates Rails' `blank?` method
+  def self.blank?(obj)
+    obj.respond_to?(:empty?) ? !!obj.empty? : !obj
+  end
+
+  # Emulates Rails' `present?` method
+  def self.present?(obj)
+    !self.blank?(obj)
+  end
+
+  # Emulates Rails' `symbolize_keys` method
+  def self.symbolize_keys(obj)
+    obj.transform_keys { |key| key.to_sym rescue key }
+  end
+end