itu_codes 0.4.1 → 0.4.2

data/README.md

@@ -49,24 +49,32 @@ Country code lookup based on official ISO-3166-1 specifications:
     ItuCodes.compatriots? '1984', '1985'
     # => true
 
-    # =====================================================
-    # = Using 2-letter ISO country codes is most reliable =
-    # =====================================================
     # ... and then there's the
     # North American 'situation' ...
     ItuCodes.compatriots? '1264', '1818'
     # => false
 
+    # =====================================================
+    # = Using 2-letter ISO country codes is most reliable =
+    # =====================================================
+
     # Convert from and to ISO 2-letter country codes:
     ItuCodes.iso2itu('US')
     # => "1"
 
+    # Convert from and to ISO 2-letter country codes:
+    ItuCodes.itu2iso('1')
+    # => ["AS", "AI", "AG", "BS", "BB", "BM", "VG", "CA", "KY", "DM", "DO", "GD", "GU", "JM", "MS", "MP", "PR", "KN", "LC", "VC", "SX", "TT", "TC", "US", "VI"]
+
     # Mexico
     # ISO 3361 code : MX
     # ITU code      : 52
     ItuCodes.iso2itu('MX')
     # => "52"
 
+    ItuCodes.itu2iso('52')
+    # => "MX"
+
 
 [1]: http://www.itu.int/pub/T-SP-E.164D-11-2011
 [2]: http://www.itu.int/dms_pub/itu-t/opb/sp/T-SP-E.164D-11-2011-PDF-E.pdf

data/lib/itu_codes/helpers.rb

@@ -4,6 +4,7 @@ module ItuCodes
   module Helpers
     ISO2ITU = YAML.load_file(  File.expand_path(File.dirname(__FILE__)) + '/../data/iso_code_to_itu_country_names.yml')
 
+    # country name is the one used by ITU, not ISO
     def self.country_code_lookup(country_name)
       ISO2ITU.key(country_name)
     end

data/lib/itu_codes/version.rb

@@ -1,3 +1,3 @@
 module ItuCodes
-  VERSION = "0.4.1"
+  VERSION = "0.4.2"
 end

data/lib/itu_codes.rb

@@ -41,6 +41,18 @@ module ItuCodes
       find_by_name(country_name)
     end
 
+    def itu2iso(itu)
+      name = find_by_itu_code(itu)
+
+      if name.is_a?(String)
+        Helpers.country_code_lookup(name)
+      elsif name.is_a?(Array)
+        name.map do |s|
+          Helpers.country_code_lookup(s)
+        end
+      end
+    end
+
     # returns true for any valid ITU code
     # valid_code?(1)    => true
     # valid_code?(1818) => false

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: itu_codes
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.4.2
   prerelease: 
 platform: ruby
 authors: