iso_country_codes 0.3.1 → 0.4.0

data/History.txt

@@ -1,3 +1,9 @@
+=== 0.4.0 / 2013-01-29
+
+* Added country calling codes, which may be accessed with the `calling` instance method
+* Added `search_by_name`, `search_by_currency` and `search_by_calling_code` methods
+* `:fuzzy` option on `find` is deprecated (use the `search_by_name` method instead)
+
 === 0.3.1 / 2013-01-28
 
 * Updated with the latest data from Wikipedia

data/README.rdoc

@@ -6,7 +6,8 @@ Provides ISO codes, names and currencies for countries.
 
 == FEATURES:
 
-* Search by name or code (alpha-2, alpha-3 or numeric)
+* Find by alpha-2, alpha-3 or numeric codes
+* Search by name, currency code or calling/dialing code
 
 == SYNOPSIS:
 
@@ -16,17 +17,17 @@ Provides ISO codes, names and currencies for countries.
   code.numeric # => "036"
   code.alpha2  # => "AU"
   code.alpha3  # => "AUS"
+  code.calling # => "+61"
 
   # Codes can be found via numeric, alpha-2 or alpha-3 format
   IsoCountryCodes.find(36)
   IsoCountryCodes.find('au')
   IsoCountryCodes.find('aus')
 
-  # Codes can be found by country name
-  IsoCountryCodes.find('australia')
-
-  # Inexact matches can also be found
-  IsoCountryCodes.find('united', :fuzzy => true).name # => 'United Kingdom'
+  # Codes can also be returned by searching country name, currency or calling/dialing code
+  IsoCountryCodes.search_by_name('australia')
+  IsoCountryCodes.search_by_currency('aud')
+  IsoCountryCodes.search_by_calling_code('+61')
 
   # Fetch a country's local currency
   IsoCountryCodes.find('aus').currency # => "AUD"

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
-:patch: 1
+:minor: 4
+:patch: 0
 :major: 0
-:minor: 3

data/iso_country_codes.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{iso_country_codes}
-  s.version = "0.3.1"
+  s.version = "0.4.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["alex"]
-  s.date = %q{2013-01-28}
+  s.date = %q{2013-01-29}
   s.description = %q{ISO country code and currency library}
   s.email = %q{alexrabarts@gmail.com}
   s.extra_rdoc_files = [
@@ -26,6 +26,7 @@ Gem::Specification.new do |s|
      "VERSION.yml",
      "iso_country_codes.gemspec",
      "lib/iso_country_codes.rb",
+     "lib/iso_country_codes/calling.rb",
      "lib/iso_country_codes/code.rb",
      "lib/iso_country_codes/iso_3166_1.rb",
      "lib/iso_country_codes/iso_4217.rb",

data/lib/iso_country_codes.rb

@@ -4,4 +4,5 @@ $LOAD_PATH << dir unless $LOAD_PATH.include?(dir)
 require 'iso_country_codes/code'
 require 'iso_country_codes/iso_3166_1'
 require 'iso_country_codes/iso_4217'
+require 'iso_country_codes/calling'
 require 'iso_country_codes/iso_country_codes'

data/lib/iso_country_codes/calling.rb

@@ -0,0 +1,751 @@
+class IsoCountryCodes
+  class Code
+    class GBR < Code #:nodoc:
+      self.calling = '+44'
+    end
+    class FJI < Code #:nodoc:
+      self.calling = '+679'
+    end
+    class BLM < Code #:nodoc:
+      self.calling = '+590'
+    end
+    class RUS < Code #:nodoc:
+      self.calling = '+7'
+    end
+    class JOR < Code #:nodoc:
+      self.calling = '+962'
+    end
+    class GEO < Code #:nodoc:
+      self.calling = '+995'
+    end
+    class ATF < Code #:nodoc:
+      self.calling = '+689'
+    end
+    class ECU < Code #:nodoc:
+      self.calling = '+593'
+    end
+    class TWN < Code #:nodoc:
+      self.calling = '+886'
+    end
+    class ZWE < Code #:nodoc:
+      self.calling = '+263'
+    end
+    class ATG < Code #:nodoc:
+      self.calling = '+268'
+    end
+    class IDN < Code #:nodoc:
+      self.calling = '+62'
+    end
+    class BOL < Code #:nodoc:
+      self.calling = '+591'
+    end
+    class NPL < Code #:nodoc:
+      self.calling = '+977'
+    end
+    class DEU < Code #:nodoc:
+      self.calling = '+49'
+    end
+    class MLT < Code #:nodoc:
+      self.calling = '+356'
+    end
+    class TGO < Code #:nodoc:
+      self.calling = '+228'
+    end
+    class SRB < Code #:nodoc:
+      self.calling = '+381'
+    end
+    class TJK < Code #:nodoc:
+      self.calling = '+992'
+    end
+    class REU < Code #:nodoc:
+      self.calling = '+262'
+    end
+    class DNK < Code #:nodoc:
+      self.calling = '+45'
+    end
+    class LAO < Code #:nodoc:
+      self.calling = '+856'
+    end
+    class POL < Code #:nodoc:
+      self.calling = '+48'
+    end
+    class BLR < Code #:nodoc:
+      self.calling = '+375'
+    end
+    class PRI < Code #:nodoc:
+      self.calling = '+787'
+    end
+    class GAB < Code #:nodoc:
+      self.calling = '+241'
+    end
+    class TCA < Code #:nodoc:
+      self.calling = '+649'
+    end
+    class NIC < Code #:nodoc:
+      self.calling = '+505'
+    end
+    class RWA < Code #:nodoc:
+      self.calling = '+250'
+    end
+    class SYR < Code #:nodoc:
+      self.calling = '+963'
+    end
+    class URY < Code #:nodoc:
+      self.calling = '+598'
+    end
+    class NCL < Code #:nodoc:
+      self.calling = '+687'
+    end
+    class VCT < Code #:nodoc:
+      self.calling = '+784'
+    end
+    class PRK < Code #:nodoc:
+      self.calling = '+850'
+    end
+    class ZMB < Code #:nodoc:
+      self.calling = '+260'
+    end
+    class MKD < Code #:nodoc:
+      self.calling = '+389'
+    end
+    class CUW < Code #:nodoc:
+      self.calling = '+599'
+    end
+    class SXM < Code #:nodoc:
+      self.calling = '+599'
+    end
+    class SSD < Code #:nodoc:
+      self.calling = '+211'
+    end
+    class BES < Code #:nodoc:
+      self.calling = '+599'
+    end
+    class AZE < Code #:nodoc:
+      self.calling = '+994'
+    end
+    class BRN < Code #:nodoc:
+      self.calling = '+673'
+    end
+    class CMR < Code #:nodoc:
+      self.calling = '+237'
+    end
+    class ERI < Code #:nodoc:
+      self.calling = '+291'
+    end
+    class TCD < Code #:nodoc:
+      self.calling = '+235'
+    end
+    class DZA < Code #:nodoc:
+      self.calling = '+213'
+    end
+    class CCK < Code #:nodoc:
+      self.calling = '+891'
+    end
+    class NFK < Code #:nodoc:
+      self.calling = '+672'
+    end
+    class SOM < Code #:nodoc:
+      self.calling = '+252'
+    end
+    class GUY < Code #:nodoc:
+      self.calling = '+592'
+    end
+    class MRT < Code #:nodoc:
+      self.calling = '+222'
+    end
+    class NLD < Code #:nodoc:
+      self.calling = '+31'
+    end
+    class PLW < Code #:nodoc:
+      self.calling = '+680'
+    end
+    class VIR < Code #:nodoc:
+      self.calling = '+340'
+    end
+    class BEL < Code #:nodoc:
+      self.calling = '+32'
+    end
+    class MHL < Code #:nodoc:
+      self.calling = '+692'
+    end
+    class UKR < Code #:nodoc:
+      self.calling = '+380'
+    end
+    class UGA < Code #:nodoc:
+      self.calling = '+256'
+    end
+    class LTU < Code #:nodoc:
+      self.calling = '+370'
+    end
+    class MNE < Code #:nodoc:
+      self.calling = '+382'
+    end
+    class BLZ < Code #:nodoc:
+      self.calling = '+501'
+    end
+    class MOZ < Code #:nodoc:
+      self.calling = '+258'
+    end
+    class MUS < Code #:nodoc:
+      self.calling = '+230'
+    end
+    class IMN < Code #:nodoc:
+      self.calling = '+44'
+    end
+    class DMA < Code #:nodoc:
+      self.calling = '+767'
+    end
+    class BEN < Code #:nodoc:
+      self.calling = '+229'
+    end
+    class SLV < Code #:nodoc:
+      self.calling = '+503'
+    end
+    class LCA < Code #:nodoc:
+      self.calling = '+758'
+    end
+    class GNQ < Code #:nodoc:
+      self.calling = '+240'
+    end
+    class MNG < Code #:nodoc:
+      self.calling = '+976'
+    end
+    class UZB < Code #:nodoc:
+      self.calling = '+998'
+    end
+    class CPV < Code #:nodoc:
+      self.calling = '+238'
+    end
+    class JEY < Code #:nodoc:
+      self.calling = '+44'
+    end
+    class KIR < Code #:nodoc:
+      self.calling = '+686'
+    end
+    class PRT < Code #:nodoc:
+      self.calling = '+351'
+    end
+    class MAC < Code #:nodoc:
+      self.calling = '+853'
+    end
+    class AGO < Code #:nodoc:
+      self.calling = '+244'
+    end
+    class FSM < Code #:nodoc:
+      self.calling = '+691'
+    end
+    class PHL < Code #:nodoc:
+      self.calling = '+63'
+    end
+    class LVA < Code #:nodoc:
+      self.calling = '+371'
+    end
+    class COD < Code #:nodoc:
+      self.calling = '+243'
+    end
+    class CYM < Code #:nodoc:
+      self.calling = '+345'
+    end
+    class MDA < Code #:nodoc:
+      self.calling = '+373'
+    end
+    class DJI < Code #:nodoc:
+      self.calling = '+253'
+    end
+    class PER < Code #:nodoc:
+      self.calling = '+51'
+    end
+    class MAF < Code #:nodoc:
+      self.calling = '+590'
+    end
+    class GTM < Code #:nodoc:
+      self.calling = '+502'
+    end
+    class ISL < Code #:nodoc:
+      self.calling = '+354'
+    end
+    class PNG < Code #:nodoc:
+      self.calling = '+675'
+    end
+    class SEN < Code #:nodoc:
+      self.calling = '+221'
+    end
+    class GMB < Code #:nodoc:
+      self.calling = '+220'
+    end
+    class JAM < Code #:nodoc:
+      self.calling = '+876'
+    end
+    class COG < Code #:nodoc:
+      self.calling = '+242'
+    end
+    class CYP < Code #:nodoc:
+      self.calling = '+357'
+    end
+    class PRY < Code #:nodoc:
+      self.calling = '+595'
+    end
+    class MEX < Code #:nodoc:
+      self.calling = '+52'
+    end
+    class WSM < Code #:nodoc:
+      self.calling = '+685'
+    end
+    class BHR < Code #:nodoc:
+      self.calling = '+973'
+    end
+    class HUN < Code #:nodoc:
+      self.calling = '+36'
+    end
+    class BHS < Code #:nodoc:
+      self.calling = '+242'
+    end
+    class SUR < Code #:nodoc:
+      self.calling = '+597'
+    end
+    class OMN < Code #:nodoc:
+      self.calling = '+968'
+    end
+    class CUB < Code #:nodoc:
+      self.calling = '+53'
+    end
+    class KOR < Code #:nodoc:
+      self.calling = '+82'
+    end
+    class MDG < Code #:nodoc:
+      self.calling = '+261'
+    end
+    class FRA < Code #:nodoc:
+      self.calling = '+33'
+    end
+    class SHN < Code #:nodoc:
+      self.calling = '+290'
+    end
+    class MNP < Code #:nodoc:
+      self.calling = '+670'
+    end
+    class NIU < Code #:nodoc:
+      self.calling = '+683'
+    end
+    class BWA < Code #:nodoc:
+      self.calling = '+267'
+    end
+    class VEN < Code #:nodoc:
+      self.calling = '+58'
+    end
+    class HKG < Code #:nodoc:
+      self.calling = '+852'
+    end
+    class HND < Code #:nodoc:
+      self.calling = '+504'
+    end
+    class COK < Code #:nodoc:
+      self.calling = '+682'
+    end
+    class ISR < Code #:nodoc:
+      self.calling = '+972'
+    end
+    class FIN < Code #:nodoc:
+      self.calling = '+358'
+    end
+    class AIA < Code #:nodoc:
+      self.calling = '+264'
+    end
+    class KNA < Code #:nodoc:
+      self.calling = '+869'
+    end
+    class LIE < Code #:nodoc:
+      self.calling = '+423'
+    end
+    class FLK < Code #:nodoc:
+      self.calling = '+500'
+    end
+    class HRV < Code #:nodoc:
+      self.calling = '+385'
+    end
+    class COL < Code #:nodoc:
+      self.calling = '+57'
+    end
+    class CRI < Code #:nodoc:
+      self.calling = '+506'
+    end
+    class WLF < Code #:nodoc:
+      self.calling = '+681'
+    end
+    class BGD < Code #:nodoc:
+      self.calling = '+880'
+    end
+    class LSO < Code #:nodoc:
+      self.calling = '+266'
+    end
+    class MWI < Code #:nodoc:
+      self.calling = '+265'
+    end
+    class COM < Code #:nodoc:
+      self.calling = '+269'
+    end
+    class UMI < Code #:nodoc:
+      self.calling = '+1'
+    end
+    class USA < Code #:nodoc:
+      self.calling = '+1'
+    end
+    class KEN < Code #:nodoc:
+      self.calling = '+254'
+    end
+    class AFG < Code #:nodoc:
+      self.calling = '+93'
+    end
+    class ASM < Code #:nodoc:
+      self.calling = '+684'
+    end
+    class CIV < Code #:nodoc:
+      self.calling = '+225'
+    end
+    class NOR < Code #:nodoc:
+      self.calling = '+47'
+    end
+    class PAK < Code #:nodoc:
+      self.calling = '+92'
+    end
+    class YEM < Code #:nodoc:
+      self.calling = '+967'
+    end
+    class VUT < Code #:nodoc:
+      self.calling = '+678'
+    end
+    class ALA < Code #:nodoc:
+      self.calling = '+358'
+    end
+    class BDI < Code #:nodoc:
+      self.calling = '+257'
+    end
+    class MAR < Code #:nodoc:
+      self.calling = '+212'
+    end
+    class ALB < Code #:nodoc:
+      self.calling = '+355'
+    end
+    class KHM < Code #:nodoc:
+      self.calling = '+855'
+    end
+    class ETH < Code #:nodoc:
+      self.calling = '+251'
+    end
+    class PAN < Code #:nodoc:
+      self.calling = '+507'
+    end
+    class CHE < Code #:nodoc:
+      self.calling = '+41'
+    end
+    class MTQ < Code #:nodoc:
+      self.calling = '+596'
+    end
+    class BTN < Code #:nodoc:
+      self.calling = '+975'
+    end
+    class THA < Code #:nodoc:
+      self.calling = '+66'
+    end
+    class SWE < Code #:nodoc:
+      self.calling = '+46'
+    end
+    class TON < Code #:nodoc:
+      self.calling = '+676'
+    end
+    class VNM < Code #:nodoc:
+      self.calling = '+84'
+    end
+    class GGY < Code #:nodoc:
+      self.calling = '+1481'
+    end
+    class TLS < Code #:nodoc:
+      self.calling = '+670'
+    end
+    class NRU < Code #:nodoc:
+      self.calling = '+674'
+    end
+    class VGB < Code #:nodoc:
+      self.calling = '+284'
+    end
+    class GIB < Code #:nodoc:
+      self.calling = '+350'
+    end
+    class NER < Code #:nodoc:
+      self.calling = '+277'
+    end
+    class HTI < Code #:nodoc:
+      self.calling = '+509'
+    end
+    class MDV < Code #:nodoc:
+      self.calling = '+960'
+    end
+    class FRO < Code #:nodoc:
+      self.calling = '+298'
+    end
+    class CHL < Code #:nodoc:
+      self.calling = '+56'
+    end
+    class SDN < Code #:nodoc:
+      self.calling = '+249'
+    end
+    class IRL < Code #:nodoc:
+      self.calling = '+353'
+    end
+    class ARE < Code #:nodoc:
+      self.calling = '+971'
+    end
+    class CHN < Code #:nodoc:
+      self.calling = '+86'
+    end
+    class STP < Code #:nodoc:
+      self.calling = '+239'
+    end
+    class JPN < Code #:nodoc:
+      self.calling = '+81'
+    end
+    class TUN < Code #:nodoc:
+      self.calling = '+216'
+    end
+    class BGR < Code #:nodoc:
+      self.calling = '+359'
+    end
+    class IRN < Code #:nodoc:
+      self.calling = '+98'
+    end
+    class ARG < Code #:nodoc:
+      self.calling = '+54'
+    end
+    class CXR < Code #:nodoc:
+      self.calling = '+61'
+    end
+    class IOT < Code #:nodoc:
+      self.calling = '+246'
+    end
+    class SAU < Code #:nodoc:
+      self.calling = '+966'
+    end
+    class NGA < Code #:nodoc:
+      self.calling = '+234'
+    end
+    class HMD < Code #:nodoc:
+      self.calling = '+61'
+    end
+    class IRQ < Code #:nodoc:
+      self.calling = '+964'
+    end
+    class BFA < Code #:nodoc:
+      self.calling = '+226'
+    end
+    class TUR < Code #:nodoc:
+      self.calling = '+90'
+    end
+    class MMR < Code #:nodoc:
+      self.calling = '+95'
+    end
+    class PSE < Code #:nodoc:
+      self.calling = '+970'
+    end
+    class SGP < Code #:nodoc:
+      self.calling = '+65'
+    end
+    class CAF < Code #:nodoc:
+      self.calling = '+236'
+    end
+    class LKA < Code #:nodoc:
+      self.calling = '+94'
+    end
+    class SJM < Code #:nodoc:
+      self.calling = '+47'
+    end
+    class IND < Code #:nodoc:
+      self.calling = '+91'
+    end
+    class VAT < Code #:nodoc:
+      self.calling = '+379'
+    end
+    class LBN < Code #:nodoc:
+      self.calling = '+961'
+    end
+    class TKL < Code #:nodoc:
+      self.calling = '+690'
+    end
+    class GIN < Code #:nodoc:
+      self.calling = '+225'
+    end
+    class NAM < Code #:nodoc:
+      self.calling = '+264'
+    end
+    class SGS < Code #:nodoc:
+      self.calling = '+500'
+    end
+    class ARM < Code #:nodoc:
+      self.calling = '+374'
+    end
+    class GRC < Code #:nodoc:
+      self.calling = '+30'
+    end
+    class TUV < Code #:nodoc:
+      self.calling = '+688'
+    end
+    class TKM < Code #:nodoc:
+      self.calling = '+993'
+    end
+    class GRD < Code #:nodoc:
+      self.calling = '+473'
+    end
+    class DOM < Code #:nodoc:
+      self.calling = '+809'
+    end
+    class ESH < Code #:nodoc:
+      self.calling = '+212'
+    end
+    class LBR < Code #:nodoc:
+      self.calling = '+231'
+    end
+    class MCO < Code #:nodoc:
+      self.calling = '+355'
+    end
+    class ITA < Code #:nodoc:
+      self.calling = '+39'
+    end
+    class BMU < Code #:nodoc:
+      self.calling = '+441'
+    end
+    class EGY < Code #:nodoc:
+      self.calling = '+20'
+    end
+    class PYF < Code #:nodoc:
+      self.calling = '+689'
+    end
+    class CAN < Code #:nodoc:
+      self.calling = '+1'
+    end
+    class MSR < Code #:nodoc:
+      self.calling = '+664'
+    end
+    class SWZ < Code #:nodoc:
+      self.calling = '+268'
+    end
+    class CZE < Code #:nodoc:
+      self.calling = '+420'
+    end
+    class GLP < Code #:nodoc:
+      self.calling = '+590'
+    end
+    class SPM < Code #:nodoc:
+      self.calling = '+508'
+    end
+    class SYC < Code #:nodoc:
+      self.calling = '+248'
+    end
+    class PCN < Code #:nodoc:
+      self.calling = '+872'
+    end
+    class SMR < Code #:nodoc:
+      self.calling = '+378'
+    end
+    class GUF < Code #:nodoc:
+      self.calling = '+594'
+    end
+    class TZA < Code #:nodoc:
+      self.calling = '+255'
+    end
+    class GHA < Code #:nodoc:
+      self.calling = '+233'
+    end
+    class AND < Code #:nodoc:
+      self.calling = '+376'
+    end
+    class BIH < Code #:nodoc:
+      self.calling = '+387'
+    end
+    class KAZ < Code #:nodoc:
+      self.calling = '+7'
+    end
+    class KWT < Code #:nodoc:
+      self.calling = '+965'
+    end
+    class MLI < Code #:nodoc:
+      self.calling = '+223'
+    end
+    class NZL < Code #:nodoc:
+      self.calling = '+64'
+    end
+    class GRL < Code #:nodoc:
+      self.calling = '+299'
+    end
+    class AUS < Code #:nodoc:
+      self.calling = '+61'
+    end
+    class LBY < Code #:nodoc:
+      self.calling = '+218'
+    end
+    class ROU < Code #:nodoc:
+      self.calling = '+40'
+    end
+    class ABW < Code #:nodoc:
+      self.calling = '+297'
+    end
+    class ESP < Code #:nodoc:
+      self.calling = '+34'
+    end
+    class SLB < Code #:nodoc:
+      self.calling = '+677'
+    end
+    class LUX < Code #:nodoc:
+      self.calling = '+352'
+    end
+    class AUT < Code #:nodoc:
+      self.calling = '+43'
+    end
+    class BRA < Code #:nodoc:
+      self.calling = '+55'
+    end
+    class SVK < Code #:nodoc:
+      self.calling = '+421'
+    end
+    class QAT < Code #:nodoc:
+      self.calling = '+974'
+    end
+    class ATA < Code #:nodoc:
+      self.calling = '+672'
+    end
+    class ZAF < Code #:nodoc:
+      self.calling = '+27'
+    end
+    class BRB < Code #:nodoc:
+      self.calling = '+246'
+    end
+    class GUM < Code #:nodoc:
+      self.calling = '+671'
+    end
+    class MYS < Code #:nodoc:
+      self.calling = '+60'
+    end
+    class TTO < Code #:nodoc:
+      self.calling = '+868'
+    end
+    class SLE < Code #:nodoc:
+      self.calling = '+232'
+    end
+    class SVN < Code #:nodoc:
+      self.calling = '+386'
+    end
+    class BVT < Code #:nodoc:
+      self.calling = '+47'
+    end
+    class MYT < Code #:nodoc:
+      self.calling = '+262'
+    end
+    class KGZ < Code #:nodoc:
+      self.calling = '+996'
+    end
+    class EST < Code #:nodoc:
+      self.calling = '+372'
+    end
+    class GNB < Code #:nodoc:
+      self.calling = '+245'
+    end
+  end # end Code
+end # IsoCountryCodes

data/lib/iso_country_codes/code.rb

@@ -20,6 +20,14 @@ class IsoCountryCodes
       self.class.alpha3
     end
 
+    def calling
+      self.class.calling
+    end
+
+    def calling_code
+      self.class.calling_code
+    end
+
     def main_currency
       self.class.main_currency
     end
@@ -33,9 +41,10 @@ class IsoCountryCodes
     end
 
     class << self
-      attr_accessor :name, :numeric, :alpha2, :alpha3, :main_currency
+      attr_accessor :name, :numeric, :alpha2, :alpha3, :calling, :main_currency
       attr_writer :currencies
       alias_method :currency, :main_currency
+      alias_method :calling_code, :calling
 
       @@codes = []
       def inherited(code) #:nodoc:

data/lib/iso_country_codes/iso_country_codes.rb

@@ -11,7 +11,7 @@ class IsoCountryCodes # :nodoc:
       Code.all
     end
 
-    def find(code, opts={})
+    def find(code)
       code     = code.to_s.upcase
       instance = nil
 
@@ -25,17 +25,47 @@ class IsoCountryCodes # :nodoc:
         instance = all.select { |c| c.alpha2 == code }.first
       elsif code.match(/^[A-Z]{3}$/)
         instance = all.select { |c| c.alpha3 == code }.first
-      else
-        instance = all.select { |c| c.name.upcase == code }.first
-        if opts[:fuzzy]
-          instance = all.select { |c| c.name.match(/^#{code}/i) }.first if instance.nil?
-          instance = all.select { |c| c.name.match(/#{code}/i) }.first if instance.nil?
-        end
       end
 
-      raise UnknownCodeError, "ISO 3166-1 code '#{code}' does not exist." if instance.nil?
+      raise UnknownCodeError, "No ISO 3166-1 code could be found for '#{code}'." if instance.nil?
 
       instance
     end
+
+    def search_by_name(str)
+      instances = all.select { |c| c.name.upcase == str }
+      instances = all.select { |c| c.name.match(/^#{str}/i) } if instances.empty?
+      instances = all.select { |c| c.name.match(/#{str}/i) } if instances.empty?
+
+      raise UnknownCodeError, "No ISO 3166-1 codes could be found searching with name '#{code}'." if instances.empty?
+
+      instances
+    end
+
+    def search_by_calling_code(code)
+      code = "+#{code.to_i}" # Normalize code
+      instances = all.select { |c| c.calling == code }
+
+      raise UnknownCodeError, "No ISO 3166-1 codes could be found searching with calling code '#{code}'." if instances.empty?
+
+      instances
+    end
+
+    def search_by_calling(code) # Alias of search_by_calling_code
+      search_by_calling_code code
+    end
+
+    def search_by_currency(code)
+      code = code.to_str.upcase
+      instances = all.select { |c|
+        c.currencies.select { |currency|
+          currency != code
+        }.empty?
+      }
+
+      raise UnknownCodeError, "No ISO 3166-1 codes could be found searching with currency '#{code}'." if instances.empty?
+
+      instances
+    end
   end
 end

data/test/iso_country_codes_test.rb

@@ -30,23 +30,66 @@ class TestIsoCountryCodes < Test::Unit::TestCase
     assert_equal IsoCountryCodes::Code::AUS.instance, IsoCountryCodes.find('AUS')
   end
 
-  def test_find_with_lowercase_name
-    assert_equal IsoCountryCodes::Code::AUS.instance, IsoCountryCodes.find('australia')
+  def test_search_with_lowercase_name
+    assert_equal [IsoCountryCodes::Code::AUS.instance], IsoCountryCodes.search_by_name('australia')
   end
 
-  def test_find_with_uppercase_name
-    assert_equal IsoCountryCodes::Code::AUS.instance, IsoCountryCodes.find('AUSTRALIA')
+  def test_search_with_uppercase_name
+    assert_equal [IsoCountryCodes::Code::AUS.instance], IsoCountryCodes.search_by_name('AUSTRALIA')
   end
 
-  def test_find_with_mixed_case_name
-    assert_equal IsoCountryCodes::Code::AUS.instance, IsoCountryCodes.find('Australia')
+  def test_search_with_mixed_case_name
+    assert_equal [IsoCountryCodes::Code::AUS.instance], IsoCountryCodes.search_by_name('Australia')
   end
 
-  def test_fuzzy_find
-    assert_equal IsoCountryCodes::Code::GBR.instance, IsoCountryCodes.find('united', :fuzzy => true)
-    assert_raises IsoCountryCodes::UnknownCodeError do
-      IsoCountryCodes.find('united')
-    end
+  def test_search_by_name_returning_many_results_starting_wth_the_search_string
+    assert_equal([
+      IsoCountryCodes::Code::GBR.instance,
+      IsoCountryCodes::Code::UMI.instance,
+      IsoCountryCodes::Code::USA.instance,
+      IsoCountryCodes::Code::ARE.instance
+    ], IsoCountryCodes.search_by_name('united'))
+  end
+
+  def test_search_by_name_returning_many_results_not_starting_with_the_search_string
+    assert_equal([
+      IsoCountryCodes::Code::LAO.instance,
+      IsoCountryCodes::Code::PRK.instance,
+      IsoCountryCodes::Code::COD.instance
+    ], IsoCountryCodes.search_by_name('democratic'))
+  end
+
+  def test_search_by_currency_lowercase
+    assert_equal([
+      IsoCountryCodes::Code::CCK.instance,
+      IsoCountryCodes::Code::NFK.instance,
+      IsoCountryCodes::Code::KIR.instance,
+      IsoCountryCodes::Code::NRU.instance,
+      IsoCountryCodes::Code::CXR.instance,
+      IsoCountryCodes::Code::HMD.instance,
+      IsoCountryCodes::Code::AUS.instance
+    ], IsoCountryCodes.search_by_currency('aud'))
+  end
+
+  def test_search_by_currency_uppercase
+    assert_equal([
+      IsoCountryCodes::Code::CCK.instance,
+      IsoCountryCodes::Code::NFK.instance,
+      IsoCountryCodes::Code::KIR.instance,
+      IsoCountryCodes::Code::NRU.instance,
+      IsoCountryCodes::Code::CXR.instance,
+      IsoCountryCodes::Code::HMD.instance,
+      IsoCountryCodes::Code::AUS.instance
+    ], IsoCountryCodes.search_by_currency('AUD'))
+  end
+
+  def test_search_by_calling_code
+    assert_equal [IsoCountryCodes::Code::ZAF.instance], IsoCountryCodes.search_by_calling_code('+27')
+    assert_equal([
+      IsoCountryCodes::Code::CXR.instance,
+      IsoCountryCodes::Code::HMD.instance,
+      IsoCountryCodes::Code::AUS.instance
+    ], IsoCountryCodes.search_by_calling_code('+61'))
   end
 
   def test_get_main_currency
@@ -54,7 +97,7 @@ class TestIsoCountryCodes < Test::Unit::TestCase
   end
 
   def test_currency_alias_method
-    code = IsoCountryCodes.find('AUS')
+    code = IsoCountryCodes::Code::AUS.instance
     assert_equal code.main_currency, code.currency
   end
 
@@ -78,6 +121,16 @@ class TestIsoCountryCodes < Test::Unit::TestCase
     assert_equal 'AUS', IsoCountryCodes::Code::AUS.instance.alpha3
   end
 
+  def test_get_calling
+    assert_equal '+61', IsoCountryCodes::Code::AUS.calling
+    assert_equal '+61', IsoCountryCodes::Code::AUS.instance.calling
+  end
+
+  def test_get_calling_code_alias
+    code = IsoCountryCodes::Code::AUS.instance
+    assert_equal code.calling, code.calling_code
+  end
+
   def test_get_name
     assert_equal 'Australia', IsoCountryCodes::Code::AUS.name
     assert_equal 'Australia', IsoCountryCodes::Code::AUS.instance.name

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: iso_country_codes
 version: !ruby/object:Gem::Version 
-  hash: 17
+  hash: 15
   prerelease: false
   segments: 
   - 0
-  - 3
-  - 1
-  version: 0.3.1
+  - 4
+  - 0
+  version: 0.4.0
 platform: ruby
 authors: 
 - alex
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2013-01-28 00:00:00 +00:00
+date: 2013-01-29 00:00:00 +00:00
 default_executable: 
 dependencies: []
 
@@ -38,6 +38,7 @@ files:
 - VERSION.yml
 - iso_country_codes.gemspec
 - lib/iso_country_codes.rb
+- lib/iso_country_codes/calling.rb
 - lib/iso_country_codes/code.rb
 - lib/iso_country_codes/iso_3166_1.rb
 - lib/iso_country_codes/iso_4217.rb