phony 2.22.7 → 3.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a0232ad1bb74afc030a899aacce2e9c478baace2f599fe75dc7f04ded271e10
-  data.tar.gz: 5f92fbceede92639520864a37ef4e1948a0455bddca9ca4aedbc89a95971b727
+  metadata.gz: e5491894cacb9480a995f6019cee2bc68b3d3e02b8e18f5263e014478b2877e4
+  data.tar.gz: 11c7378a92034ac69617aaa0dd5e0ce2a4da0b1cc29b5ae88a7ee471a8e3c546
 SHA512:
-  metadata.gz: ca05c2c33863f7816d6b21d3e1bfe75c1fd48c6458ce1f0404ddb89f362df1d8c7892e667b5e3452d33e392b3904445365aa1ec456e9d3ed9b1e3d08bec97bcf
-  data.tar.gz: d69be3c2e154a175dd76312260caa901112512fe40a164c9ba9ae9748e5db3ee6a6d12e47d328329c669e4fdd48916ceaf7028b2ad0bccfa2ab9f4938809f0f2
+  metadata.gz: 7be10b412c69bb4e034b2fdba3968c25191205d89a6c861468169f799d0a28e5d555a1c5a2a3f8a96b957ab0ac5c625c826001f048b6b4055f5da63872329b46
+  data.tar.gz: '0619a41caaaeb7d1a72d1688811355bcc6343fdac0c5e54d19fec4e2d90049eb0a73ed04eec0c432f74940ac5c7ba765a7adb7f9d893588b0cdc73d3ec9f7a74'

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/countries.rb

@@ -101,7 +101,7 @@ Phony.define do
                 match(/^(800|90\d)\d+$/)     >> split(2, 3)   | # Toll free service and premium numbers
                 match(/^(46[056789])\d{6}$/) >> split(2, 2, 2) | # Mobile (Lycamobile, Telenet, Join Experience, Proximus 0460)
                 match(/^(4[789]\d)\d{6}$/)   >> split(2, 2, 2) | # Mobile
-                match(/^(45[156])\d{6}$/)     >> split(2, 2, 2) | # Mobile Vikings, Digi and Voo
+                match(/^(45[156])\d{6}$/)    >> split(2, 2, 2) | # Mobile Vikings, Digi and Voo
                 one_of('2', '3', '4', '9') >> split(3, 2, 2) | # Short NDCs
                 fixed(2) >> split(2, 2, 2) # 2-digit NDCs
 
@@ -251,7 +251,7 @@ Phony.define do
           match(/^(13)\d+$/)    >> split(2, 2) | # 13 local rate
           fixed(1)              >> split(4, 4)   # Rest
 
-   # country '62' # Indonesia (Republic of), see special file
+  # country '62' # Indonesia (Republic of), see special file
 
   # Philippines (Republic of the)
   # https://www.numberingplans.com/?page=plans&sub=phonenr&alpha_2_input=PH
@@ -279,7 +279,9 @@ Phony.define do
 
   # Singapore (Republic of).
   #
+  # There is no trunk code for this country and some numbers start with 0.
   country '65',
+          trunk('', normalize: false) |
           none >> matched_split(
             /^(800)\d{7}$/ => [3, 3, 4], # International Toll Free Service (ITFS) and Home Country Direct Service (HCDS) Numbers
             /^\d{8}$/ => [4, 4] # TODO: Short Codes
@@ -375,7 +377,7 @@ Phony.define do
 
   # Benin http://www.itu.int/oth/T0202000017/en
   #
-  # There is no trunk code for this country and prefixes start with 0
+  # There is no trunk code for this country and prefixes start with 0.
   country '229',
           trunk('', normalize: false) |
           none >> matched_split(

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: phony
 version: !ruby/object:Gem::Version
-  version: 2.22.7
+  version: 3.0.1
 platform: ruby
 authors:
 - Florian Hanke
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-03 00:00:00.000000000 Z
+date: 2025-12-13 00:00:00.000000000 Z
 dependencies: []
 description: 'Fast international phone number (E164 standard) normalizing, splitting
   and formatting. Lots of formatting options: International (+.., 00..), national
@@ -17,9 +17,9 @@ email: florian.hanke+phony@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- README.textile
+- README.md
 files:
-- README.textile
+- README.md
 - lib/phony.rb
 - lib/phony/config.rb
 - lib/phony/countries.rb
@@ -82,7 +82,8 @@ files:
 homepage: https://github.com/floere/phony
 licenses:
 - MIT
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -91,7 +92,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/README.textile

@@ -1,116 +0,0 @@
-"!{float:right}https://secure.travis-ci.org/floere/phony.png!":http://travis-ci.org/floere/phony
-!https://coveralls.io/repos/floere/phony/badge.svg?branch=master(Coverage Status)!:https://coveralls.io/r/floere/phony?branch=master
-"!https://codeclimate.com/github/floere/phony.png!":https://codeclimate.com/github/floere/phony
-!http://inch-ci.org/github/floere/phony.png!:http://inch-ci.org/github/floere/phony
-
-h1. 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).
-
-h2(#memory). Runtime Memory Usage
-
-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'@
-
-h2. Description
-
-This gem normalizes, formats and splits "*E164 phone numbers*":http://en.wikipedia.org/wiki/E.164. 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.
-
-h2. 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.
-
-h2(#usage). Usage docs
-
-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.
-
-h3(#normalizing). Phony.normalize(number)
-
-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'@
-
-h3(#formatting). Phony.format(number, options = {})
-
-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'@
-
-h3(#plausibility). Phony.plausible?(number, options = {})
-
-Is a number plausible?
-
-"Phony.plausible? docs":./qed/plausibility.md
-
-@Phony.assert.plausible?('+41 44 111 22 33')@
-
-h3(#splitting). Phony.split(number)
-
-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']@
-
-h3(#loading). Loading only a country subset (Phony 2.18.0+).
-
-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.
-
-h2. 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.
-
-h2. Proud Sponsors
-
-* Renuo AG (July 2022 – January 2025): "Github":https://github.com/renuo, "Homepage":https://www.renuo.ch. Much appreciated!
-
-h2. License
-
-MIT.
-See "LICENSE":./LICENSE file.