phony 1.0.1 → 1.1.0

metadata

@@ -4,22 +4,21 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 1
-  - 0
   - 1
-  version: 1.0.1
+  - 0
+  version: 1.1.0
 platform: ruby
 authors: 
 - Florian Hanke
-- Andreas Schacke
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2010-11-04 00:00:00 +01:00
+date: 2010-11-26 00:00:00 +01:00
 default_executable: 
 dependencies: []
 
-description: 
+description: "Fast international phone number (E164 standard) normalizing, splitting and formatting. Lots of formatting options: International (+.., 00..), national (0..), and local)."
 email: florian.hanke+phony@gmail.com
 executables: []
 
@@ -28,18 +27,35 @@ extensions: []
 extra_rdoc_files: 
 - README.textile
 files: 
-- lib/ndc/austria.rb
-- lib/ndc/fixed_size.rb
-- lib/ndc/germany.rb
-- lib/ndc/prefix.rb
-- lib/ndc/splitter.rb
+- lib/phony/countries/all_other.rb
+- lib/phony/countries/austria.rb
+- lib/phony/countries/egypt.rb
+- lib/phony/countries/germany.rb
+- lib/phony/countries/greece.rb
+- lib/phony/countries/hungary.rb
+- lib/phony/countries/italy.rb
+- lib/phony/country.rb
+- lib/phony/country_codes.rb
+- lib/phony/local_splitter.rb
+- lib/phony/national_code.rb
+- lib/phony/national_splitters/fixed.rb
+- lib/phony/national_splitters/variable.rb
+- lib/phony/vanity.rb
 - lib/phony.rb
 - README.textile
-- spec/lib/ndc/austria_spec.rb
-- spec/lib/ndc/fixed_size_spec.rb
-- spec/lib/ndc/germany_spec.rb
-- spec/lib/ndc/prefix_spec.rb
-- spec/lib/ndc/splitter_spec.rb
+- spec/lib/phony/countries/austria_spec.rb
+- spec/lib/phony/countries/egypt_spec.rb
+- spec/lib/phony/countries/germany_spec.rb
+- spec/lib/phony/countries/greece_spec.rb
+- spec/lib/phony/countries/hungary_spec.rb
+- spec/lib/phony/countries/switzerland_spec.rb
+- spec/lib/phony/country_codes_spec.rb
+- spec/lib/phony/country_spec.rb
+- spec/lib/phony/local_splitter_spec.rb
+- spec/lib/phony/national_code_spec.rb
+- spec/lib/phony/national_splitters/fixed_spec.rb
+- spec/lib/phony/national_splitters/variable_spec.rb
+- spec/lib/phony/vanity_spec.rb
 - spec/lib/phony_spec.rb
 has_rdoc: false
 homepage: http://github.com/floere/phony
@@ -72,11 +88,19 @@ rubyforge_project:
 rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: E164 Number Splitting and Formatting
+summary: Fast international phone number (E164 standard) normalizing, splitting and formatting.
 test_files: 
-- spec/lib/ndc/austria_spec.rb
-- spec/lib/ndc/fixed_size_spec.rb
-- spec/lib/ndc/germany_spec.rb
-- spec/lib/ndc/prefix_spec.rb
-- spec/lib/ndc/splitter_spec.rb
+- spec/lib/phony/countries/austria_spec.rb
+- spec/lib/phony/countries/egypt_spec.rb
+- spec/lib/phony/countries/germany_spec.rb
+- spec/lib/phony/countries/greece_spec.rb
+- spec/lib/phony/countries/hungary_spec.rb
+- spec/lib/phony/countries/switzerland_spec.rb
+- spec/lib/phony/country_codes_spec.rb
+- spec/lib/phony/country_spec.rb
+- spec/lib/phony/local_splitter_spec.rb
+- spec/lib/phony/national_code_spec.rb
+- spec/lib/phony/national_splitters/fixed_spec.rb
+- spec/lib/phony/national_splitters/variable_spec.rb
+- spec/lib/phony/vanity_spec.rb
 - spec/lib/phony_spec.rb

data/lib/ndc/austria.rb

@@ -1,69 +0,0 @@
-# Splits a national number into a fixed size NDC and rest.
-#
-module Phony
-  module NDC
-    class Austria < Prefix
-      
-      length 1..4
-      local 10
-      
-      ndcs '1',# Wient
-        '57',  # -
-        '59',  # -
-        '67',  # Mobile Services
-        '68',  # Mobile Services
-        '89',  # Routing Number
-        '316', # Graz
-        '501', # -
-        '502', # -
-        '503', # -
-        '504', # -
-        '505', # -
-        '506', # -
-        '507', # -
-        '508', # -
-        '509', # -
-        '512', # Innsbruck
-        '517', # -
-        '644', # Mobile Services
-        '650', # Mobile Services
-        '651', # Mobile Services
-        '652', # Mobile Services
-        '653', # Mobile Services
-        '655', # Mobile Services
-        '657', # Mobile Services
-        '659', # Mobile Services
-        '660', # Mobile Services
-        '661', # Mobile Services
-        '662', # Salzburg
-        '663', # Mobile Services
-        '664', # Mobile Services
-        '665', # Mobile Services
-        '666', # Mobile Services
-        '667', # Mobile Services
-        '668', # Mobile Services
-        '669', # Mobile Services
-        '710', # Service Number
-        '711', # Service Number
-        '718', # Service Number
-        '720', #
-        '730', # Service Number
-        '732', # Linz
-        '740', # Service Number
-        '780', # Service Number
-        '800', # Service Number
-        '802', # Service Number
-        '804', # Service Number
-        '810', # Service Number
-        '820', # Service Number
-        '821', # Service Number
-        '828', # Service Number
-        '900', # Service Number
-        '901', # Service Number
-        '930', # Service Number
-        '931', # Service Number
-        '939'  # Service Number
-      
-    end
-  end
-end

data/lib/ndc/fixed_size.rb

@@ -1,113 +0,0 @@
-# Splits a national number into a fixed size NDC and rest.
-#
-module Phony
-  module NDC
-    
-    def self.fixed(national_code_length = 2, options = {})
-      klass = Class.new FixedSize
-      split_sizes, special_ndcs = klass.extract options
-      klass.special_ndc_strategy Phony::NDC::SpecialNdcStrategy.new(national_code_length, special_ndcs)
-      klass.fixed_ndc_strategy Phony::NDC::FixedNdcStrategy.new(national_code_length, split_sizes)
-      klass.format options[:format] || '%s%s%s%s%s'
-      klass.local split_sizes
-      klass
-    end
-    
-    class FixedSize < Splitter
-      
-      def self.extract options
-        [options[:local] || [3, 2, 2], options[:special_ndcs] || []]
-      end
-      
-      # Sets the strategy object to handle special services numbers
-      def self.special_ndc_strategy strategy 
-        @special_ndc_strategy = strategy
-      end
-      
-      # Sets the strategy object to handle normal numbers (non special services)
-      def self.fixed_ndc_strategy strategy
-        @fixed_ndc_strategy = strategy
-        @ndc_strategy = @fixed_ndc_strategy
-      end
-        
-      # Returns true if the number is a special services number
-      def self.special_ndc? number
-        @special_ndc_strategy.special_ndc? number
-      end
-      
-      # Define a format for the country's national format.
-      #
-      # Default is NN followed by a space.
-      #
-      def self.ndc_format
-        @ndc_format || @ndc_format = @ndc_strategy.ndc_format
-      end
-      
-      # A faster split method than the prefix splitter offers.
-      #
-      def self.split_ndc number
-        number = number.dup
-        if special_ndc? number
-          @ndc_strategy = @special_ndc_strategy
-        else
-          @ndc_strategy = @fixed_ndc_strategy
-        end
-        @ndc_strategy.split_ndc number
-      end
-      
-      def self.split_local number
-        @ndc_strategy.split_local number
-      end
-            
-    end
-    
-    # Base class for all Strategies
-    class NdcStrategy
-      attr_reader :split_sizes
-      
-      def initialize national_code_length, split_sizes
-        @national_code_length = national_code_length
-        @split_sizes = split_sizes
-      end
-
-      def split_local number
-        local = []
-        split_sizes.each do |size|
-          local << number.slice!(0..size-1)
-          break if number.empty?
-        end
-        local
-      end
-
-      def ndc_format
-        '%s' + (@national_code_length == 0 ? '' : '%s')
-      end
-      
-    end
-    
-    class SpecialNdcStrategy < NdcStrategy
-      def initialize national_code_length, special_ndcs
-        super national_code_length, [2, 2, 2]
-        @special_ndcs = special_ndcs.flatten
-        @special_ndc_regexp = Regexp.compile "^(#{@special_ndcs.join('|')})"
-      end
-      
-      def special_ndc? number
-        @special_ndcs && !@special_ndcs.empty? && @match = @special_ndc_regexp.match(number)
-      end
-      
-      def split_ndc number
-        [number.slice!(0..@match[0].length-1), number]
-      end
-    end
-    
-    class FixedNdcStrategy < NdcStrategy
-
-      def split_ndc number
-        @national_code_length.zero? ? ['', number] : [number.slice!(0..@national_code_length-1), number]
-      end
-      
-    end
-    
-  end
-end

data/lib/ndc/germany.rb

@@ -1,157 +0,0 @@
-# Splits a german national number into a fixed size NDC and rest.
-#
-# Note: We do ignore places with 5 numbers as NDC, like Groß Glienicke (33201)
-#
-module Phony
-  module NDC
-    class Germany < Prefix
-      
-      length 2..4
-      local 3, 10
-      
-      # prefix length => [ndcs]
-      ndcs '10',  # Call-By-Call
-        '11',  # formerly Value Added Services
-        '12',  # Innovative Services
-        '13',  # Voting and Lottery Numbers
-        '30',  # Berlin
-        '32',  # Non Geographical Numbers
-        '40',  # Hamburg
-        '69',  # Frankfurt am Main
-        '89',  # München
-        '150', # Group3G/Quam
-        '151', # T-Mobile
-        '152', # Vodafone
-        '155', # E-Plus
-        '156', # Mobilcom
-        '157', # E-Plus
-        '159', # O2
-        '160', # T-Mobile
-        '161', # C-Netz
-        '162', # Vodafone
-        '163', # E-Plus
-        '164', # Cityruf
-        '165', # Quix
-        '166', # Telmi
-        '168', # Scall
-        '169', # Cityruf, Scall, Skyper (e*cityruf, e*message, e*skyper)
-        '170', # T-Mobile
-        '171', # T-Mobile
-        '172', # Vodafone
-        '173', # Vodafone
-        '174', # Vodafone
-        '175', # T-Mobile
-        '176', # O2 Germany
-        '177', # E-Plus
-        '178', # E-Plus
-        '179', # O2 Germany
-        '181', # IVPNs
-        '182', # Closed User Group
-        '183', # Closed User Group
-        '184', # Closed User Group
-        '185', # Closed User Group
-        '186', # Closed User Group
-        '187', # Closed User Group
-        '189', # Closed User Group
-        '190', # former Premium Rate Services
-        '191', # Online Services
-        '192', # Online Services
-        '193', # Online Services
-        '194', # Online Services
-        '199', # Network-Internal Traffic Control
-        '201', # Essen
-        '202', # Wuppertal
-        '203', # Duisburg
-        '208', # Mühlheim an der Ruhr
-        '209', # Gelsenkirchen
-        '211', # Düsseldorf
-        '212', # Solingen
-        '214', # Leverkusen
-        '221', # Köln
-        '228', # Bonn
-        '231', # Dortmund
-        '234', # Bochum
-        '241', # Aachen
-        '251', # Münster
-        '261', # Koblenz
-        '271', # Siegen
-        '281', # Wesel
-        '291', # Meschede
-        '310', # Test Number Long Distance
-        '311', # Test Number Local
-        '335', # Frankfurt (Oder)
-        '340', # Dessau
-        '341', # Leipzig
-        '345', # Halle (Saale)
-        '351', # Dresden
-        '355', # Cottbus
-        '361', # Erfurt
-        '365', # Gera
-        '371', # Chemnitz
-        '375', # Zwickau
-        '381', # Rostock
-        '385', # Schwerin
-        '391', # Magdeburg
-        '395', # Neubrandenburg
-        '421', # Bremen
-        '431', # Kiel
-        '441', # Oldenburg
-        '461', # Flensburg
-        '471', # Bremerhaven
-        '481', # Heide
-        '491', # Leer
-        '511', # Hannover
-        '521', # Bielefeld
-        '531', # Braunschweig
-        '541', # Osnabrück
-        '551', # Göttingen
-        '561', # Kassel
-        '571', # Minden
-        '581', # Uelzen
-        '591', # Lingen (Ems)
-        '611', # Wiesbaden
-        '621', # Mannheim / Ludwigshafen
-        '631', # Kaiserslautern
-        '641', # Gießen
-        '651', # Trier
-        '661', # Fulda
-        '671', # Bad Kreuznach
-        '681', # Saarbrücken
-        '700', # Personal Numbers
-        '701', # Personal Numbers, reserved
-        '711', # Stuttgart
-        '721', # Karlsruhe
-        '731', # Ulm
-        '741', # Rottweil
-        '751', # Ravensburg
-        '761', # Freiburg im Breisgau
-        '771', # Donaueschingen
-        '781', # Offenburg
-        '791', # Schwäbisch Hall
-        '800', # Toll-Free Numbers
-        '801', # Toll-Free Numbers, reserved
-        '811', # Hallbergmoos
-        '821', # Augsburg
-        '831', # Kempten
-        '841', # Ingolstadt
-        '851', # Passau
-        '861', # Traunstein
-        '871', # Landshut
-        '881', # Weilheim in Oberbayern
-        '900', # Premium Rate Numbers
-        '901', # Premium Rate Numbers, reserved
-        '902', # Replacement for 0137/0138
-        '906', # Donauwörth
-        '911', # Nürnberg
-        '921', # Bayreuth
-        '931', # Würzburg
-        '941', # Regensburg
-        '951', # Bamberg
-        '961', # Weiden
-        '971', # Bad Kissingen
-        '981', # Ansbach
-        '991' # Deggendorf
-      
-    end
-  end
-end

data/lib/ndc/prefix.rb

@@ -1,67 +0,0 @@
-# Splits a national number using a prefix code.
-#
-# DSL:
-#   length: the length range of the dcs. For austria it is 1..4.
-#   format: the format of the dcs and rest. For austria it is '%s %s', default is '%s %s %s %s'.
-#   ndcs:   an array of the prefix codes. For germany it starts with ['10', '11', '12', '13', '30'…
-#
-module Phony
-  module NDC
-    class Prefix < Splitter
-      
-      # Splits the number into ndc and rest.
-      #
-      def self.split_ndc(number)
-        number = number.dup
-        presumed_code = ''
-        presumed_code << number.slice!(0..@min_ndc_length-2) if @min_ndc_length && @min_ndc_length > 1
-        (@min_ndc_length || 1).upto(@max_ndc_length) do |i|
-          presumed_code << number.slice!(0..0)
-          sized_ndcs = @ndcs[i]
-          break unless sized_ndcs && !sized_ndcs.include?(presumed_code)
-        end
-        return [presumed_code, number]
-      end
-      
-      protected
-        
-        # Define the length range for the country's ndcs.
-        #
-        def self.length(range)
-          @min_ndc_length, @max_ndc_length = range.min, range.max
-        end
-        
-        # Define the list of NDCs.
-        #
-        # Note: For optimization, if the country has a max ndc length of 4,
-        #       only enter ndcs up to the length of 3 letters.
-        #       If the algorithm fails to match an ndc, it will assume it is a 4 digit ndc.
-        #
-        # e.g. We have NDCs '1', '22', '333', and '4444'.
-        #      Only set
-        #        ndcs '1', '22', '333'
-        #      and
-        #        length 1..4
-        #      '4444' will be "recognized" because the algorithm does not find a shorter ndc (assuming it
-        #      is a correct prefix code) and stop at the max ndc length of 4, given by the length method.
-        #
-        def self.ndcs(*ndcs_ary)
-          @ndcs = optimize(ndcs_ary)
-        end
-        
-      private
-        
-        # Optimizes and restructures the given ndcs array.
-        #
-        def self.optimize(ndcs_ary)
-          ndcs = {}
-          ndcs_ary.each do |ndc|
-            ndcs[ndc.length] ||= []
-            ndcs[ndc.length] << ndc
-          end
-          ndcs
-        end
-      
-    end
-  end
-end