countries 5.1.2 → 5.7.0

data/spec/country_spec.rb

@@ -3,7 +3,11 @@
 require 'spec_helper'
 NUM_OF_COUNTRIES = 249
 describe ISO3166::Country do
-  before { ISO3166.configuration.enable_currency_extension! }
+  before do
+    ISO3166::Data.reset
+    ISO3166.configuration.enable_currency_extension!
+  end
+
   let(:country) { ISO3166::Country.search('US') }
 
   it 'allows to create a country object from a symbol representation of the alpha2 code' do
@@ -48,9 +52,11 @@ describe ISO3166::Country do
   end
 
   it 'should return alternate names' do
-    expect(country.unofficial_names).to eq(['United States', 'USA', 'Murica',
-                                 'Vereinigte Staaten von Amerika', 'États-Unis',
-                                 'Estados Unidos', 'アメリカ合衆国', 'Verenigde Staten'])
+    expect(country.unofficial_names).to eq(['United States', 'USA',
+                                            'Vereinigte Staaten von Amerika',
+                                            'États-Unis', 'Estados Unidos',
+                                            'アメリカ合衆国', 'Verenigde Staten',
+                                            'Соединенные Штаты Америки'])
   end
 
   it 'should return translations' do
@@ -74,6 +80,10 @@ describe ISO3166::Country do
     expect(country.continent).to eq('North America')
   end
 
+  it 'should return distance unit' do
+    expect(country.distance_unit).to eq('MI')
+  end
+
   it 'knows about whether or not the country uses postal codes' do
     expect(country.zip).to be_truthy
   end
@@ -88,6 +98,7 @@ describe ISO3166::Country do
 
     regex = Regexp.new(country.postal_code_format)
     expect(regex).to match('12345-6789')
+    expect(regex).not_to match('12345-67890')
 
     antarctica = ISO3166::Country.search('AQ')
     expect(antarctica.postal_code_format).to be_nil
@@ -105,12 +116,20 @@ describe ISO3166::Country do
     expect(country.world_region).to eq('AMER')
   end
 
-  context 'with Turkey' do
+  context 'with Türkiye' do
     let(:country) { ISO3166::Country.search('TR') }
 
     it 'should indicate EMEA as the world region' do
       expect(country.world_region).to eq('EMEA')
     end
+
+    it 'has iso_short_name Türkiye' do
+      expect(country.iso_short_name).to eq('Türkiye')
+    end
+
+    it 'has iso_long_name Republic of Türkiye' do
+      expect(country.iso_long_name).to eq('The Republic of Türkiye')
+    end
   end
 
   context 'with Japan' do
@@ -139,7 +158,7 @@ describe ISO3166::Country do
         ISO3166::Data.register(
           alpha2: 'BR2',
           iso_short_name: 'Brazil',
-          languages_official: %w(pt-BR),
+          languages_official: %w[pt-BR],
           translations: {
             'pt-BR' => 'Translation for pt-BR',
             'pt' => 'Translation for pt'
@@ -163,7 +182,7 @@ describe ISO3166::Country do
         ISO3166::Data.register(
           alpha2: 'BR2',
           iso_short_name: 'Brazil',
-          languages_official: %w(pt-BR),
+          languages_official: %w[pt-BR],
           translations: {
             'pt' => 'Translation for pt'
           }
@@ -231,7 +250,7 @@ describe ISO3166::Country do
     end
 
     it '#states should be deprecated' do
-      expect {country.states}.to output.to_stderr
+      expect { country.states }.to output.to_stderr
     end
 
     it 'should be a subdivision object' do
@@ -252,54 +271,54 @@ describe ISO3166::Country do
   end
 
   describe 'subdivision_types' do
-    it "should return an array of subdivision types" do
+    it 'should return an array of subdivision types' do
       expect(country.subdivision_types).to contain_exactly('district', 'state', 'outlying_area')
     end
 
-    it "should return an array of subdivision types even if there is only a single type" do
+    it 'should return an array of subdivision types even if there is only a single type' do
       expect(ISO3166::Country['LI'].subdivision_types).to contain_exactly('commune')
     end
 
-    it "should return an empty array if country has no subdivisions" do
+    it 'should return an empty array if country has no subdivisions' do
       expect(ISO3166::Country['AS'].subdivisions?).to be_falsey
       expect(ISO3166::Country['AS'].subdivision_types).to eq([])
     end
   end
 
   describe 'subdivisions_of_types' do
-    it "given a single type, should return an array of subdivisions that match the type" do
+    it 'given a single type, should return an array of subdivisions that match the type' do
       us_states = country.subdivisions_of_types(%w[state])
       expect(us_states.size).to eq(50)
       dc = country.subdivisions_of_types(%w[district])
       expect(dc.size).to eq(1)
     end
 
-    it "given multiple types, should return an array of subdivisions matching the types" do
+    it 'given multiple types, should return an array of subdivisions matching the types' do
       us_states_plus_dc = country.subdivisions_of_types(%w[state district])
       expect(us_states_plus_dc.size).to eq(51)
     end
 
-    it "given multiple types where at least one does not exist for that country, should work without issue" do
+    it 'given multiple types where at least one does not exist for that country, should work without issue' do
       us_states_plus_dc = country.subdivisions_of_types(%w[state district governorate])
       expect(us_states_plus_dc.size).to eq(51)
     end
 
-    it "given only types that do not exist for that country, should return an empty collection" do
+    it 'given only types that do not exist for that country, should return an empty collection' do
       should_be_empty = ISO3166::Country['PT'].subdivisions_of_types(%w[state county])
       expect(should_be_empty).to be_empty
     end
   end
 
   describe 'humanized_subdivision_types' do
-    it "should return an array of humanized subdivision types" do
+    it 'should return an array of humanized subdivision types' do
       expect(country.humanized_subdivision_types).to contain_exactly('District', 'State', 'Outlying area')
     end
 
-    it "should return an array of subdivision types even if there is only a single type" do
+    it 'should return an array of subdivision types even if there is only a single type' do
       expect(ISO3166::Country['LI'].humanized_subdivision_types).to contain_exactly('Commune')
     end
 
-    it "should return an empty array if country has no subdivisions" do
+    it 'should return an empty array if country has no subdivisions' do
       expect(ISO3166::Country['AS'].subdivisions?).to be_falsey
       expect(ISO3166::Country['AS'].humanized_subdivision_types).to eq([])
     end
@@ -325,6 +344,26 @@ describe ISO3166::Country do
     end
   end
 
+  describe 'subdivision_names' do
+    it 'should return an alphabetized list of all subdivisions names' do
+      subdivisions = ISO3166::Country.search('EG').subdivision_names
+      expect(subdivisions).to be_an(Array)
+      expect(subdivisions.first).to be_a(String)
+      expect(subdivisions.size).to eq(27)
+      expect(subdivisions.first).to eq('Alexandria')
+    end
+
+    it 'should return an alphabetized list of subdivision names translated to current locale with codes' do
+      ISO3166.configuration.locales = %i[es de en]
+
+      subdivisions = ISO3166::Country.search('EG').subdivision_names(:es)
+      expect(subdivisions).to be_an(Array)
+      expect(subdivisions.first).to be_a(String)
+      expect(subdivisions.size).to eq(27)
+      expect(subdivisions.first).to eq('Al Iskandariyah')
+    end
+  end
+
   describe 'valid?' do
     it 'should return true if country is valid' do
       expect(ISO3166::Country.new('US')).to be_valid
@@ -602,6 +641,12 @@ describe ISO3166::Country do
       expect(spain_data.keys).to eq(['ES'])
     end
 
+    it 'finds country from a subdivision name' do
+      gb_data = ISO3166::Country.find_all_by(:subdivision_names, 'Scotland')
+      expect(gb_data).to be_a Hash
+      expect(gb_data.keys).to eq(['GB'])
+    end
+
     it 'performs reasonably' do
       start = Time.now
       250.times do
@@ -690,6 +735,13 @@ describe ISO3166::Country do
       end
     end
 
+    context "when search name in 'subdivision_names'" do
+      subject { ISO3166::Country.find_by_subdivision_names('Scotland') }
+      it 'should return' do
+        expect(subject.first).to eq('GB')
+      end
+    end
+
     context "when search name in 'translated_names'" do
       before do
         ISO3166.configure do |config|
@@ -814,13 +866,48 @@ describe ISO3166::Country do
       end
     end
 
-    context 'regression test for #388' do
-      let(:no_country) { ISO3166::Country.find_country_by_translated_names(nil) }
+    context 'sanity check for #771' do
+      let(:turkey) { ISO3166::Country.find_country_by_any_name('Turkey') }
 
       it 'should be a country instance' do
+        expect(turkey).to be_a(ISO3166::Country)
+        expect(turkey.alpha2).to eq('TR')
+      end
+    end
+
+    context 'regression test for #746' do
+      let(:no_country) { ISO3166::Country.find_country_by_any_name(nil) }
+
+      it 'should not be a country instance' do
+        expect(no_country).to_not be_a(ISO3166::Country)
+        expect(no_country).to eq nil
+      end
+    end
+
+    context 'regression test for #388/#746/#776' do
+      before do
+        ISO3166.configure do |config|
+          config.locales = %i[af am ar as az be bg bn br bs ca cs cy da de dz el en
+                              eo es et eu fa fi fo fr ga gl gu he hi hr hu hy ia id
+                              is it ja ka kk km kn ko ku lt lv mi mk ml mn mr ms mt
+                              nb ne nl nn oc or pa pl ps pt ro ru rw si sk sl so sq
+                              sr sv sw ta te th ti tk tl tr tt ug uk ve vi wa wo xh
+                              zh zu]
+        end
+      end
+
+      let(:no_country) { ISO3166::Country.find_country_by_translated_names(nil) }
+      let(:zimbabwe) { ISO3166::Country['ZW'] }
+
+      it 'should not be a country instance' do
         expect(no_country).to_not be_a(ISO3166::Country)
         expect(no_country).to eq nil
       end
+
+      it 'translated_names should not include nil values' do
+        expect(zimbabwe.translation('no')).to be_nil
+        expect(zimbabwe.translated_names).not_to include(nil)
+      end
     end
 
     context 'when attempting to search by translations hash' do
@@ -998,6 +1085,24 @@ describe ISO3166::Country do
     end
   end
 
+  describe 'gdpr_compliant?' do
+    let(:united_kigndom) { ISO3166::Country.search('GB') }
+    let(:france) { ISO3166::Country.search('FR') }
+    let(:mexico) { ISO3166::Country.search('MX') }
+
+    it 'should return false for countries without eea_member flag' do
+      expect(mexico.gdpr_compliant?).to be_falsey
+    end
+
+    it 'should return true for countries with eea_member flag set to true' do
+      expect(france.gdpr_compliant?).to be_truthy
+    end
+
+    it 'should return true for UK' do
+      expect(united_kigndom.gdpr_compliant?).to be_truthy
+    end
+  end
+
   describe 'in_esm?' do
     let(:netherlands) { ISO3166::Country.search('NL') }
     let(:switzerland) { ISO3166::Country.search('CH') }
@@ -1015,6 +1120,28 @@ describe ISO3166::Country do
     end
   end
 
+  describe 'in_eu_vat?' do
+    let(:netherlands) { ISO3166::Country.search('NL') }
+    let(:guadeloupe) { ISO3166::Country.search('GP') }
+    let(:monaco) { ISO3166::Country.search('MC') }
+
+    it 'should return false for countries without euvat_member or eu_member flag' do
+      expect(country.in_eu_vat?).to be_falsey
+    end
+
+    it 'should return true for countries with eu_member flag set to true' do
+      expect(netherlands.in_eu_vat?).to be_truthy
+    end
+
+    it 'should return false for countries with euvat_member flag set to false' do
+      expect(guadeloupe.in_eu_vat?).to be_falsey
+    end
+
+    it 'should return true for countries with euvat_member flag set to true' do
+      expect(monaco.in_eu_vat?).to be_truthy
+    end
+  end
+
   describe 'gec' do
     it 'should return the country\'s GEC code' do
       expect(ISO3166::Country.new('NA').gec).to eql 'WA'
@@ -1119,13 +1246,82 @@ describe ISO3166::Country do
       expect(subject.last).to be_empty
     end
 
-    context "when asking for alpha2, alpha3 and iso_short_name" do
-      let(:args) { [:alpha2, :alpha3, :iso_short_name] }
+    context 'when asking for alpha2, alpha3 and iso_short_name' do
+      let(:args) { %i[alpha2 alpha3 iso_short_name] }
 
       it 'returns the correct values' do
         expect(subject.first).to eq(%w[AD AND Andorra])
         expect(subject.last).to eq(%w[ZW ZWE Zimbabwe])
       end
     end
+
+    context 'with invalid attributes' do
+      let(:args) { %i[alpha2 bad_attribute] }
+
+      it 'should raise an error' do
+        expect { subject }.to(
+          raise_error(KeyError, 'key not found: "bad_attribute"')
+        )
+      end
+    end
+  end
+
+  describe 'find_subdivision_by_name' do
+    let(:italy) { ISO3166::Country.new('IT') }
+    let(:napoli) { italy.subdivisions['NA'] }
+
+    before do
+      ISO3166.configuration.locales = %i[pt]
+    end
+
+    it 'should find a subdivision using the official name' do
+      expect(ISO3166::Country.new('IT').find_subdivision_by_name('Napoli')).to eq napoli
+    end
+
+    it 'should find a subdivision using the code' do
+      expect(ISO3166::Country.new('IT').find_subdivision_by_name('NA')).to eq napoli
+    end
+
+    it 'should find a subdivision using a translated name' do
+      expect(ISO3166::Country.new('IT').find_subdivision_by_name('Nápoles')).to eq napoli
+    end
+  end
+
+  describe 'collect_countries_with' do
+    let(:italy) { ISO3166::Country.new('IT') }
+    let(:vatican) { ISO3166::Country.new('VA') }
+    let(:san_marino) { ISO3166::Country.new('SM') }
+    let(:switzerland) { ISO3166::Country.new('CH') }
+    let(:seychelles) { ISO3166::Country.new('SC') }
+
+    it 'defaults to querying alpha2 and returning the countries' do
+      expect(ISO3166::Country.collect_countries_with('IT')).to eq [italy]
+    end
+
+    it 'allows querying by other attributes' do
+      expect(ISO3166::Country.collect_countries_with('🇸🇨', :emoji_flag)).to eq [seychelles]
+      expect(ISO3166::Country.collect_countries_with('it',
+                                                     :languages_spoken)).to eq [switzerland, italy, san_marino, vatican]
+    end
+
+    it 'allows applying a method to the result set' do
+      expect(ISO3166::Country.collect_countries_with('Caribbean', :subregion,
+                                                     :languages_spoken).flatten.uniq).to eq %w[en nl fr es ht]
+    end
+  end
+
+  describe 'collect_likely_countries_by_subdivision_name' do
+    let(:costa_rica) { ISO3166::Country.new('CR') }
+    let(:uruguay) { ISO3166::Country.new('UY') }
+
+    it 'defaults to returning the countries' do
+      expect(ISO3166::Country.collect_likely_countries_by_subdivision_name('San José')).to eq [costa_rica, uruguay]
+    end
+
+    it 'allows applying a method to the result set' do
+      expect(ISO3166::Country.collect_likely_countries_by_subdivision_name('San José',
+                                                                           :iso_short_name)).to eq ['Costa Rica',
+                                                                                                    'Uruguay']
+    end
   end
 end

data/spec/data_spec.rb

@@ -128,7 +128,7 @@ describe ISO3166::Data do
 
     it 'can be done' do
       data = ISO3166::Data.new('TW').call
-      ISO3166.configuration.locales = [:es, :de, :de]
+      ISO3166.configuration.locales = %i[es de de]
       expect(data['iso_short_name']).to eq 'NEW Taiwan'
       expect(subject.iso_short_name).to eq 'NEW Taiwan'
       expect(subject.translations).to eq('en' => 'NEW Taiwan',
@@ -205,18 +205,18 @@ describe ISO3166::Data do
       it 'has a non-blank code for all subdivisions' do
         Dir['lib/countries/data/subdivisions/*.yaml'].each do |file|
           data = YAML.load_file(file)
-          expect(data.values.none?{|s| s['code'].nil? }).to be_truthy, "empty subdivision code in #{file}"
+          expect(data.values.none? { |s| s['code'].nil? }).to be_truthy, "empty subdivision code in #{file}"
         end
       end
 
       it 'has a non-blank, lowercase and snake_case type for all subdivisions' do
         Dir['lib/countries/data/subdivisions/*.yaml'].each do |file|
           data = YAML.load_file(file)
-          no_type = data.select{|k,v| v['type'].nil? }
+          no_type = data.select { |_k, v| v['type'].nil? }
           expect(no_type).to be_empty, "empty subdivision type in #{file} - #{no_type.keys}"
-          uppercase = data.select{|k,v| v['type'] =~ /[A-Z]/ }
+          uppercase = data.select { |_k, v| v['type'] =~ /[A-Z]/ }
           expect(uppercase).to be_empty, "uppercase characters in subdivision type in #{file} - #{uppercase.keys}"
-          spaces = data.select{|k,v| v['type'] =~ /\s/ }
+          spaces = data.select { |_k, v| v['type'] =~ /\s/ }
           expect(spaces).to be_empty, "whitespace characters in subdivision type in #{file} - #{spaces.keys}"
         end
       end
@@ -224,7 +224,7 @@ describe ISO3166::Data do
       it 'has a non-blank name for all subdivisions' do
         Dir['lib/countries/data/subdivisions/*.yaml'].each do |file|
           data = YAML.load_file(file)
-          expect(data.values.none?{|s| s['name'].nil? }).to be_truthy, "empty subdivision name in #{file}"
+          expect(data.values.none? { |s| s['name'].nil? }).to be_truthy, "empty subdivision name in #{file}"
         end
       end
     end
@@ -232,13 +232,17 @@ describe ISO3166::Data do
     context 'cached country subdivision data' do
       it 'has a non-blank code for all subdivisions' do
         ISO3166::Country.all.each do |country|
-          expect(country.subdivisions.values.none?{|s| s['code'].nil? }).to be_truthy, "empty subdivision code in #{country}"
+          expect(country.subdivisions.values.none? do |s|
+                   s['code'].nil?
+                 end).to be_truthy, "empty subdivision code in #{country}"
         end
       end
 
       it 'has a non-blank name for all subdivisions' do
         ISO3166::Country.all.each do |country|
-          expect(country.subdivisions.values.none?{|s| s['name'].nil? }).to be_truthy, "empty subdivision name in #{country}"
+          expect(country.subdivisions.values.none? do |s|
+                   s['name'].nil?
+                 end).to be_truthy, "empty subdivision name in #{country}"
         end
       end
     end

data/spec/spec_helper.rb

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 
 require 'countries'
+require 'debug'
+require 'simplecov'
+SimpleCov.start
+
 RSpec.configure do |config|
   config.filter_run :focus
   config.run_all_when_everything_filtered = true

data/spec/subdivision_spec.rb

@@ -31,4 +31,12 @@ describe ISO3166::Subdivision do
       end
     end
   end
+
+  describe 'code_with_translations' do
+    before { ISO3166.configuration.locales = %i[en pt] }
+    it 'returns a hash' do
+      expect(ISO3166::Country.new('IT').subdivisions['NA'].code_with_translations).to eq({ 'NA' => { 'en' => 'Naples',
+                                                                                                     'pt' => 'Nápoles' } })
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: countries
 version: !ruby/object:Gem::Version
-  version: 5.1.2
+  version: 5.7.0
 platform: ruby
 authors:
 - Josh Robinson
@@ -11,22 +11,22 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-11 00:00:00.000000000 Z
+date: 2023-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: sixarm_ruby_unaccent
+  name: unaccent
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
@@ -69,6 +69,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '3'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
 description: All sorts of useful information about every country packaged as pretty
   little country objects. It includes data from ISO 3166
 email:
@@ -79,16 +93,18 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".codeclimate.yml"
+- ".github/FUNDING.yml"
 - ".github/workflows/codeql-analysis.yml"
 - ".github/workflows/tests.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
-- ".rubocop_todo.yml"
 - CHANGELOG.md
 - Gemfile
+- Gemfile.lock
 - LICENSE
-- README.markdown
+- README.md
 - Rakefile
 - UPGRADE.md
 - bin/console
@@ -229,6 +245,7 @@ files:
 - lib/countries/configuration.rb
 - lib/countries/country.rb
 - lib/countries/country/class_methods.rb
+- lib/countries/country/country_subdivision_methods.rb
 - lib/countries/country/currency_methods.rb
 - lib/countries/country/emoji.rb
 - lib/countries/country/finder_methods.rb
@@ -482,6 +499,8 @@ files:
 - lib/countries/data/countries/ZA.yaml
 - lib/countries/data/countries/ZM.yaml
 - lib/countries/data/countries/ZW.yaml
+- lib/countries/data/locales_methods.rb
+- lib/countries/data/subdivision_methods.rb
 - lib/countries/data/subdivisions/AD.yaml
 - lib/countries/data/subdivisions/AE.yaml
 - lib/countries/data/subdivisions/AF.yaml
@@ -815,7 +834,6 @@ files:
 - lib/countries/data/translations/countries-zu.yaml
 - lib/countries/global.rb
 - lib/countries/iso3166.rb
-- lib/countries/kwarg_struct.rb
 - lib/countries/mongoid.rb
 - lib/countries/sources.rb
 - lib/countries/sources/cldr/downloader.rb
@@ -825,7 +843,6 @@ files:
 - lib/countries/sources/local/subdivision.rb
 - lib/countries/structure.rb
 - lib/countries/subdivision.rb
-- lib/countries/tasks/geocoding.rake
 - lib/countries/tasks/postal_codes.rake
 - lib/countries/timezones.rb
 - lib/countries/translations.rb
@@ -864,18 +881,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: Gives you a country object full of all sorts of useful information.
-test_files:
-- spec/00_global_spec.rb
-- spec/configuration_spec.rb
-- spec/country_spec.rb
-- spec/data_spec.rb
-- spec/mongoid_spec.rb
-- spec/perf_spec.rb
-- spec/spec_helper.rb
-- spec/subdivision_spec.rb
-- spec/thread_safety_spec.rb
-- spec/timezone_spec.rb
+test_files: []

data/.rubocop_todo.yml

@@ -1,19 +0,0 @@
-# This configuration was generated by
-# `rubocop --auto-gen-config`
-# on 2022-01-07 11:03:11 UTC using RuboCop version 1.24.1.
-# The point is for the user to remove these configuration records
-# one by one as the offenses are removed from the code base.
-# Note that changes in the inspected code, or installation of new
-# versions of RuboCop, may require this file to be generated again.
-
-
-# Offense count: 3
-# Configuration parameters: IgnoredMethods, CountRepeatedAttributes.
-Metrics/AbcSize:
-  Max: 33
-
-# Enable after the doc branch is merged
-Style/Documentation:
-  Enabled: false
-  # Exclude:
-  #   - 'spec/**/*'

data/lib/countries/kwarg_struct.rb

@@ -1,14 +0,0 @@
-# frozen_string_literal: true
-
-module ISO3166
-  class KwargStruct < Struct
-    # Override the initialize to handle hashes of named parameters
-    def initialize(*args)
-      opts = args.last.is_a?(Hash) ? args.pop : {}
-      super(*args)
-      opts.each_pair do |k, v|
-        send "#{k}=", v
-      end
-    end
-  end
-end