floere/phony

## Phony.normalize

Normalizes a number, such that only numbers remain.
Use before saving a normalized form into a database.

This will often raise an error if you try normalizing a non E164-izable number (a number that does not contain enough information to be normalized into an E164 conform number). Use Phony.plausible? for checking if it can be normalized first.

Example:

    # No. Wrong. Nada.
    Phony.normalize('364 35 33')

Always use it with a country code, as Phony needs it to know what country to normalize for:

    Phony.normalize('41443643533').assert            == '41443643533'
    Phony.normalize('+41 44 364 35 33').assert       == '41443643533'
    Phony.normalize('+41 44 364 35 33').assert       == '41443643533'
    Phony.normalize('+41 800 11 22 33').assert       == '41800112233'
    Phony.normalize('John: +41 44 364 35 33').assert == '41443643533'
    Phony.normalize('1 (703) 451-5115').assert       == '17034515115'
    Phony.normalize('1-888-407-4747').assert         == '18884074747'
    Phony.normalize('1.906.387.1698').assert         == '19063871698'
    Phony.normalize('+41 (044) 364 35 33').assert    == '41443643533'

### Example countries

#### NANP

Handles a CC.

    Phony.normalize('+1 724 999 9999').assert == '17249999999'

Allows for providing a missing CC.
    
    Phony.normalize('(310) 555-2121', cc: '1').assert == '13105552121'
    
Normalizes numbers with special characters.

    Phony.normalize('1 (703) 451-5115').assert == '17034515115'

Normalizes numbers with special characters.

    Phony.normalize('1-888-407-4747').assert == '18884074747'

#### Belarus

    Phony.normalize('375 152450911').assert == '375152450911'
    Phony.normalize('375 80 331234567').assert == '375331234567'

#### Cambodia

Handles numbers with an extra 0.

    Phony.normalize('+855012239134').assert == "85512239134"

#### Germany

Handles a number with extra (0).

    Phony.normalize('+49 (0) 209 22 33 44 55').assert == '4920922334455'

Handles a number with extra 0.

    Phony.normalize('+49 0 209 22 33 44 55').assert == '4920922334455'

#### Hungary

    Phony.normalize('36 0630245506').assert == '360630245506'
    
#### Japan

    # TODO Phony.normalize('03-1234-5634', cc: '81').assert == '81312345634'

#### Japan

    Phony.normalize('+81 3-1234-5634').assert == '81312345634'
    Phony.normalize('3-1234-5634', cc: '81').assert == '81312345634'
    Phony.normalize('03-1234-5634', cc: '81').assert == '81312345634'

#### Lithuania

    Phony.normalize('370 8 5 1234567').assert == '370851234567'

#### Netherlands

Handles the Dutch number (without US cc) correctly.

    Phony.normalize('310 5552121').assert == '315552121'

#### Russia

    Phony.normalize('7 8 342 1234567').assert == '783421234567'

#### Unsupported Countries

    Phony.normalize('+881-321 5560 5220').assert == '88132155605220'
    
### Special Cases 

Normalizes a too short number.

    Phony.normalize('+972').assert == '972'

Normalizes an already normalized number.

    Phony.normalize('41443643533').assert == '41443643533'
    
Normalizes a formatted number.

    Phony.normalize('+41 44 364 35 33').assert == '41443643533'

Normalizes a 00 number.

    Phony.normalize('0041 44 364 35 33').assert == '41443643533'

Normalizes a service number.

    Phony.normalize('+41 800 11 22 33').assert == '41800112233'

Removes characters.

    Phony.normalize('John: +41 44 364 35 33').assert == '41443643533'
    
Normalizes a number with colons.

    Phony.normalize('1.906.387.1698').assert == '19063871698'

Normalizes an erroneous zero.

    Phony.normalize('+410443643533').assert == '41443643533'

Does not normalize a correct 0 away.

    Phony.normalize('+390909709511').assert == '390909709511'

Handles completely crazy 'numbers'.

    Phony.normalize('Hello, I am Cora, the 41th parrot of the United States, and 44 is my 364 times 35 funky number. 32.').assert == '41443643532'