phony 2.18.3 → 3.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f999191cc1bc0a50f69f2330b8b9abacf7c27223460b27b83fa12e7921e38e3
-  data.tar.gz: 34262181d5b43964268f916e88e98c989b12265af7cf739e11fc45b5e0a0f293
+  metadata.gz: 791dda58c1a448a35162db9f85af9fd103500e3120796c04d60c0a190773a9b7
+  data.tar.gz: 27933aabd62b90068779bc6d3ba4bbbecb64fbc24ffea12b00accbe00f790aaa
 SHA512:
-  metadata.gz: a8105b14ad360a98f86c85b9c9ef4e4ab616c749d6aa1ec2d09d732cce8a5cc6c0cc98a005cb7bd82f39da2e6452e48f0a4b3bb677c055b124f872cbd45d0c66
-  data.tar.gz: 1ab16b6d15ba9a13cfb0d72b6073b24d3009db8c60282b1d9b44321674d9db6117885e0043c6eaad721eb7bc93de514a05fbcdb59c69b6b8f1ec7c1caeeaeacb
+  metadata.gz: 61a2344d76eb13b2660803ea4c0f89a01171fdb2e314cffda9b5229c26aa5586a72a3f7c407e525170159783e719b40aae6f3d4822254e082f2e42faa8cb0266
+  data.tar.gz: 2eaeb27b07f7ddf7b9291f1deb6f09cff24b1cdd7d00f4086a4f951d26c98e4605570cc7309e8159ff04090fd4cac7f0ac09be95f1017050ff2a685f389558b9

data/README.md

@@ -0,0 +1,117 @@
+[![Build Status](https://secure.travis-ci.org/floere/phony.png)](http://travis-ci.org/floere/phony)
+[![Coverage Status](https://coveralls.io/repos/floere/phony/badge.svg?branch=master)](https://coveralls.io/r/floere/phony?branch=master)
+[![Code Climate](https://codeclimate.com/github/floere/phony.png)](https://codeclimate.com/github/floere/phony)
+[![Inline docs](http://inch-ci.org/github/floere/phony.png)](http://inch-ci.org/github/floere/phony)
+
+# Phony
+
+Disclaimer: Phony works with international numbers only, such as `61 412 345 678`!
+
+The (admittedly crazy) goal of this Gem is to be able to normalize/format/split all phone numbers in the world.
+
+Used in: [airbnb.com](http://airbnb.com), [socialcam.com](http://socialcam.com), [zendesk.com](http://www.zendesk.com/) (and many, many others).
+
+## Runtime Memory Usage {#memory}
+
+According to [memory_profiler](https://github.com/SamSaffron/memory_profiler), the Phony gem uses roughly 1MB of memory per Ruby process.
+Usage was generated using (look for `Total retained`): `ruby -e 'require "memory_profiler"; MemoryProfiler.report(allow_files: "phony"){ require "phony" }.pretty_print'`
+
+## Description
+
+This gem normalizes, formats and splits "**E164 phone numbers**". A valid E164 phone number **must** include a country code.
+
+E164 numbers are international numbers with a country dial prefix, usually an area code and a subscriber number. For example, the Australian number `+61 412 345 678` can be broken down into the following components:
+* Country Code (CC): a country code of `61`
+* National Destination Code (NDC): a mobile number denoted by the `4` (specific to Australia)
+* Local Number Part: a subscriber number of `12 345 678`
+
+It currently handles the countries listed at the end of this README.
+
+It is covered by roughly 2,250 tests that run in 2 seconds (April 2019).
+If it doesn't work, please [enter an issue](http://github.com/floere/phony/issues) or better, fork and [send a pull request](http://github.com/floere/phony/pulls).
+
+## Installation
+
+With Rails? Check out: https://github.com/joost/phony_rails.
+
+With Bundler: Append `gem 'phony'` to your `Gemfile` and `bundle install` it.
+
+Without Bundler: Run `gem install phony` from your command line.
+
+## Usage docs {#usage}
+
+Phony uses [qed](https://github.com/rubyworks/qed) as docs and to run its functional tests. Start here for usage docs: [Usage index](./qed/index.md).
+
+### Phony.normalize(number) {#normalizing}
+
+Normalize intelligently removes all non-numeric characters of a number. Do it before storing a number in a DB.
+
+[Phony.normalize docs](./qed/normalize.md)
+
+`Phony.normalize('1-888-407-4747').assert == '18884074747'`
+
+### Phony.format(number, options = {}) {#formatting}
+
+Format formats a normalized number according to a country's predominant formatting. Lots of options for int'l, national, local formatting.
+
+[Phony.format docs](./qed/format.md)
+
+`Phony.format('41443643532').assert == '+41 44 364 35 32'`
+
+### Phony.plausible?(number, options = {}) {#plausibility}
+
+Is a number plausible?
+
+[Phony.plausible? docs](./qed/plausibility.md)
+
+`Phony.assert.plausible?('+41 44 111 22 33')`
+
+### Phony.split(number) {#splitting}
+
+Split a number into its parts: CC, NDC, local.
+
+[Phony.split docs](./qed/split.md)
+
+`Phony.split('3928061371').assert == ['39', '2', '806', '1371']`
+
+NB If a country does not have an NDC, `#split` will return `false` in the NDC position, for example for Denmark:
+
+`Phony.split('4512121212').assert == ['45', false, '12', '12', '12', '12']`
+
+### Loading only a country subset (Phony 2.18.0+). {#loading}
+
+Use this in case you'd like to save [memory](#memory) that is used by Phony's CC rules.
+
+[Phony::Config.load docs](./qed/config.md)
+
+First, `require 'phony/config'`.
+Then, one of the following, which will load the rest of Phony.
+
+Load only these CCs:
+`Phony::Config.load(only: ['41', '44'])`
+
+Loads everything except these CCs:
+`Phony::Config.load(except: ['41', '44'])`
+
+Convenience form of `only`:
+`Phony::Config.load('41', '44')`
+
+Each of these loads the rest of Phony.
+
+Memory usage can be checked using (look for `Total retained`):
+`ruby -e 'require "memory_profiler"; MemoryProfiler.report(allow_files: "phony"){ require "phony/config"; Phony::Config.load("1") }.pretty_print'`
+For example, when just loading the NANP CC, the retained memory usage is ~63kB.
+
+## List of Handled Countries
+
+Mildly unmaintained list: Abhas, Afghan, Algerian, Argentina, Austrian, Australian, Azerbaijani, Belgian, Brazilian, Cambodian, Chilean, Chinese, Croatian, Cuban, Cypriot, Czech, Danish, Dutch, Egyptian, El Salvadorian, Estonian, French, German, Ghanan, Gibraltar, Greek, Haiti, Hong Kong, Hungarian, Indian, Iran, Irish, Israel, Italian, Japanese, Kazakh, Liberian, Lithuanian, Luxembourgian, Malaysian, Malta, Mauritian, Mexican, Monaco, Morocco, New Zealand, Nigerian, Norwegian, Peruvian, Polish, Romanian, Russian, Rwandan, Seychelles, Singapore, Slovakian, South African, South Korean, South Osetian, Spanish, Sri Lankan, Sudan, Swedish, Swiss, Thailand, Tunisian, Turkish, Liechtenstein, UK, US, Venezuelan, Vietnamese, and Zambian numbers.
+
+## Proud Sponsors
+
+* Renuo AG (July 2022 – January 2025): [Github](https://github.com/renuo), [Homepage](https://www.renuo.ch). Much appreciated!
+
+## License
+
+MIT.
+See [LICENSE](./LICENSE) file.
+

data/lib/phony/config.rb

@@ -1,53 +1,53 @@
 # frozen_string_literal: true
 
 module Phony
-  
   # Add config.
   class << self
     attr_writer :config
-    
+
     def config
       # Default config includes all CCs.
       @config ||= Config.new([], [])
     end
   end
-  
+
   # The Config class is only used to configure Phony and to load specific
   # subsets of CCs.
   #
   class Config
-    
     attr_reader :included_ccs, :excluded_ccs
-    
-    def initialize included_ccs, excluded_ccs
+
+    def initialize(included_ccs, excluded_ccs)
       @included_ccs = included_ccs || []
       @excluded_ccs = excluded_ccs || []
     end
-    
-    def load? cc
+
+    def load?(cc)
       return false if has_excluded? && excluded_ccs.include?(cc)
-      
+
       if has_included?
         # We have to check the included_ccs, otherwise false.
         return true if included_ccs.include?(cc)
-        
+
         false
       else
         # It's not in excluded and no included was given.
         true
       end
     end
+
     def has_included?
       !included_ccs.empty?
     end
+
     def has_excluded?
       !excluded_ccs.empty?
     end
-    
+
     # Use as follows:
     #
     #   require 'phony/config'
-    #   
+    #
     #   # Load only these:
     #   Phony::Config.load(only: ['41', '44'])
     #   # or all except these:
@@ -61,31 +61,30 @@ module Phony
       # Extract options.
       last = options.last
       only, except = if last.respond_to?(:to_hash)
-        # We have the explicit form.
-        [last[:only], last[:except]]
-      elsif options.respond_to?(:to_ary)
-        # We have the convenience short forms.
-        [options, []]
-      end
-      
+                       # We have the explicit form.
+                       [last[:only], last[:except]]
+                     elsif options.respond_to?(:to_ary)
+                       # We have the convenience short forms.
+                       [options, []]
+                     end
+
       # Set defaults.
       only, except = [only || [], except || []]
       # Convert to expected format if possible.
       only, except = [only.map(&:to_s), except.map(&:to_s)]
-      
+
       # Check params.
       raise "Params given to Phony::Config.load must be Array-like. The one given was: #{only}" unless only.respond_to?(:to_ary)
       raise "Params given to Phony::Config.load must be Array-like. The one given was: #{except}" unless except.respond_to?(:to_ary)
-      
+
       # Configure Phony.
       Phony.config = new(only, except)
-      
+
       # Load phony.
-      Kernel.load File.expand_path('../../phony.rb', __FILE__)
-      
+      Kernel.load File.expand_path('../phony.rb', __dir__)
+
       # Return the stored config data.
       Phony.config
     end
-    
   end
-end
+end

data/lib/phony/countries/argentina.rb

@@ -0,0 +1,352 @@
+# frozen_string_literal: true
+
+# Argentinian numbers are all ten digits long.
+# Information taken from:
+# https://www.enacom.gob.ar/multimedia/normativas/1997/Resolucion%2046_97.pdf
+# http://www.wtng.info/wtng-54-ar.html
+# https://en.wikipedia.org/wiki/Telephone_numbers_in_Argentina
+# Area codes collected from https://www.enacom.gob.ar/indicativos-interurbanos_p366 (06/27/19)
+
+# Landline
+area_codes_2digits = [
+  '11'
+]
+
+area_codes_3digits = %w[
+  220
+  221
+  223
+  230
+  236
+  237
+  249
+  260
+  261
+  263
+  264
+  266
+  280
+  291
+  294
+  297
+  298
+  299
+  336
+  341
+  342
+  343
+  345
+  348
+  351
+  353
+  358
+  362
+  364
+  370
+  376
+  379
+  380
+  381
+  383
+  385
+  387
+  388
+]
+
+area_codes_4digits = %w[
+  2202
+  2221
+  2223
+  2224
+  2225
+  2226
+  2227
+  2229
+  2241
+  2242
+  2243
+  2244
+  2245
+  2246
+  2252
+  2254
+  2255
+  2257
+  2261
+  2262
+  2264
+  2265
+  2266
+  2267
+  2268
+  2271
+  2272
+  2273
+  2274
+  2281
+  2283
+  2284
+  2285
+  2286
+  2291
+  2292
+  2296
+  2297
+  2302
+  2314
+  2316
+  2317
+  2320
+  2323
+  2324
+  2325
+  2326
+  2331
+  2333
+  2334
+  2335
+  2336
+  2337
+  2338
+  2342
+  2343
+  2344
+  2345
+  2346
+  2352
+  2353
+  2354
+  2355
+  2356
+  2357
+  2358
+  2392
+  2393
+  2394
+  2395
+  2396
+  2473
+  2474
+  2475
+  2477
+  2478
+  2622
+  2624
+  2625
+  2626
+  2646
+  2647
+  2648
+  2651
+  2655
+  2656
+  2657
+  2658
+  2901
+  2902
+  2903
+  2920
+  2921
+  2922
+  2923
+  2924
+  2925
+  2926
+  2927
+  2928
+  2929
+  2931
+  2932
+  2933
+  2934
+  2935
+  2936
+  2940
+  2942
+  2945
+  2946
+  2948
+  2952
+  2953
+  2954
+  2962
+  2963
+  2964
+  2966
+  2972
+  2982
+  2983
+  3327
+  3329
+  3382
+  3385
+  3387
+  3388
+  3400
+  3401
+  3402
+  3404
+  3405
+  3406
+  3407
+  3408
+  3409
+  3435
+  3436
+  3437
+  3438
+  3442
+  3444
+  3445
+  3446
+  3447
+  3454
+  3455
+  3456
+  3458
+  3460
+  3462
+  3463
+  3464
+  3465
+  3466
+  3467
+  3468
+  3469
+  3471
+  3472
+  3476
+  3482
+  3483
+  3487
+  3489
+  3491
+  3492
+  3493
+  3496
+  3497
+  3498
+  3521
+  3522
+  3524
+  3525
+  3532
+  3533
+  3537
+  3541
+  3542
+  3543
+  3544
+  3546
+  3547
+  3548
+  3549
+  3562
+  3563
+  3564
+  3571
+  3572
+  3573
+  3574
+  3575
+  3576
+  3582
+  3583
+  3584
+  3585
+  3711
+  3715
+  3716
+  3718
+  3721
+  3725
+  3731
+  3734
+  3735
+  3741
+  3743
+  3751
+  3754
+  3755
+  3756
+  3757
+  3758
+  3772
+  3773
+  3774
+  3775
+  3777
+  3781
+  3782
+  3786
+  3821
+  3825
+  3826
+  3827
+  3832
+  3835
+  3837
+  3838
+  3841
+  3843
+  3844
+  3845
+  3846
+  3854
+  3855
+  3856
+  3857
+  3858
+  3861
+  3862
+  3863
+  3865
+  3867
+  3868
+  3869
+  3873
+  3876
+  3877
+  3878
+  3885
+  3886
+  3887
+  3888
+  3891
+  3892
+  3894
+]
+
+# Mobile
+# Mobile phone numbers in Argentina are assigned the same geographic area codes as fixed lines,
+# according to the subscriber's choice or residence, and can be 6, 7 or 8 digits long, just as
+# landline numbers are. The difference with landline numbers is that a prefix 15, never used for
+# landlines, must be dialed.
+
+# International: +54 + 9 + area code + subscriber number (without '15' prefix)
+# Domestic: area code + 15 + subscriber number
+# Mobile numbers in Argentina may be listed as 15-xxxxxxx. However, the leading '15'
+# is a domestic prefix which must be omitted when calling these from outside Argentina,
+# with the xxxxxxx being the actual subscriber number portion.
+
+# Non-geographic numbers 0ppp-nnn-nnnn
+special_numbers = [
+  '800', # toll-free telephone numbers
+  '810', # calls from any area chargeable at local rate
+  '822', # toll-free numbers used for calling card access
+  '600', # premium-rate telephone numbers
+  '609', # premium, fixed-rate gaming numbers
+  '610', # dial-up Internet access numbers, usually cheaper than a local call, less frequently used as dial-up Internet access decreased
+  '605' # premium-rate telephone numbers for charity donations
+]
+
+Phony.define do
+  country '54', trunk('0') |
+                one_of(area_codes_4digits) >> split(2, 4) | # landline
+                one_of(area_codes_3digits) >> split(3, 4) | # landline
+                one_of(area_codes_2digits) >> split(4, 4) | # landline
+                one_of(area_codes_2digits.map { |x| "9#{x}" }) >> split(4, 4) | # mobile
+                one_of(area_codes_3digits.map { |x| "9#{x}" }) >> split(3, 4) | # mobile
+                one_of(area_codes_4digits.map { |x| "9#{x}" }) >> split(2, 4) | # mobile
+                one_of(special_numbers) >> split(3, 4)
+end