telephone_number 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6d1182623bbe38dba05f732f29020d92b4e3bf06
-  data.tar.gz: b27bc63b6dd33e0310ee271a89e08d9b9a4c7e8e
+  metadata.gz: da8efdb23ca38191becf7d7a07a6387cce0530cf
+  data.tar.gz: 16577898ab4e8dccf7a85ed2bf0d2c2faa5a9a99
 SHA512:
-  metadata.gz: 1c9df0dffe26550bfa71de2083dcaf9a8b45fa936a548e75f5fcf6c9cc7248016e366e1e3b38c3f9a8a74deae28b34b18c4dadd391c66ea83ebc723c7006ee8c
-  data.tar.gz: c6f5876994fadb4cc44095e311548309703ffcec06ef5661512ab1fe9416340cea732b95b18d2230ea10dd754ef21c810d9dbf75c42febc79f09f302143073e6
+  metadata.gz: 3ec45bf229dcceaab6b9893dac3f96352789d45d7923e45551ace2e8fc92da1efcdf71adb2e50350f84783d66d247af666e2be24af78242e7ac9fceb323a2792
+  data.tar.gz: 3502e8e65b905792c767a6fda80865085eb3fd59d13857f7eb3e82c5e3d800615dbc7fc23c30cccb9ae9f8e44604f74939cde6f2f2dc7d5fe907678c1d64aa27

data/.rubocop.yml

@@ -1,4 +1,9 @@
 inherit_from: .rubocop.default.yml
 
+Metrics/AbcSize:
+  Enabled: false
+Metrics/LineLength:
+  max: 120
 Style/StringLiterals:
   EnforcedStyle: single_quotes
+

data/README.md

@@ -22,41 +22,90 @@ Or install it yourself as:
 
 ## Usage
 
-TelephoneNumber requires a country when parsing and validating phone numbers.
+You can obtain a `TelephoneNumber` object by calling: 
 
-**To validate a phone number:**
-
-    TelephoneNumber.valid?("(555) 555-5555", "US") ==> false
-
-You can pass an optional array of keys to check the validity against.
-
-    TelephoneNumber.valid?("(555) 555-5555", "US", [:mobile, :fixed_line]) ==> false
-
-**To parse a phone number:**
-
-    TelephoneNumber.parse("(317) 508-3348", "US") ==>
-
-        #<TelephoneNumber::Number:0x007fe3bc146cf0
-          @country="US",
-          @e164_number="13175083348",
-          @national_number="3175083348",
-          @original_number="3175083348">
-
-**To fetch valid types:**
-
-    TelephoneNumber.parse("(317) 508-3348", "US").valid_types ==>  ["mobile", "fixed_line"]
-
-**To format nationally:**
-
-    TelephoneNumber.parse("(317) 508-3348", "US").national_number ==> "(317) 508-3348"
-    TelephoneNumber.parse("(317) 508-3348", "US").national_number(formatted: false) ==> "3175083348"
+```
+phone_object = TelephoneNumber.parse("3175082237", :us) ==>
 
+#<TelephoneNumber::Number:0x007fe3bc146cf0
+  @country=:US,
+  @e164_number="13175083348",
+  @national_number="3175083348",
+  @original_number="3175083348">    
+```
+After that you have the following instance methods available to you. 
+
+- ### `valid_types`
+  
+  Returns all types that the number is considered valid for.
+  
+  `phone_object.valid_types ==> [:fixed_line, :mobile, :toll_free]`   
+
+- ### `valid?`
+
+  Returns boolean value indicating whether or not `valid_types` is empty.
+
+  `phone_object.valid? ==> true`
+
+- ### `national_number(formatted: true)`
+
+  Returns the national formatted number including special characters such as parenthesis and dashes. You can omit the special characters by passing `formatted: false`
+  
+  `phone_object.national_number ==> "(317) 508-2237"`
+
+- ### `international_number(formatted: true)`
+  
+  Returns the international formatted number including special characters such as parenthesis and dashes. You can omit the special characters by passing `formatted: false`
+
+  `phone_object.international_number ==> "+1 317-508-2237"`
+  
+- ### `e164_number(formatted: true)`
+
+  Returns the international formatted number including special characters such as parenthesis and dashes. You can omit the special characters by passing `formatted: false`
+  
+  `phone_object.e164_number ==> "+13175082237"`
+  
+- ### `country`
+  
+  Returns a symbol representation of the ISO 3166-1 alpha-2 for the country. 
+  
+  `phone_object.country ==> :US`
+  
+- ### `country_data`
+
+  Returns a symbolized hash of all data TelephoneNumber has about a number's particular country. 
+  
+### Class Methods
+  
+  You also have the following class methods available to you. 
+  
+  - #### `parse`
+  
+    Returns a TelephoneNumber object. 
+    
+    `TelephoneNumber.parse("3175082237", :US)`
+    
+  - #### `valid?`
+    
+    Returns boolean value indicating whether or not a particular number is valid.
+    
+    `TelephoneNumber.valid?("3175082237", :US) ==> true`
+    
+  - #### `invalid?`
+  
+    Returns boolean value indicating whether or not a particular number is invalid.
+    
+    `TelephoneNumber.invalid?("3175082237", :US) ==> false`
+    
 ## Configuration
 
+### Override File
+
 In the event that you need to override the data that Google is providing, you can do so by setting an override file. This file is expected to be in the same format as Google's as well as serialized using Marshal.
 
 To generate a serialized override file:
 
+    ruby bin/console
     TelephoneNumber.generate_override_file("/path/to/file")
 
 In this instance, `/path/to/file` represents an xml file that has your custom data in the same structure that Google's data is in.
@@ -64,11 +113,24 @@ In this instance, `/path/to/file` represents an xml file that has your custom da
 You can set the override file with:
 
     TelephoneNumber.override_file = "/path/to_file.dat"
+    
+### Default Number Pattern
 
+If TelephoneNumber is passed an invalid number and then asked to format that number, it will simply return an unformatted string of the originally passed number. This is because formatting rules will not be found for invalid numbers. If this is unacceptable, you can set a `default_format_pattern` and `default_format_string` that TelephoneNumber will use attempt to format invalid numbers. 
+
+```
+TelephoneNumber.default_format_pattern = "(\\d{3})(\\d{3})(\\d*)"
+TelephoneNumber.default_format_string = "($1) $2-$3"
+
+invalid_number = "1111111111"
+phone_object = TelephoneNumber.parse(invalid_number, :US)
+phone_object.national_number ==> "(111) 111-1111"
+```
+    
 ## Todo
 
 - Build custom validator to integrate with Rails
-- Build formatting functionality
+- ~~Build formatting functionality~~
 - Build extended data functionality(short codes, carrier data, etc.)
 
 ## Development

data/Rakefile

@@ -1,11 +1,12 @@
-require "bundler/gem_tasks"
-require "rake/testtask"
-require "telephone_number"
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'telephone_number'
 
 Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
+  t.libs << 'test'
+  t.libs << 'lib'
   t.test_files = FileList['test/**/*_test.rb']
+  t.warning = false
 end
 
 task :default => :test
@@ -13,7 +14,7 @@ task :default => :test
 namespace :data do
   namespace :main do
     task :import  do
-      TelephoneNumber::DataImporter.new(File.expand_path("data/telephone_number_data_file.xml")).import!
+      TelephoneNumber::DataImporter.new(File.expand_path('data/telephone_number_data_file.xml')).import!
     end
   end
 

data/bin/console

@@ -1,12 +1,12 @@
 #!/usr/bin/env ruby
 
-require "bundler/setup"
-require "telephone_number"
+require 'bundler/setup'
+require 'telephone_number'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
 
 # (If you use this, don't forget to add pry to your Gemfile!)
-require "pry"
+require 'pry'
 Pry.start
 

data/lib/telephone_number.rb

@@ -1,4 +1,5 @@
-require "telephone_number/version"
+require 'telephone_number/version'
+require 'utilities/hash'
 
 module TelephoneNumber
   autoload :DataImporter, 'telephone_number/data_importer'
@@ -22,6 +23,29 @@ module TelephoneNumber
     @@override_file
   end
 
+  # allows users to provide a default format string
+  @@default_format_string = nil
+
+  def self.default_format_string=(format_string)
+    @@default_format_string = format_string
+  end
+
+  def self.default_format_string
+    @@default_format_string
+  end
+
+  # allows users to provide a default format pattern
+  @@default_format_pattern = nil
+
+  def self.default_format_pattern=(format_string)
+    @@default_format_pattern = Regexp.new(format_string)
+  end
+
+  def self.default_format_pattern
+    @@default_format_pattern
+  end
+
+
   # generates binary file from xml that user gives us
   def self.generate_override_file(file)
     DataImporter.new(file).import!(override: true)

data/lib/telephone_number/data_importer.rb

@@ -5,7 +5,7 @@ module TelephoneNumber
 
     def initialize(file_name)
       @data = {}
-      @file = File.open(file_name){ |f| Nokogiri::XML(f) }
+      @file = File.open(file_name) { |f| Nokogiri::XML(f) }
     end
 
     def import!(override: false)
@@ -14,8 +14,8 @@ module TelephoneNumber
     end
 
     def parse_main_data
-      file.css("territories territory").each do |territory|
-        country_code = territory.attributes["id"].value.to_sym
+      file.css('territories territory').each do |territory|
+        country_code = territory.attributes['id'].value.to_sym
         @data[country_code] ||= {}
 
         load_base_attributes(@data[country_code], territory)
@@ -28,15 +28,15 @@ module TelephoneNumber
     private
 
     def load_formats(country_data, territory)
-      country_data[PhoneData::FORMATS] = territory.css("availableFormats numberFormat").map do |format|
-        format_hash = {}.tap do |fhash|
+      country_data[PhoneData::FORMATS] = territory.css('availableFormats numberFormat').map do |format|
+        {}.tap do |fhash|
           format.attributes.values.each do |attr|
             key = underscore(attr.name).to_sym
             fhash[key] = if key == PhoneData::NATIONAL_PREFIX_FORMATTING_RULE
-                            attr.value
-                          else
-                            attr.value.delete("\n ")
-                          end
+                           attr.value
+                         else
+                           attr.value.delete("\n ")
+                         end
           end
           format.elements.each do |child|
             key = underscore(child.name).to_sym
@@ -49,9 +49,9 @@ module TelephoneNumber
     def load_validations(country_data, territory)
       country_data[PhoneData::VALIDATIONS] = {}
       territory.elements.each do |element|
-        next if element.name == "references" || element.name == "availableFormats"
+        next if element.name == 'references' || element.name == 'availableFormats'
         country_data[PhoneData::VALIDATIONS][underscore(element.name).to_sym] = {}.tap do |validation_hash|
-          element.elements.each{|child| validation_hash[underscore(child.name).to_sym] = child.text.delete("\n ")}
+          element.elements.each { |child| validation_hash[underscore(child.name).to_sym] = child.text.delete("\n ") }
         end
       end
     end
@@ -59,7 +59,7 @@ module TelephoneNumber
     def load_base_attributes(country_data, territory)
       territory.attributes.each do |key, value_object|
         underscored_key = underscore(key).to_sym
-        country_data[underscored_key] = if  underscored_key == PhoneData::NATIONAL_PREFIX_FOR_PARSING
+        country_data[underscored_key] = if underscored_key == PhoneData::NATIONAL_PREFIX_FOR_PARSING
                                           value_object.value.delete("\n ")
                                         else
                                           value_object.value
@@ -68,21 +68,21 @@ module TelephoneNumber
     end
 
     def load_references(country_data, territory)
-      country_data[:references] = territory.css("references sourceUrl").map(&:text)
+      country_data[:references] = territory.css('references sourceUrl').map(&:text)
     end
 
     def underscore(camel_cased_word)
       return camel_cased_word unless camel_cased_word =~ /[A-Z-]|::/
       word = camel_cased_word.to_s.gsub(/::/, '/')
-      word.gsub!(/([A-Z\d]+)([A-Z][a-z])/,'\1_\2')
-      word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
-      word.tr!("-", "_")
+      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
 
     def save_data_file(override: false)
-      data_file = override ?  "telephone_number_data_override_file.dat" :  "#{File.dirname(__FILE__)}/../../data/telephone_number_data_file.dat"
+      data_file = override ? 'telephone_number_data_override_file.dat' : "#{File.dirname(__FILE__)}/../../data/telephone_number_data_file.dat"
       File.open(data_file, 'wb+') { |f| Marshal.dump(@data, f) }
     end
   end

data/lib/telephone_number/formatter.rb

@@ -1,13 +1,13 @@
 module TelephoneNumber
   module Formatter
     def build_national_number(formatted: true)
-      return normalized_number if !valid? || format.nil?
-      captures = normalized_number.match(Regexp.new(format[PhoneData::PATTERN])).captures
-      national_prefix_formatting_rule = format[PhoneData::NATIONAL_PREFIX_FORMATTING_RULE] \
+      return normalized_or_default if !valid? || number_format.nil?
+      captures = normalized_number.match(Regexp.new(number_format[PhoneData::PATTERN])).captures
+      national_prefix_formatting_rule = number_format[PhoneData::NATIONAL_PREFIX_FORMATTING_RULE] \
                                          || country_data[PhoneData::NATIONAL_PREFIX_FORMATTING_RULE]
 
-      format_string = format[PhoneData::FORMAT].gsub(/(\$\d)/) { |cap| "%#{cap.reverse}s" }
-      formatted_string = sprintf(format_string, *captures)
+      format_string = number_format[PhoneData::FORMAT].gsub(/(\$\d)/) { |cap| "%#{cap.reverse}s" }
+      formatted_string = format(format_string, *captures)
       captures.delete(PhoneData::MOBILE_TOKEN_COUNTRIES[country])
 
       if national_prefix_formatting_rule
@@ -26,21 +26,29 @@ module TelephoneNumber
     end
 
     def build_international_number(formatted: true)
-      return normalized_number if !valid? || format.nil?
-      captures = normalized_number.match(Regexp.new(format[PhoneData::PATTERN])).captures
-      key = format.fetch(PhoneData::INTL_FORMAT, 'NA') != 'NA' ? PhoneData::INTL_FORMAT : PhoneData::FORMAT
-      format_string = format[key].gsub(/(\$\d)/) { |cap| "%#{cap.reverse}s" }
-      "+#{country_data[PhoneData::COUNTRY_CODE]} #{sprintf(format_string, *captures)}"
+      return normalized_or_default if !valid? || number_format.nil?
+      captures = normalized_number.match(Regexp.new(number_format[PhoneData::PATTERN])).captures
+      key = number_format.fetch(PhoneData::INTL_FORMAT, 'NA') != 'NA' ? PhoneData::INTL_FORMAT : PhoneData::FORMAT
+      format_string = number_format[key].gsub(/(\$\d)/) { |cap| "%#{cap.reverse}s" }
+      formatted_string = "+#{country_data[PhoneData::COUNTRY_CODE]} #{format(format_string, *captures)}"
+      formatted ? formatted_string : sanitize(formatted_string)
     end
 
     private
 
-    def extract_format
+    def normalized_or_default
+      return normalized_number if !TelephoneNumber.default_format_string || !TelephoneNumber.default_format_pattern
+      captures = normalized_number.match(TelephoneNumber.default_format_pattern).captures
+      format_string = TelephoneNumber.default_format_string.gsub(/(\$\d)/) { |cap| "%#{cap.reverse}s" }
+      format(format_string, *captures)
+    end
+
+    def extract_number_format
       native_country_format = detect_format(country.to_sym)
       return native_country_format if native_country_format
 
       # This means we couldn't find an applicable format so we now need to scan through the hierarchy
-      parent_country_code = PhoneData.phone_data.detect do |country_code, country_data|
+      parent_country_code = PhoneData.phone_data.detect do |_country_code, country_data|
         country_data[PhoneData::COUNTRY_CODE] == PhoneData.phone_data[self.country.to_sym][PhoneData::COUNTRY_CODE] \
           && country_data[PhoneData::MAIN_COUNTRY_FOR_CODE] == 'true'
       end

data/lib/telephone_number/number.rb

@@ -52,8 +52,8 @@ module TelephoneNumber
 
     private
 
-    def format
-      @format ||= extract_format
+    def number_format
+      @number_format ||= extract_number_format
     end
   end
 end

data/lib/telephone_number/parser.rb

@@ -3,14 +3,14 @@ module TelephoneNumber
     KEYS_TO_SKIP = [PhoneData::GENERAL, PhoneData::AREA_CODE_OPTIONAL]
 
     def sanitize(input_number)
-      return input_number.gsub(/[^0-9]/, "")
+      return input_number.gsub(/[^0-9]/, '')
     end
 
     # returns an array of valid types for the normalized number
     # if array is empty, we can assume that the number is invalid
     def validate
       return [] unless country_data
-      applicable_keys = country_data[PhoneData::VALIDATIONS].reject{ |key, _value| KEYS_TO_SKIP.include?(key) }
+      applicable_keys = country_data[PhoneData::VALIDATIONS].reject { |key, _value| KEYS_TO_SKIP.include?(key) }
       applicable_keys.map do |phone_type, validations|
         full = "^(#{validations[PhoneData::VALID_PATTERN]})$"
         phone_type.to_sym if normalized_number =~ Regexp.new(full)
@@ -25,7 +25,7 @@ module TelephoneNumber
 
       number_with_correct_prefix = parse_prefix
 
-      reg_string  = "^(#{country_code})?"
+      reg_string = "^(#{country_code})?"
       reg_string << "(#{country_data[PhoneData::NATIONAL_PREFIX]})?"
       reg_string << "(#{country_data[PhoneData::VALIDATIONS][PhoneData::GENERAL][PhoneData::VALID_PATTERN]})$"
 
@@ -53,16 +53,16 @@ module TelephoneNumber
 
     def transform_national_prefix(duped, match_object)
       if PhoneData::MOBILE_TOKEN_COUNTRIES.include?(country) && match_object.captures.any?
-        sprintf(build_format_string, duped.sub!(match_object[0], match_object[1]))
+        format(build_format_string, duped.sub!(match_object[0], match_object[1]))
       elsif match_object.captures.none?
         duped.sub!(match_object[0], '')
       else
-        sprintf(build_format_string, *match_object.captures)
+        format(build_format_string, *match_object.captures)
       end
     end
 
     def build_format_string
-      country_data[:national_prefix_transform_rule].gsub(/(\$\d)/) {|cap| "%#{cap.reverse}s"}
+      country_data[:national_prefix_transform_rule].gsub(/(\$\d)/) { |cap| "%#{cap.reverse}s" }
     end
   end
 end

data/lib/telephone_number/phone_data.rb

@@ -1,32 +1,32 @@
 module TelephoneNumber
   module PhoneData
-    AREA_CODE_OPTIONAL = :area_code_optional.freeze
-    COUNTRY_CODE = :country_code.freeze
-    FIXED_LINE = :fixed_line.freeze
-    FORMATS = :formats.freeze
-    FORMAT = :format.freeze
-    GENERAL = :general_desc.freeze
-    INTERNATIONAL_PREFIX = :international_prefix.freeze
-    INTL_FORMAT = :intl_format.freeze
-    LEADING_DIGITS = :leading_digits.freeze
-    MAIN_COUNTRY_FOR_CODE = :main_country_for_code.freeze
-    MOBILE = :mobile.freeze
+    AREA_CODE_OPTIONAL = :area_code_optional
+    COUNTRY_CODE = :country_code
+    FIXED_LINE = :fixed_line
+    FORMATS = :formats
+    FORMAT = :format
+    GENERAL = :general_desc
+    INTERNATIONAL_PREFIX = :international_prefix
+    INTL_FORMAT = :intl_format
+    LEADING_DIGITS = :leading_digits
+    MAIN_COUNTRY_FOR_CODE = :main_country_for_code
+    MOBILE = :mobile
     MOBILE_TOKEN_COUNTRIES = { AR: '9' }.freeze
-    NATIONAL_PREFIX = :national_prefix.freeze
-    NATIONAL_PREFIX_FOR_PARSING = :national_prefix_for_parsing.freeze
-    NATIONAL_PREFIX_FORMATTING_RULE = :national_prefix_formatting_rule.freeze
-    NO_INTERNATIONAL_DIALING = :no_international_dialling.freeze
+    NATIONAL_PREFIX = :national_prefix
+    NATIONAL_PREFIX_FOR_PARSING = :national_prefix_for_parsing
+    NATIONAL_PREFIX_FORMATTING_RULE = :national_prefix_formatting_rule
+    NO_INTERNATIONAL_DIALING = :no_international_dialling
     PATTERN = :pattern
-    PERSONAL_NUMBER = :personal_number.freeze
-    POSSIBLE_PATTERN = :possible_number_pattern.freeze
-    PREMIUM_RATE = :premium_rate.freeze
-    SHARED_COST = :shared_cost.freeze
-    TOLL_FREE = :toll_free.freeze
-    UAN = :uan.freeze
-    VALIDATIONS = :validations.freeze
-    VALID_PATTERN = :national_number_pattern.freeze
-    VOICEMAIL = :voicemail.freeze
-    VOIP = :voip.freeze
+    PERSONAL_NUMBER = :personal_number
+    POSSIBLE_PATTERN = :possible_number_pattern
+    PREMIUM_RATE = :premium_rate
+    SHARED_COST = :shared_cost
+    TOLL_FREE = :toll_free
+    UAN = :uan
+    VALIDATIONS = :validations
+    VALID_PATTERN = :national_number_pattern
+    VOICEMAIL = :voicemail
+    VOIP = :voip
 
     def self.phone_data
       @@phone_data ||= load_data
@@ -37,7 +37,7 @@ module TelephoneNumber
       main_data = Marshal.load(File.binread(data_file))
       override_data = {}
       override_data = Marshal.load(File.binread(TelephoneNumber.override_file)) if TelephoneNumber.override_file
-      return main_data.merge!(override_data)
+      return main_data.deep_deep_merge!(override_data)
     end
   end
 end

data/lib/telephone_number/test_data_generator.rb

@@ -50,7 +50,7 @@ module TelephoneNumber
         output_hash[key] = {}
 
         value.each_with_index do |num, counter|
-          page = HTTParty.get(sprintf(URL, num, key.to_s))
+          page = HTTParty.get(format(URL, num, key.to_s))
           parsed_page = Nokogiri::HTML.parse(page)
           body = parsed_page.elements.first.elements.css('body').first
           parsed_data = parse_remote_data(counter, body.elements.css('table')[2])

data/lib/telephone_number/version.rb

@@ -1,3 +1,3 @@
 module TelephoneNumber
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/utilities/hash.rb

@@ -0,0 +1,38 @@
+class Hash
+  # Returns a new hash with +self+ and +other_hash+ merged recursively.
+  #
+  #   h1 = { a: true, b: { c: [1, 2, 3] } }
+  #   h2 = { a: false, b: { x: [3, 4, 5] } }
+  #
+  #   h1.deep_merge(h2) # => { a: false, b: { c: [1, 2, 3], x: [3, 4, 5] } }
+  #
+  # Like with Hash#merge in the standard library, a block can be provided
+  # to merge values:
+  #
+  #   h1 = { a: 100, b: 200, c: { c1: 100 } }
+  #   h2 = { b: 250, c: { c1: 200 } }
+  #   h1.deep_merge(h2) { |key, this_val, other_val| this_val + other_val }
+  #   # => { a: 100, b: 450, c: { c1: 300 } }
+  def deep_deep_merge(other_hash, &block)
+    dup.deep_deep_merge!(other_hash, &block)
+  end
+
+  # Same as +deep_merge+, but modifies +self+.
+  def deep_deep_merge!(other_hash, &block)
+    other_hash.each_pair do |current_key, other_value|
+      this_value = self[current_key]
+
+      self[current_key] = if this_value.is_a?(Hash) && other_value.is_a?(Hash)
+        this_value.deep_deep_merge(other_value, &block)
+      else
+        if block_given? && key?(current_key)
+          block.call(current_key, this_value, other_value)
+        else
+          other_value
+        end
+      end
+    end
+
+    self
+  end
+end

data/telephone_number.gemspec

@@ -4,29 +4,29 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'telephone_number/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "telephone_number"
+  spec.name          = 'telephone_number'
   spec.version       = TelephoneNumber::VERSION
   spec.author        = 'MOBI Wireless Management'
-  spec.email         = ["adam.fernung@mobiwm.com", "josh.wetzel@mobiwm.com"]
+  spec.email         = ['adam.fernung@mobiwm.com', 'josh.wetzel@mobiwm.com']
   spec.summary       = 'Phone number validation'
-  spec.homepage      = "https://github.com/mobi/telephone_number"
-  spec.license       = "MIT"
+  spec.homepage      = 'https://github.com/mobi/telephone_number'
+  spec.license       = 'MIT'
 
 
   spec.files         = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})
   end
-  spec.bindir        = "exe"
+  spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
-  spec.add_development_dependency "bundler"
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency "minitest"
-  spec.add_development_dependency "pry"
-  spec.add_development_dependency "pry-byebug"
-  spec.add_development_dependency "nokogiri"
-  spec.add_development_dependency "httparty"
-  spec.add_development_dependency "minitest-focus"
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'minitest'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'pry-byebug'
+  spec.add_development_dependency 'nokogiri'
+  spec.add_development_dependency 'httparty'
+  spec.add_development_dependency 'minitest-focus'
   spec.add_development_dependency 'coveralls'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: telephone_number
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - MOBI Wireless Management
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-02-01 00:00:00.000000000 Z
+date: 2017-02-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -168,6 +168,7 @@ files:
 - lib/telephone_number/phone_data.rb
 - lib/telephone_number/test_data_generator.rb
 - lib/telephone_number/version.rb
+- lib/utilities/hash.rb
 - telephone_number.gemspec
 homepage: https://github.com/mobi/telephone_number
 licenses: