itu_codes 0.2 → 0.3

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Mani Tadayon
+
+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

@@ -0,0 +1,54 @@
+# ItuCodes relies on the excellent Carmen library:
+# http://github.com/jim/carmen/tree/master
+
+# sample usage:
+
+ItuCodes.valid_code? 8392813          # => false
+
+ItuCodes.valid_code? 7                # => true
+
+ItuCodes.parse_code 1818              # => 1
+
+ItuCodes.parse_code 822               # => "82"
+
+ItuCodes.parse_code 4                 # => nil
+
+ItuCodes.find("France")               # => "33"
+
+ItuCodes.find("995")                  # => "Georgia"
+
+ItuCodes.find("Erewhon")              # => nil
+
+ItuCodes.find("123123995")            # => nil
+
+# Despite the same 1st digit, 
+# these are for different 
+# countries ...
+ItuCodes.compatriots? 822, 811        # => false
+
+# ... but these are for 
+# the same country ...
+ItuCodes.compatriots? 122, 111        # => true
+
+# =====================================================
+# = Using 2-letter ISO country codes is most reliable =
+# =====================================================
+# ... and then there's the 
+# North American 'situation' ...
+ItuCodes.compatriots? 1264, 1818      # => false
+
+# Convert from and to ISO 2-letter country codes:
+ItuCodes.iso2itu('US')                # => "1"
+
+ItuCodes.itu2iso('1')
+# => ["US", "CA", "AS", "AI", "AG", "BS", "BB", "BM", "KY", "DM", "DO", "GD", "GU", "JM", "MS", "MP", "KN", "LC", "VC", "TT", "TC"]
+
+# Mexico
+# ISO 3361 code : MX
+# ITU code      : 52
+ItuCodes.iso2itu('MX')                # => "52"
+
+# Georgia
+# ISO 3361 code : GE
+# ITU code      : 995
+ItuCodes.itu2iso('995')               # => ["GE"]

data/lib/itu_codes/version.rb

@@ -0,0 +1,3 @@
+module ItuCodes
+  VERSION = "0.3"
+end