as_dialed_from 0.1.1

data/.rvmrc

@@ -0,0 +1,3 @@
+rvm 1.9.2@phone_number
+rvm_project_rvmrc_default=1
+

data/Gemfile

@@ -0,0 +1,19 @@
+source :rubygems
+
+group :development, :test do
+  gem 'xml-simple'
+  
+  gem 'test-unit'
+  gem 'guard-test'
+  
+  gem 'rcov'
+  
+  gem 'bundler'
+  gem 'jeweler'
+end
+
+require 'rbconfig'
+if RbConfig::CONFIG['host_os'] =~ /darwin/i
+  gem 'rb-fsevent'
+  gem 'growl'
+end

data/Guardfile

@@ -0,0 +1,5 @@
+guard 'test' do
+  watch(%r{^lib/(.+)\.rb$})     { |m| "test/#{m[1]}_test.rb" }
+  watch(%r{^test/.+_test\.rb$})
+  watch('test/test_helper.rb')  { "test" }
+end

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2011 Movitas
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.md

@@ -0,0 +1,41 @@
+# as_dialed_from
+
+Figure out how a number should be dialed from another country.
+A fork of a port of Google's libphonenumber.
+
+## Examples
+
+as_dialed_from prototypes the String class with an `as_dialed_from` method.
+
+```rb
+"+12155551212".as_dialed_from "US"
+ => "12155551212"
+
+"+12155551212".as_dialed_from 52 # Mexico
+ => "0012155551212"
+ 
+"+12155551212".as_dialed_from "74957285000" # Russia
+ => "8~1012155551212"
+```
+
+The "from" argument can be one of many things
+
+* An ISO 3166-2 code (`"US"`)
+* Any valid country code digits, as an Integer (`1`) or String (`"1"`)
+* If a phone number is passed, it will try to find the country code for that number (`"12155551212"`)
+
+## Installing
+
+### Shell
+
+```sh
+gem install as_dialed_from
+```
+
+### Gemfile
+
+```rb
+gem 'as_dialed_from'
+```
+
+And then `bundle install`

data/Rakefile

@@ -0,0 +1,45 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "as_dialed_from"
+  gem.homepage = "http://github.com/Movitas/as_dialed_from"
+  gem.license = "Apache"
+  gem.summary = "Figure out how a number should be dialed from another country"
+  gem.description = "Figure out how a number should be dialed from another country. A fork of a port of Google's libphonenumber."
+  gem.email = "jcampbell@movitas.com"
+  gem.authors = ["Justin Campbell"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+  test.rcov_opts << '--exclude "gems/*"'
+end
+
+task :default => :test
+
+Dir.glob('tasks/*.rake').each { |r| import r }

data/VERSION

@@ -0,0 +1 @@
+0.1.1

data/as_dialed_from.gemspec

@@ -0,0 +1,319 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{as_dialed_from}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Justin Campbell"]
+  s.date = %q{2011-07-20}
+  s.description = %q{Figure out how a number should be dialed from another country. A fork of a port of Google's libphonenumber.}
+  s.email = %q{jcampbell@movitas.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.md"
+  ]
+  s.files = [
+    ".rvmrc",
+    "Gemfile",
+    "Guardfile",
+    "LICENSE",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "as_dialed_from.gemspec",
+    "lib/as_dialed_from.rb",
+    "lib/as_dialed_from/metadata.rb",
+    "lib/as_dialed_from/number.rb",
+    "resources/PhoneNumberMetaData.xml",
+    "resources/country_codes.yml",
+    "resources/territories/.gitkeep",
+    "resources/territories/AC.yml",
+    "resources/territories/AD.yml",
+    "resources/territories/AE.yml",
+    "resources/territories/AF.yml",
+    "resources/territories/AG.yml",
+    "resources/territories/AI.yml",
+    "resources/territories/AL.yml",
+    "resources/territories/AM.yml",
+    "resources/territories/AN.yml",
+    "resources/territories/AO.yml",
+    "resources/territories/AR.yml",
+    "resources/territories/AS.yml",
+    "resources/territories/AT.yml",
+    "resources/territories/AU.yml",
+    "resources/territories/AW.yml",
+    "resources/territories/AX.yml",
+    "resources/territories/AZ.yml",
+    "resources/territories/BA.yml",
+    "resources/territories/BB.yml",
+    "resources/territories/BD.yml",
+    "resources/territories/BE.yml",
+    "resources/territories/BF.yml",
+    "resources/territories/BG.yml",
+    "resources/territories/BH.yml",
+    "resources/territories/BI.yml",
+    "resources/territories/BJ.yml",
+    "resources/territories/BL.yml",
+    "resources/territories/BM.yml",
+    "resources/territories/BN.yml",
+    "resources/territories/BO.yml",
+    "resources/territories/BR.yml",
+    "resources/territories/BS.yml",
+    "resources/territories/BT.yml",
+    "resources/territories/BW.yml",
+    "resources/territories/BY.yml",
+    "resources/territories/BZ.yml",
+    "resources/territories/CA.yml",
+    "resources/territories/CC.yml",
+    "resources/territories/CD.yml",
+    "resources/territories/CF.yml",
+    "resources/territories/CG.yml",
+    "resources/territories/CH.yml",
+    "resources/territories/CI.yml",
+    "resources/territories/CK.yml",
+    "resources/territories/CL.yml",
+    "resources/territories/CM.yml",
+    "resources/territories/CN.yml",
+    "resources/territories/CO.yml",
+    "resources/territories/CR.yml",
+    "resources/territories/CU.yml",
+    "resources/territories/CV.yml",
+    "resources/territories/CX.yml",
+    "resources/territories/CY.yml",
+    "resources/territories/CZ.yml",
+    "resources/territories/DE.yml",
+    "resources/territories/DJ.yml",
+    "resources/territories/DK.yml",
+    "resources/territories/DM.yml",
+    "resources/territories/DO.yml",
+    "resources/territories/DZ.yml",
+    "resources/territories/EC.yml",
+    "resources/territories/EE.yml",
+    "resources/territories/EG.yml",
+    "resources/territories/ER.yml",
+    "resources/territories/ES.yml",
+    "resources/territories/ET.yml",
+    "resources/territories/FI.yml",
+    "resources/territories/FJ.yml",
+    "resources/territories/FK.yml",
+    "resources/territories/FM.yml",
+    "resources/territories/FO.yml",
+    "resources/territories/FR.yml",
+    "resources/territories/GA.yml",
+    "resources/territories/GB.yml",
+    "resources/territories/GD.yml",
+    "resources/territories/GE.yml",
+    "resources/territories/GF.yml",
+    "resources/territories/GG.yml",
+    "resources/territories/GH.yml",
+    "resources/territories/GI.yml",
+    "resources/territories/GL.yml",
+    "resources/territories/GM.yml",
+    "resources/territories/GN.yml",
+    "resources/territories/GP.yml",
+    "resources/territories/GQ.yml",
+    "resources/territories/GR.yml",
+    "resources/territories/GT.yml",
+    "resources/territories/GU.yml",
+    "resources/territories/GW.yml",
+    "resources/territories/GY.yml",
+    "resources/territories/HK.yml",
+    "resources/territories/HN.yml",
+    "resources/territories/HR.yml",
+    "resources/territories/HT.yml",
+    "resources/territories/HU.yml",
+    "resources/territories/ID.yml",
+    "resources/territories/IE.yml",
+    "resources/territories/IL.yml",
+    "resources/territories/IM.yml",
+    "resources/territories/IN.yml",
+    "resources/territories/IO.yml",
+    "resources/territories/IQ.yml",
+    "resources/territories/IR.yml",
+    "resources/territories/IS.yml",
+    "resources/territories/IT.yml",
+    "resources/territories/JE.yml",
+    "resources/territories/JM.yml",
+    "resources/territories/JO.yml",
+    "resources/territories/JP.yml",
+    "resources/territories/KE.yml",
+    "resources/territories/KG.yml",
+    "resources/territories/KH.yml",
+    "resources/territories/KI.yml",
+    "resources/territories/KM.yml",
+    "resources/territories/KN.yml",
+    "resources/territories/KP.yml",
+    "resources/territories/KR.yml",
+    "resources/territories/KW.yml",
+    "resources/territories/KY.yml",
+    "resources/territories/KZ.yml",
+    "resources/territories/LA.yml",
+    "resources/territories/LB.yml",
+    "resources/territories/LC.yml",
+    "resources/territories/LI.yml",
+    "resources/territories/LK.yml",
+    "resources/territories/LR.yml",
+    "resources/territories/LS.yml",
+    "resources/territories/LT.yml",
+    "resources/territories/LU.yml",
+    "resources/territories/LV.yml",
+    "resources/territories/LY.yml",
+    "resources/territories/MA.yml",
+    "resources/territories/MC.yml",
+    "resources/territories/MD.yml",
+    "resources/territories/ME.yml",
+    "resources/territories/MF.yml",
+    "resources/territories/MG.yml",
+    "resources/territories/MH.yml",
+    "resources/territories/MK.yml",
+    "resources/territories/ML.yml",
+    "resources/territories/MM.yml",
+    "resources/territories/MN.yml",
+    "resources/territories/MO.yml",
+    "resources/territories/MP.yml",
+    "resources/territories/MQ.yml",
+    "resources/territories/MR.yml",
+    "resources/territories/MS.yml",
+    "resources/territories/MT.yml",
+    "resources/territories/MU.yml",
+    "resources/territories/MV.yml",
+    "resources/territories/MW.yml",
+    "resources/territories/MX.yml",
+    "resources/territories/MY.yml",
+    "resources/territories/MZ.yml",
+    "resources/territories/NA.yml",
+    "resources/territories/NC.yml",
+    "resources/territories/NE.yml",
+    "resources/territories/NF.yml",
+    "resources/territories/NG.yml",
+    "resources/territories/NI.yml",
+    "resources/territories/NL.yml",
+    "resources/territories/NO.yml",
+    "resources/territories/NP.yml",
+    "resources/territories/NR.yml",
+    "resources/territories/NU.yml",
+    "resources/territories/NZ.yml",
+    "resources/territories/OM.yml",
+    "resources/territories/PA.yml",
+    "resources/territories/PE.yml",
+    "resources/territories/PF.yml",
+    "resources/territories/PG.yml",
+    "resources/territories/PH.yml",
+    "resources/territories/PK.yml",
+    "resources/territories/PL.yml",
+    "resources/territories/PM.yml",
+    "resources/territories/PR.yml",
+    "resources/territories/PS.yml",
+    "resources/territories/PT.yml",
+    "resources/territories/PW.yml",
+    "resources/territories/PY.yml",
+    "resources/territories/QA.yml",
+    "resources/territories/RE.yml",
+    "resources/territories/RO.yml",
+    "resources/territories/RS.yml",
+    "resources/territories/RU.yml",
+    "resources/territories/RW.yml",
+    "resources/territories/SA.yml",
+    "resources/territories/SB.yml",
+    "resources/territories/SC.yml",
+    "resources/territories/SD.yml",
+    "resources/territories/SE.yml",
+    "resources/territories/SG.yml",
+    "resources/territories/SH.yml",
+    "resources/territories/SI.yml",
+    "resources/territories/SJ.yml",
+    "resources/territories/SK.yml",
+    "resources/territories/SL.yml",
+    "resources/territories/SM.yml",
+    "resources/territories/SN.yml",
+    "resources/territories/SO.yml",
+    "resources/territories/SR.yml",
+    "resources/territories/ST.yml",
+    "resources/territories/SV.yml",
+    "resources/territories/SY.yml",
+    "resources/territories/SZ.yml",
+    "resources/territories/TC.yml",
+    "resources/territories/TD.yml",
+    "resources/territories/TF.yml",
+    "resources/territories/TG.yml",
+    "resources/territories/TH.yml",
+    "resources/territories/TJ.yml",
+    "resources/territories/TK.yml",
+    "resources/territories/TL.yml",
+    "resources/territories/TM.yml",
+    "resources/territories/TN.yml",
+    "resources/territories/TO.yml",
+    "resources/territories/TR.yml",
+    "resources/territories/TT.yml",
+    "resources/territories/TV.yml",
+    "resources/territories/TW.yml",
+    "resources/territories/TZ.yml",
+    "resources/territories/UA.yml",
+    "resources/territories/UG.yml",
+    "resources/territories/US.yml",
+    "resources/territories/UY.yml",
+    "resources/territories/UZ.yml",
+    "resources/territories/VA.yml",
+    "resources/territories/VC.yml",
+    "resources/territories/VE.yml",
+    "resources/territories/VG.yml",
+    "resources/territories/VI.yml",
+    "resources/territories/VN.yml",
+    "resources/territories/VU.yml",
+    "resources/territories/WF.yml",
+    "resources/territories/WS.yml",
+    "resources/territories/YE.yml",
+    "resources/territories/YT.yml",
+    "resources/territories/ZA.yml",
+    "resources/territories/ZM.yml",
+    "resources/territories/ZW.yml",
+    "tasks/as_dialed_from.rake",
+    "test/as_dialed_from/metadata_test.rb",
+    "test/as_dialed_from/number_test.rb",
+    "test/as_dialed_from_test.rb",
+    "test/test_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/Movitas/as_dialed_from}
+  s.licenses = ["Apache"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.2}
+  s.summary = %q{Figure out how a number should be dialed from another country}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rb-fsevent>, [">= 0"])
+      s.add_runtime_dependency(%q<growl>, [">= 0"])
+      s.add_development_dependency(%q<xml-simple>, [">= 0"])
+      s.add_development_dependency(%q<test-unit>, [">= 0"])
+      s.add_development_dependency(%q<guard-test>, [">= 0"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+    else
+      s.add_dependency(%q<rb-fsevent>, [">= 0"])
+      s.add_dependency(%q<growl>, [">= 0"])
+      s.add_dependency(%q<xml-simple>, [">= 0"])
+      s.add_dependency(%q<test-unit>, [">= 0"])
+      s.add_dependency(%q<guard-test>, [">= 0"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rb-fsevent>, [">= 0"])
+    s.add_dependency(%q<growl>, [">= 0"])
+    s.add_dependency(%q<xml-simple>, [">= 0"])
+    s.add_dependency(%q<test-unit>, [">= 0"])
+    s.add_dependency(%q<guard-test>, [">= 0"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+  end
+end
+

data/lib/as_dialed_from/metadata.rb

@@ -0,0 +1,94 @@
+require 'net/http'
+require 'xmlsimple'
+require 'yaml'
+
+module AsDialedFrom
+  
+  class Metadata
+    RESOURCES_DIRECTORY   = File.dirname(__FILE__) + "/../../resources/"
+    TERRITORIES_DIRECTORY = RESOURCES_DIRECTORY + "/territories"
+    LOCAL_XML_FILE        = RESOURCES_DIRECTORY + "/PhoneNumberMetaData.xml"
+    COUNTRY_CODES_FILE    = "#{RESOURCES_DIRECTORY}/country_codes.yml"
+    
+    UPSTREAM_URL = "http://libphonenumber.googlecode.com/svn/trunk/resources/PhoneNumberMetaData.xml"
+    
+    attr_accessor :data
+    
+    def initialize; end
+    
+    def self.for_region(region_code)
+      YAML::load_file "#{TERRITORIES_DIRECTORY}/#{region_code}.yml"
+    end
+    
+    def self.country_code_to_region
+      YAML::load_file COUNTRY_CODES_FILE
+    end
+    
+    def self.download
+      file = File.new LOCAL_XML_FILE, "w"
+      file.write Net::HTTP.get(URI.parse(UPSTREAM_URL))
+      file.close
+    end
+    
+    def self.parse
+      puts "Parsing XML file"
+      
+      xml = File.read LOCAL_XML_FILE
+      phone_number_meta_data = XmlSimple.xml_in xml, { 'KeyAttr' => 'id', 'ForceArray' => false }
+      territories = phone_number_meta_data['territories']['territory']
+      
+      country_code_to_region_code_map = {}
+      
+      print "Writing territories "
+      
+      territories.each do |territory, data|
+        print "#{territory} "
+        
+        hash ||= {}
+        
+        %w[
+          countryCode
+          internationalPrefix
+          leadingZeroPossible
+          nationalPrefix
+        ].each do |xml_attribute|
+          hash[underscore(xml_attribute).to_sym] = data[xml_attribute] if data[xml_attribute]
+        end
+        
+        hash[:national_number_pattern] = data['generalDesc']['nationalNumberPattern'] if data['generalDesc'] and data['generalDesc']['nationalNumberPattern']
+        
+        file = File.new "#{TERRITORIES_DIRECTORY}/#{territory}.yml", "w"
+        file.write hash.to_yaml
+        file.close
+        
+        country_code_to_region_code_map[data['countryCode']] ||= []
+        
+        if data['mainCountryForCode']
+          country_code_to_region_code_map[data['countryCode']].insert 0, territory
+        else
+          country_code_to_region_code_map[data['countryCode']].push territory
+        end
+      end
+      
+      puts "\nWriting country code map"
+      
+      file = File.new COUNTRY_CODES_FILE, "w"
+      file.write country_code_to_region_code_map.to_yaml
+      file.close
+      
+      puts "Done!"
+    end
+    
+    def self.underscore(camel_cased_word)
+      word = camel_cased_word.to_s.dup
+      word.gsub!(/::/, '/')
+      word.gsub!(/([A-Z\d]+)([A-Z][a-z])/,'\1_\2')
+      word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
+      word.tr!("-", "_")
+      word.downcase!
+      word
+    end
+    
+  end
+  
+end

data/lib/as_dialed_from/number.rb

@@ -0,0 +1,79 @@
+# encoding: UTF-8
+
+module AsDialedFrom
+  
+  class Number
+    
+    attr_reader :number
+    
+    def initialize(number)
+      @number = number
+      
+      # Pre-compute stuff
+      country_code
+      metadata
+      
+      @number
+    end
+    
+    def as_dialed_from(from_country)
+      # Convert numeric country code to region id
+      from_country = Metadata.country_code_to_region[from_country][0] if from_country.is_a? Integer or from_country.to_i.nonzero?
+      
+      from_metadata = Metadata.for_region(from_country)
+      raise "Could not find valid metadata for from_country" unless from_metadata
+      
+      if from_country == Metadata.country_code_to_region[country_code][0]
+        # If we're calling within the same country, just prepend the national number with the national prefix
+        "#{leading_zero}#{metadata[:national_prefix]}#{national_number}"
+      else
+        # If we're calling out of country, we need to dial the exit code and the destination country code before the number
+        "#{exit_code(from_metadata[:international_prefix])}#{country_code}#{leading_zero}#{national_number}"
+      end
+    end
+    
+    def country_code
+      @country_code ||= determine_country_code
+    end
+    
+    def determine_country_code
+      raise "+<country_code> is required at the beginning of the number" unless @number[0] == "+"
+      
+      # Test the leading digits to find a valid country_code
+      # Country codes are not ambiguous (ex. 1 is valid, and there is no 1X or 1XX)
+      (1..3).each do |length|
+        possible_country_code = @number[1,length]
+        
+        return possible_country_code if Metadata.country_code_to_region[possible_country_code]
+      end
+      
+      raise "No valid country code was present"
+    end
+    
+    def exit_code(international_prefix)
+      international_prefix.delete("[]").match international_prefix
+    end
+    
+    def metadata
+      @metadata ||= Metadata.for_region(Metadata.country_code_to_region[country_code][0])
+      raise "Could not find valid metadata for number" unless @metadata
+      @metadata
+    end
+    
+    def national_number
+      @national_number ||= determine_national_number
+    end
+    
+    def determine_national_number
+      n = @number.gsub "+#{country_code}", ""
+      n.match metadata[:national_number_format] if metadata[:national_number_format]
+      n
+    end
+    
+    def leading_zero
+      "0" if metadata[:leading_zero_possible]
+    end
+    
+  end
+  
+end

data/lib/as_dialed_from.rb

@@ -0,0 +1,11 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require 'as_dialed_from/metadata'
+require 'as_dialed_from/number'
+
+class String
+  def as_dialed_from(from_country)
+    AsDialedFrom::Number.new(self).as_dialed_from(from_country)
+  end
+end