nt54 0.0.1

data/.gitignore

@@ -0,0 +1,12 @@
+Gemfile
+Gemfile.lock
+doc
+docs
+pkg
+.DS_Store
+coverage
+.yardoc
+*.gem
+*.sqlite3
+*.rbc
+*.lock

data/README.md

@@ -0,0 +1,121 @@
+# NT54
+
+Parsing, validation, meta-information and formatting for Argentine phone
+numbers.
+
+## Usage
+
+    require "nt54"
+
+    # Parsing
+    number = NT54::Parser.parse("0291-15-555-4444")
+    number.area_code # => "291"
+    number.local_prefix # => "555"
+    number.local_number # => "4444"
+    number.country_code # => "54"
+    number.mobile? # => true
+
+    # Validation
+    number = NT54::Parser.parse("0291-15-555-4444")
+    number.valid? # => true
+    NT54::Parser.valid?("0291-15-555-4444") # => true
+    NT54::Parser.valid?("03864-22-4444") # => false (there's no 3864 area code)
+
+    # Meta-information
+    number.area.city # => "Bahía Blanca"
+    number.area.province.code # => "B"
+    number.area.province.name # => "Buenos Aires"
+    number.area.lat # => "-38.71167760000001"
+    number.area.lng # => "-62.26807789999999"
+
+    # Formatting
+    number.format_international # => "+54 9 (291) 555-4444"
+    number.format_international_sms # => "+54 (291) 555-4444"
+    number.format_national # => "(0291) 15 555-4444"
+    number.format_local # => "15 555-4444"
+
+    # Special number handling
+    number = NT54::Parser.parse("100")
+    number.special? # => true
+    number.special.comment # => "Bomberos"
+    number.special.comment_en # => "Fire department"
+
+## More info
+
+Simple phone number formats like the one used for North America can be somewhat
+easily described with regular expressions, but Argentina's phone numbers are
+quite complex. For example, area codes can be 2-4 numbers long and can overlap.
+A prefix is used to denote mobile verse non-mobile numbers, and this prefix
+changes number and position when dialing internationally. The prefix must be
+used when calling internationally, but not when sending SMS internationally.
+
+This means that Argentine phone numbers are best captured with a grammar, rather
+than regular expressions, so NT54 uses a finite state machine to process the
+number like a real hardware or software dialer.
+
+If you're curious, you can debug the phone number processing like this:
+
+    D, [2012-01-24T15:29:00.993893 #10077] DEBUG -- : new state: Dialtone
+    D, [2012-01-24T15:29:00.994076 #10077] DEBUG -- : got 0
+    D, [2012-01-24T15:29:00.994209 #10077] DEBUG -- : triggering area_code_indicated
+    D, [2012-01-24T15:29:00.994272 #10077] DEBUG -- : new state: WaitForAreaCode
+    D, [2012-01-24T15:29:00.994320 #10077] DEBUG -- : got 2
+    D, [2012-01-24T15:29:00.994352 #10077] DEBUG -- : got 9
+    D, [2012-01-24T15:29:00.994660 #10077] DEBUG -- : got 1
+    D, [2012-01-24T15:29:00.994738 #10077] DEBUG -- : triggering area_code_potentially_completed
+    D, [2012-01-24T15:29:00.994804 #10077] DEBUG -- : new state: WaitForAreaCodeCompletion
+    D, [2012-01-24T15:29:00.994871 #10077] DEBUG -- : got 1
+    D, [2012-01-24T15:29:00.994910 #10077] DEBUG -- : 291 is a valid area code
+    D, [2012-01-24T15:29:00.994951 #10077] DEBUG -- : triggering mobile_prefix_started
+    D, [2012-01-24T15:29:00.994999 #10077] DEBUG -- : new state: WaitForMobilePrefixCompletion
+    D, [2012-01-24T15:29:00.995040 #10077] DEBUG -- : got 5
+    D, [2012-01-24T15:29:00.995071 #10077] DEBUG -- : triggering mobile_prefix_completed
+    D, [2012-01-24T15:29:00.995120 #10077] DEBUG -- : new state: WaitForLocalPrefix
+    D, [2012-01-24T15:29:00.995150 #10077] DEBUG -- : got 4
+    D, [2012-01-24T15:29:00.995213 #10077] DEBUG -- : got 4
+    D, [2012-01-24T15:29:00.995247 #10077] DEBUG -- : got 4
+    D, [2012-01-24T15:29:00.995281 #10077] DEBUG -- : got 5
+    D, [2012-01-24T15:29:00.995329 #10077] DEBUG -- : triggering local_prefix_completed
+    D, [2012-01-24T15:29:00.995371 #10077] DEBUG -- : new state: WaitForLocalNumber
+    D, [2012-01-24T15:29:00.995413 #10077] DEBUG -- : got 5
+    D, [2012-01-24T15:29:00.995441 #10077] DEBUG -- : got 5
+    D, [2012-01-24T15:29:00.997847 #10077] DEBUG -- : got 5
+    #<NT54::PhoneNumber:0x007f8e91058120
+     @area_code="291",
+     @country_code="54",
+     @local_number="5555",
+     @local_prefix="444",
+     @mobile=true>
+
+## Installation
+
+    gem install nt54
+
+## Author
+
+[Norman Clarke](mailto:norman@njclarke.com)
+
+## Changelog
+
+* 2012-01-24 - Initial release
+
+## License
+
+Copyright (c) 2012 Norman Clarke
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,25 @@
+require "rubygems"
+require "rake/testtask"
+
+task :default => :test
+
+Rake::TestTask.new do |t|
+  t.libs       = ["lib"]
+  t.verbose    = false
+  t.test_files = FileList['test/*_test.rb']
+end
+
+task :clean do
+  %x{rm -rf *.gem doc pkg coverage}
+  %x{rm -f `find . -name '*.rbc'`}
+end
+
+task :gem do
+  %x{gem build nt54.gemspec}
+end
+
+task :yard => :guide do
+  puts %x{bundle exec yard}
+end
+
+task :doc => :yard

data/lib/nt54.rb

@@ -0,0 +1,16 @@
+require "logger"
+require "csv"
+require "pathname"
+require "pp"
+require "ambry"
+require "micromachine"
+require "nt54/phone_number"
+require "nt54/parser"
+require "nt54/province"
+require "nt54/area"
+require "nt54/special_number"
+
+module NT54
+  extend self
+  attr_accessor :log
+end

data/lib/nt54/area.rb

@@ -0,0 +1,15 @@
+module NT54
+  class Area
+    extend Ambry::Model
+    field :code, :city, :province_code, :comment, :lat, :lng
+
+    def province
+      Province.get(province_code)
+    end
+  end
+
+  CSV.foreach(Pathname(__FILE__).dirname.join("areas.csv"))  do |row|
+    Area.create Hash[[:code, :city, :province_code, :comment].zip(row)]
+  end
+
+end

data/lib/nt54/areas.csv

@@ -0,0 +1,307 @@
+11,Buenos Aires,C,,-34.6084175,-58.37316130000001
+220,Pontevedra,B,,-34.74426400000001,-58.7001579
+2202,González Catán,B,,-34.7627204,-58.6300804
+221,La Plata,B,,-34.9173012,-57.9501305
+2221,Atalaya,B,,-35.0268593,-57.53101729999999
+2223,Altamirano,B,,-35.36700800000001,-58.1614
+2224,Glew,B,,-34.8854021,-58.3812772
+2225,Alejandro Korn,B,,-34.9710848,-58.38823009999999
+2226,Alejandro Petión,B,,-34.6084175,-58.37316130000001
+2227,Antonio Carboni,B,,-35.2000008,-59.3333282
+2229,Juan María Gutiérrez,B,,-34.5871849,-58.3991699
+223,Mar del Plata,B,,-37.9798584,-57.5897942
+2241,Chascomús,B,,-35.5654907,-58.0160484
+2242,Pila,B,,-36.0017624,-58.1404037
+2243,General Belgrano,B,,-35.7671432,-58.4959946
+2244,Las Flores,B,,-33.75,-59.9333305
+2245,Dolores,B,,-36.3145485,-57.68008039999999
+2246,Santa Teresita,B,,-36.5437544,-56.702013
+2252,San Clemente del Tuyú,B,,-36.3695702,-56.7175713
+2254,Cariló,B,,-37.1615028,-56.8993073
+2255,Villa Gesell,B,,-37.2633972,-56.9732704
+2257,Mar de Ajó,B,,-36.7311783,-56.6819267
+2261,Lobería,B,,-38.1640892,-58.7817154
+2262,Necochea,B,,-38.5544968,-58.73960879999999
+2264,Claraz,B,,-37.8900948,-59.2902184
+2265,Coronel Vidal,B,,-37.4456291,-57.726944
+2266,Mechongué,B,,-38.15000149999999,-58.216671
+2267,General Madariaga,B,,-37.03333,-57.13333
+2268,General Guido,B,,-36.7210945,-57.9162555
+2271,Abbott,B,,-35.282589,-58.8043213
+2272,Las Marianas,B,,-35.06560899999999,-59.5156784
+2273,Carmen de Areco,B,,-34.3806686,-59.8223267
+2274,Carlos Spegazzini,B,,-34.6193051,-58.4263416
+2281,Azul,B,,-36.7749672,-59.8540382
+2283,Tapalqué,B,,-36.355545,-60.0236549
+2284,Olavarría,B,,-36.8920898,-60.3149414
+2285,Laprida,B,,-37.5454292,-60.7987099
+2286,La Colina,B,,-37.3615913,-61.5340996
+2291,Mar del Sur,B,,-38.34144209999999,-57.99058909999999
+2292,Benito Juárez,B,,-37.6734123,-59.8051033
+2293,Tandil,B,,-37.3178101,-59.1503906
+2296,Ayacucho,B,,-37.1502686,-58.4829712
+2297,Rauch,B,,-36.7749176,-59.0897865
+2302,General Pico,L,,-35.6569519,-63.75454709999999
+2314,Espigas,B,,-36.4169312,-60.6774902
+2316,Arboledas,B,,-36.8838501,-61.4822388
+2317,Carlos María Naón,B,,-35.246891,-60.8367882
+2320,Del Viso,B,,-34.4792247,-58.79967199999999
+2322,Fátima,B,,-34.4259919,-58.9965377
+2323,Luján,B,,-34.565731,-59.1174316
+2324,Mercedes,B,,-34.6546021,-59.4284134
+2325,Azcuénaga,B,,-34.3833313,-59.34999850000001
+2326,Duggan,B,,-34.2072449,-59.6355782
+2331,Realicó,L,,-35.0380173,-64.2465744
+2333,Quemú Quemú,L,,-36.0488892,-63.5504112
+2334,Eduardo Castex,L,,-35.9136543,-64.2888718
+2335,Ingeniero Luiggi,L,,-35.3858719,-64.4675903
+2336,Huinca Renancó,X,,-34.8402596,-64.37178039999999
+2337,Fortín Olavarría,B,,-35.7110596,-63.02032089999999
+2338,Victorica,L,,-36.2161713,-65.4323502
+2342,Bragado,B,,-35.1199112,-60.48142619999999
+2343,Elvira,B,,-35.2331505,-59.4827309
+2344,Álvarez de Toledo,B,,-35.6375122,-59.62751009999999
+2345,Mosconi,B,,-35.7412682,-60.56213
+2346,Chivilcoy,B,,-34.8972397,-60.018837
+2352,Chacabuco,B,,-34.63593290000001,-60.4651222
+2353,Arribeños,B,,-34.2097626,-61.3543663
+2354,El Dorado,B,,-34.6508789,-61.5838585
+2355,Lincoln,B,,-34.8678589,-61.53442
+2356,Coronel Granada,B,,-34.7897377,-62.20030209999999
+2357,Carlos Salas,B,,-35.3924484,-61.99036030000001
+2358,Zavalía,B,,-34.8937607,-61.00455859999999
+2362,Junín,B,,-34.5822105,-60.94940190000001
+237,Francisco Álvarez,B,,-34.6056091,-58.85812389999999
+2392,Berutti,B,,-35.8551674,-62.51066590000001
+2393,Salazar,B,,-36.3066902,-62.20112990000001
+2394,Quenumá,B,,-36.5679893,-63.08898929999999
+2395,Bellocq,B,,-35.9170494,-61.5426598
+2396,Chiclana,B,,-35.7327118,-61.7404366
+2473,Wheelwright,S,,-33.782959,-61.2158203
+2474,Gahan,B,,-34.3352432,-60.0972443
+2475,Carabelas,B,,-34.0364685,-60.8659592
+2477,Pergamino,B,,-33.8881416,-60.5693359
+2478,Arrecifes,B,,-34.0638771,-60.10348889999999
+261,Mendoza,M,,-32.890183,-68.8440498
+2622,Colonia Las Rosas,M,,-33.5999985,-69.0999985
+2623,San Martín,M,,-33.0799789,-68.4694595
+2624,Cacheuta,M,,-33.0386314,-69.1012573
+2625,Bowen,M,,-34.999691,-67.5164795
+2626,Arroyito,M,,-32.8333282,-67.3000107
+2627,San Rafael,M,,-34.6131516,-68.341011
+264,San Juan,J,,-31.5272732,-68.5214081
+2646,Astica,J,,-30.9320107,-67.3846512
+2647,Colangüil,J,,-30.0343609,-69.2403793
+2648,Calingasta,J,,-31.3184566,-69.42536160000002
+2651,San Francisco del Monte de Oro,D,,-32.5991783,-66.1322021
+2655,La Toma,D,,-33.0548161,-65.61749429999999
+2656,Merlo,D,,-32.3492393,-65.0335693
+2657,Justo Daract,D,,-33.8653603,-65.18463129999999
+2658,Buena Esperanza,D,,-34.756794,-65.2529907
+266,San Luis,D,,-33.2995605,-66.3491821
+280,Trelew,U,,-43.2491302,-65.3074036
+2901,Ushuaia,V,,-54.79167940000001,-68.229248
+2902,El Calafate,Z,,-50.3402138,-72.27050779999999
+2903,Pastos Blancos,U,,-45.3,-70.5
+291,Bahía Blanca,B,,-38.71167760000001,-62.26807789999999
+2920,Viedma,R,,-40.8119087,-62.9962044
+2921,Coronel Dorrego,B,,-38.7194366,-61.28545759999999
+2922,Coronel Pringles,B,,-37.9854202,-61.3540382
+2923,Arroyo Corto,B,,-37.5128212,-62.3171997
+2924,Santa Teresa,L,,-37.5666667,-63.41666670000001
+2925,Felipe Solá,B,,-38.0075912,-62.81608199999999
+2926,Coronel Suárez,B,,-37.4559517,-61.93072509999999
+2927,Algarrobo,B,,-38.8949089,-63.1354523
+2928,Hilario Ascasubi,B,,-39.3760529,-62.64558030000001
+2929,Casbas,B,,-36.7571449,-62.5028076
+2931,General Conesa,R,,-40.1037178,-64.45793909999999
+2932,Punta Alta,B,,-38.8760605,-62.07408909999999
+2933,Huanguelen Sur,B,,-34.6084175,-58.37316130000001
+2934,San Antonio Oeste,R,,-40.7428017,-64.9676514
+2935,Rivera,B,,-37.1594315,-63.24351119999999
+2936,Carhué,B,,-37.1780663,-62.75482179999999
+2940,Ingeniero Jacobacci,R,,-41.3285255,-69.5493011
+2942,Zapala,Q,,-38.9023615,-70.06534049999999
+2944,San Carlos de Bariloche,R,,-41.1492882,-71.3012695
+2945,Esquel,U,,-42.9067192,-71.3081055
+2946,Choele Choel,R,,-39.2879906,-65.66539759999999
+2948,Chos Malal,Q,,-37.3793945,-70.2700043
+2952,General Acha,L,,-37.3761444,-64.6000443
+2953,Macachín,L,,-37.1502686,-63.64928819999999
+2954,Santa Rosa,L,,-36.6226883,-64.2859268
+2962,San Julián,Z,,-49.305111,-67.70797
+2963,Los Antiguos,Z,,-46.5486283,-71.6319773
+2964,Río Grande,V,,-53.79180909999999,-67.7197266
+2966,Río Gallegos,Z,,-51.6329918,-69.2276001
+297,Comodoro Rivadavia,U,,-45.8679199,-67.5
+2972,San Martín de los Andes,Q,,-40.1550903,-71.3541946
+298,General Roca,R,,-39.0267525,-67.5751724
+2982,Orense,B,,-38.6870613,-59.773838
+2983,Tres Arroyos,B,,-38.3763123,-60.2781296
+299,Neuquén,Q,,-38.9492798,-68.0658112
+3327,Benavídez,B,,-34.4151715,-58.6867547
+3329,Alsina,B,,-33.9080009,-59.3892059
+3382,Rufino,S,,-34.266468,-62.7097206
+3385,Laboulaye,X,,-34.127224,-63.3895645
+3387,Italó,X,,-34.783329,-63.7666702
+3388,Banderaló,B,,-35.0161705,-63.37463
+3400,Villa Constitución,S,,-33.2336388,-60.3341713
+3401,El Trébol,S,,-32.1980158,-61.70194999999999
+3402,Arroyo Seco,S,,-33.161659,-60.51317999999999
+3404,Gálvez,S,,-32.03339,-61.2158203
+3405,San Javier,S,,-30.5831909,-59.9496384
+3406,San Jorge,S,,-31.8962113,-61.85977699999999
+3407,El Paraíso,B,,-33.5769615,-59.98809809999999
+3408,San Cristóbal,S,,-30.3069038,-61.2378159
+3409,Colonia Bossi,S,,-30.6688976,-61.78675080000001
+341,Rosario,S,,-32.9507408,-60.66650010000001
+342,Coronda,S,,-31.9728813,-60.9193039
+343,Paraná,E,,-31.7413197,-60.51154709999999
+3435,Lucas González,E,,-32.3856506,-59.5289459
+3436,Victoria,E,,-32.6220245,-60.1570702
+3437,La Paz,E,,-30.7589703,-59.63927839999999
+3438,Bovril,E,,-31.3434707,-59.4465431
+3442,Concepción del Uruguay,E,,-32.4838219,-58.23302839999999
+3444,Gualeguay,E,,-33.1512413,-59.3344116
+3445,Rosario del Tala,E,,-32.3026733,-59.14167789999999
+3446,Gualeguaychú,E,,-33.0150185,-58.5192451
+3447,Villa Elisa,E,,-32.1641185,-58.40059899999999
+345,Concordia,E,,-31.3918479,-58.0170605
+3454,Federal,E,,-30.9512291,-58.7988281
+3455,Villaguay,E,,-31.849369,-59.01580809999999
+3456,Chajarí,E,,-30.7572746,-57.99161909999999
+3458,San José de Feliciano,E,,-30.3826904,-58.7493896
+3460,Sargento Cabral,S,,-33.4308929,-60.6272621
+3461,Campos Salles,B,,-33.4036369,-60.23913570000001
+3462,Venado Tuerto,S,,-33.75,-61.96564100000001
+3463,Canals,X,,-33.5619736,-62.8815918
+3464,Casilda,S,,-33.0496216,-61.1663818
+3465,Firmat,S,,-33.4555244,-61.48825069999999
+3466,Arocena,S,,-32.0777283,-60.9751549
+3467,Cruz Alta,X,,-33.008709,-61.8109207
+3468,Corral de Bustos,X,,-33.2835312,-62.1854591
+3469,Acebal,S,,-33.2412796,-60.83404160000001
+3471,Cañada de Gómez,S,,-32.8161583,-61.3998413
+3472,Marcos Juárez,X,,-32.6936073,-62.10267640000001
+3476,Totoras,S,,-32.5857964,-61.1678085
+3482,Reconquista,S,,-29.1448193,-59.64352419999999
+3483,Vera,S,,-29.4653301,-60.2160606
+3487,Zárate,B,,-34.0988083,-59.0322914
+3488,Dique Luján,B,,-34.3717288,-58.6880906
+3489,Campana,B,,-34.1674805,-58.95264049999999
+3491,Tostado,S,,-29.2327906,-61.77137080000001
+3492,Rafaela,S,,-31.2525979,-61.49164219999999
+3493,Sunchales,S,,-30.9429569,-61.5598907
+3496,Esperanza,S,,-31.4489859,-60.93036629999999
+3497,Cayastacito,S,,-31.1000004,-60.5666618
+3498,San Justo,S,,-30.7894382,-60.59102249999999
+351,Córdoba,X,,-31.3989296,-64.1821289
+3521,Deán Funes,X,,-30.42249679999999,-64.3527756
+3522,San Francisco del Chañar,X,,-29.7839394,-63.9321899
+3524,Villa del Totoral,X,,-30.816667,-63.71666699999999
+3525,Jesús María,X,,-30.97630969999999,-64.09581279999999
+353,Villa María,X,,-32.4104614,-63.24364499999999
+3532,Oliva,X,,-32.0412292,-63.5676689
+3533,Las Varillas,X,,-31.87050079999999,-62.7197901
+3534,Bell Ville,X,,-32.6201134,-62.68926239999999
+3541,Villa Carlos Paz,X,,-31.4209385,-64.5001297
+3542,Salsacate,X,,-31.3179455,-65.0883789
+3543,La Calera,X,,-31.396629,-64.45997600000001
+3544,Villa Dolores,X,,-31.944437,-65.19210819999999
+3546,Santa Rosa de Calamuchita,X,,-32.0677338,-64.5497437
+3547,Alta Gracia,X,,-31.65455249999999,-64.43060299999999
+3548,La Falda,X,,-31.0875359,-64.4837265
+3549,Cruz del Eje,X,,-30.7211227,-64.8098984
+3562,Morteros,X,,-30.7099133,-62.00429149999999
+3563,Balnearia,X,,-31.0128017,-62.66572489999999
+3564,San Francisco,X,,-31.42499919999999,-62.0841599
+3571,Río Tercero,X,,-32.1753998,-64.1122055
+3572,Río Segundo,X,,-31.65180209999999,-63.9123955
+3573,Calchín,X,,-31.668045,-63.19916920000001
+3574,Santa Rosa de Río Primero,X,,-31.1512527,-63.4034538
+3575,La Para,X,,-30.8919945,-62.99832149999999
+3576,Arroyito,X,,-31.4154091,-63.0505409
+358,Río Cuarto,X,,-33.132019,-64.3496704
+3582,Coronel Moldes,X,,-33.6346397,-64.59960939999999
+3583,Vicuña Mackenna,X,,-33.9179611,-64.3894806
+3584,La Carlota,X,,-33.4203339,-63.2935677
+3585,Adelia María,X,,-33.6373901,-64.0310669
+3711,Ingeniero Guillermo N. Juárez,P,,-23.8945923,-61.85535050000001
+3715,Las Lomitas,P,,-24.7045002,-60.6005783
+3716,Ibarreta,P,,-25.2150536,-59.8573494
+3717,Formosa,P,,-26.185201,-58.1753697
+3718,Clorinda,P,,-25.2881832,-57.7228203
+3721,Charadai,H,,-27.6559811,-59.8599968
+3722,Resistencia,H,,-27.451656,-58.98625199999999
+3725,General José de San Martín,H,,-26.53898,-59.34269
+3731,Charata,H,,-27.2179902,-61.18736169999999
+3732,Presidencia Roque Sáenz Peña,H,,-26.7906895,-60.4402504
+3734,Machagai,H,,-26.9329796,-60.0512695
+3735,Villa Ángela,H,,-27.5758266,-60.7136879
+3741,Bernardo de Irigoyen,N,,-26.25,-53.65000149999999
+3743,Jardín América,N,,-27.0431973,-55.2270686
+3751,San Pedro,N,,-26.6308594,-54.1131592
+3754,Dos Arroyos,N,,-27.700201,-55.24606319999999
+3755,Oberá,N,,-27.4815311,-55.1234932
+3756,Santo Tomé,W,,-28.5516205,-56.0456352
+3757,Puerto Iguazú,N,,-25.5971635,-54.578599
+3758,Concepción de la Sierra,N,,-27.9806169,-55.52174849999999
+376,Posadas,N,,-27.3621374,-55.90087459999999
+3772,Paso de los Libres,W,,-29.7137101,-57.0855601
+3773,Mercedes,W,,-29.1826935,-58.0789719
+3774,Curuzú Cuatiá,W,,-29.7915416,-58.0499307
+3775,Monte Caseros,W,,-30.2494283,-57.62968739999999
+3777,Goya,W,,-29.1442242,-59.2643242
+3781,San Miguel,W,,-27.9932613,-57.588829
+3782,San Lorenzo,W,,-28.1302185,-58.766201
+3783,Corrientes,W,,-27.4712257,-58.83958440000001
+3786,Ituzaingó,W,,-27.5899088,-56.68927009999999
+381,San Miguel de Tucumán,T,,-26.8082848,-65.2175903
+3821,Chepes,F,,-31.3363895,-66.5918427
+3822,La Rioja,F,,-29.4128001,-66.8559803
+3825,Chilecito,F,,-29.1659603,-67.5
+3826,Chamical,F,,-30.36156459999999,-66.31504819999999
+3827,Aimogasta,F,,-28.5549145,-66.81731409999999
+3832,Recreo,K,,-29.2792282,-65.06365199999999
+3833,Huillapima,K,,-28.7320004,-65.9838867
+3835,Andalgalá,K,,-27.6004009,-66.3162308
+3837,Tinogasta,K,,-28.0673199,-67.565918
+3838,El Cajón,K,,-26.4333305,-66.2666702
+3841,Pampa de los Guanacos,G,,-26.2302074,-61.8373413
+3843,Quimilí,G,,-27.6441841,-62.41556549999999
+3844,Añatuya,G,,-28.46558,-62.83356089999999
+3845,Villa Atamisqui,G,,-28.4820595,-63.8003502
+3846,Campo Gallo,G,,-26.5841694,-62.85004039999999
+385,Santiago del Estero,G,,-27.78442,-64.26728059999999
+3854,Ancaján,G,,-28.4333305,-64.933342
+3855,Suncho Corral,G,,-27.9333344,-63.4300537
+3856,Sumampa,G,,-29.3664608,-63.4680214
+3857,Los Juríes,G,,-28.465704,-62.1094246
+3858,Termas de Río Hondo,G,,-27.4942493,-64.8577881
+3861,Bobadal,G,,-26.7166691,-64.3833313
+3862,Trancas,T,,-26.2161293,-65.2835083
+3863,Famaillá,T,,-27.0560551,-65.40216830000001
+3865,Aguilares,T,,-27.4328594,-65.61586
+3867,Tafí del Valle,T,,-26.8458195,-65.700119
+3868,Cafayate,A,,-26.0703259,-65.9787521
+3869,Palá Palá,T,,-27.0666695,-65.2166672
+387,Salta,A,,-24.7829323,-65.4121552
+3873,Tartagal,A,,-22.5203762,-63.79910659999999
+3876,El Galpón,A,,-25.3839092,-64.6325684
+3877,Joaquín V. González,A,,-25.1135731,-64.1268692
+3878,Embarcación,A,,-23.2110825,-64.0974197
+388,San Salvador de Jujuy,Y,,-24.1857864,-65.2994767
+3885,La Quiaca,Y,,-22.1044031,-65.5967709
+3886,Libertador General San Martín,Y,,-23.81945,-64.790077
+3887,Humahuaca,Y,,-23.203963,-65.34860929999999
+3888,San Pedro,Y,,-24.2316571,-64.8678707
+3891,Graneros,T,,-27.6498394,-65.4400711
+3892,Amaichá del Valle,T,,-26.5863342,-65.9180298
+3894,Burruyacú,T,,-26.5937716,-64.811084
+600,,,premium rate,,
+605,,,premium rate for charity donation,,
+609,,,fixed-rate gaming,,
+610,,,dial-up internet access,,
+800,,,toll free,,
+810,,,local rate,,
+822,,,toll free calling card,,

data/lib/nt54/parser.rb

@@ -0,0 +1,91 @@
+require "nt54/parser/machinery"
+require "nt54/parser/visitor"
+
+module NT54
+
+  class Parser
+    include Machinery
+
+    attr_reader :number
+
+    trigger :country_code_indicated
+    transition :Dialtone, :WaitForCountryCodeStart
+
+    trigger :mobile_prefix_or_area_code_started
+    transition :Dialtone, :WaitForAreaCodeOrMobilePrefixCompletion
+
+    trigger :country_code_started
+    transition :WaitForCountryCodeStart, :WaitForCountryCodeEnd
+
+    trigger :area_code_indicated
+    transition :Dialtone, :WaitForAreaCode
+
+    trigger :country_code_completed
+    transition :WaitForCountryCodeEnd, :WaitForMobilePrefixOrAreaCode
+
+    trigger :mobile_prefix_or_area_code_indicated
+    transition :WaitForMobilePrefixOrAreaCode, :WaitForAreaCodeOrMobilePrefixCompletion
+
+    trigger :mobile_prefix_started
+    transition :WaitForPrefix, :WaitForMobilePrefixCompletion
+    transition :WaitForMobilePrefixOrAreaCode, :WaitForAreaCode
+    transition :WaitForAreaCodeCompletion, :WaitForMobilePrefixCompletion
+    transition :Dialtone, :WaitForMobilePrefixCompletion
+
+    trigger :area_code_completed
+    transition :WaitForAreaCodeOrMobilePrefixCompletion, :WaitForLocalPrefix
+    transition :WaitForAreaCodeCompletion, :WaitForPrefix
+    transition :WaitForAreaCode, :WaitForPrefix
+
+    trigger :area_code_potentially_completed
+    transition :WaitForAreaCode, :WaitForAreaCodeCompletion
+
+    trigger :mobile_prefix_completed
+    transition :WaitForAreaCodeOrMobilePrefixCompletion, :WaitForLocalPrefix
+    transition :WaitForMobilePrefixCompletion, :WaitForLocalPrefix
+
+    trigger :local_prefix_started
+    transition :Dialtone, :WaitForLocalPrefix
+    transition :WaitForPrefix, :WaitForLocalPrefix
+
+    trigger :area_code_started
+    transition :WaitForMobilePrefixOrAreaCode, :WaitForAreaCode
+    transition :WaitForPrefix, :WaitForAreaCode
+
+    trigger :local_prefix_completed
+    transition :WaitForLocalPrefix, :WaitForLocalNumber
+
+    trigger :special_number_started
+    transition :Dialtone, :WaitForSpecialNumberCompletion
+    transition :WaitForAreaCodeOrMobilePrefixCompletion, :WaitForSpecialNumberCompletion
+
+    def self.parse(sequence)
+      parser = new
+      sequence = sequence.to_s.gsub(/[^0-9+]/, '')
+      sequence.split("").map {|x| parser.dial(x)}
+      parser.number.fix!
+    end
+
+    def self.debug(sequence)
+      NT54.log       = Logger.new(STDOUT)
+      NT54.log.level = Logger::DEBUG
+      pp parse(sequence)
+    end
+
+    def self.valid?(sequence)
+      number = parse(sequence)
+      number.valid?
+    rescue RuntimeError
+      false
+    end
+
+    def initialize
+      @number  = PhoneNumber.new
+      @visitor = Parser::Visitors::Dialtone.new(@number)
+    end
+
+    def dial(keypress)
+      respond_to @visitor.accept(keypress)
+    end
+  end
+end

data/lib/nt54/parser/machinery.rb

@@ -0,0 +1,52 @@
+module NT54
+  class Parser
+
+    module Machinery
+      private
+
+      def self.included(base)
+        base.extend ClassMethods
+      end
+
+      def machine
+        @machine or begin
+          @machine = MicroMachine.new(:Dialtone).tap do |m|
+            m.instance_variable_set :@transitions_for, self.class.transitions
+          end
+        end
+      end
+
+      def respond_to(event)
+        return if event.nil?
+        next_visitor = machine.transitions_for[event][machine.state]
+        send event
+        @visitor = Visitors.const_get(next_visitor).new(@number)
+      end
+
+      module ClassMethods
+        def trigger(name, &block)
+          triggers << name
+          transitions[name] = {}
+          class_eval(<<-END, __FILE__, __LINE__ + 1)
+            def #{name}
+              NT54.log.debug "triggering #{name}" if NT54.log
+              machine.trigger :#{name}
+            end
+          END
+        end
+
+        def transition(from, to)
+          transitions[triggers.last][from] = to
+        end
+
+        def transitions
+          @transitions ||= {}
+        end
+
+        def triggers
+          @triggers ||= []
+        end
+      end
+    end
+  end
+end

data/lib/nt54/parser/visitor.rb

@@ -0,0 +1,35 @@
+module NT54
+  class Parser
+    class Visitor
+
+      attr :number
+
+      def initialize(number)
+        NT54.log.debug "new state: #{to_sym}" if NT54.log
+        @number = number
+      end
+
+      def accept(keypress)
+        NT54.log.debug "got #{keypress}" if NT54.log
+        return nil
+      end
+
+      def to_sym
+        self.class.to_s.split("::").last.to_sym
+      end
+    end
+  end
+end
+
+require "nt54/parser/visitors/dialtone"
+require "nt54/parser/visitors/wait_for_area_code"
+require "nt54/parser/visitors/wait_for_area_code_completion"
+require "nt54/parser/visitors/wait_for_area_code_or_mobile_prefix_completion"
+require "nt54/parser/visitors/wait_for_country_code_end"
+require "nt54/parser/visitors/wait_for_country_code_start"
+require "nt54/parser/visitors/wait_for_local_number"
+require "nt54/parser/visitors/wait_for_local_prefix"
+require "nt54/parser/visitors/wait_for_mobile_prefix_completion"
+require "nt54/parser/visitors/wait_for_mobile_prefix_or_area_code"
+require "nt54/parser/visitors/wait_for_prefix"
+require "nt54/parser/visitors/wait_for_special_number_completion"

data/lib/nt54/parser/visitors/dialtone.rb

@@ -0,0 +1,26 @@
+module NT54
+  class Parser
+    module Visitors
+      class Dialtone < Visitor
+        def accept(keypress)
+          super
+          case keypress
+          when "+"
+            :country_code_indicated
+          when "1"
+            :mobile_prefix_or_area_code_started
+          when "0"
+            :area_code_indicated
+          when ("4".."8")
+            @number.local_prefix << keypress
+            :local_prefix_started
+          when("9")
+            @number.special_sequence << keypress
+            :special_number_started
+          else raise "Don't know how to handle #{keypress}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/nt54/parser/visitors/wait_for_area_code.rb

@@ -0,0 +1,17 @@
+module NT54
+  class Parser
+    module Visitors
+      class WaitForAreaCode < Visitor
+        def accept(keypress)
+          super
+          @number.area_code << keypress
+          if @number.area_code.length == 2 && @number.area
+            :area_code_completed
+          elsif @number.area_code.length > 2
+            :area_code_potentially_completed
+          end
+        end
+      end
+    end
+  end
+end

data/lib/nt54/parser/visitors/wait_for_area_code_completion.rb

@@ -0,0 +1,32 @@
+module NT54
+  class Parser
+    module Visitors
+      class WaitForAreaCodeCompletion < Visitor
+        def accept(keypress)
+          super
+          # Some area codes overlap, (e.g., 387 and 3873), so we need to check
+          # for a 4-digit area code even if we already have a valid 3-digit one.
+          candidate = @number.area_code + keypress
+          if Area.key? candidate
+            NT54.log.debug "#{candidate} is a valid area code" if NT54.log
+            @number.area_code = candidate
+            :area_code_completed
+          elsif Area.key? @number.area_code
+            NT54.log.debug "#{@number.area_code} is a valid area code" if NT54.log
+            if keypress == "1"
+              @number.mobile = true
+              :mobile_prefix_started
+            else
+              @number.local_prefix << keypress
+              :area_code_completed
+            end
+          else
+            NT54.log.warn("Continuing with invalid or unknown area code") if NT54.log
+            @number.local_prefix << keypress
+            :area_code_completed
+          end
+        end
+      end
+    end
+  end
+end

data/lib/nt54/parser/visitors/wait_for_area_code_or_mobile_prefix_completion.rb

@@ -0,0 +1,23 @@
+module NT54
+  class Parser
+    module Visitors
+      class WaitForAreaCodeOrMobilePrefixCompletion < Visitor
+        def accept(keypress)
+          super
+          if keypress == "1"
+            @number.area_code = "11"
+            :area_code_completed
+          elsif keypress == "5"
+            @number.mobile = true
+            :mobile_prefix_completed
+          elsif keypress == "0" || keypress == "2"
+            @number.special_sequence = "1#{keypress}"
+            :special_number_started
+          else raise "Invalid number #{keypress}"
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/nt54/parser/visitors/wait_for_country_code_end.rb

@@ -0,0 +1,14 @@
+module NT54
+  class Parser
+    module Visitors
+      class WaitForCountryCodeEnd < Visitor
+        def accept(keypress)
+          super
+          raise "Expected 4, got #{keypress}" unless keypress.to_s == "4"
+          @number.country_code << keypress
+          :country_code_completed
+        end
+      end
+    end
+  end
+end

data/lib/nt54/parser/visitors/wait_for_country_code_start.rb

@@ -0,0 +1,14 @@
+module NT54
+  class Parser
+    module Visitors
+      class WaitForCountryCodeStart < Visitor
+        def accept(keypress)
+          super
+          raise "Expected 5, got #{keypress}" unless keypress.to_s == "5"
+          @number.country_code << keypress
+          :country_code_started
+        end
+      end
+    end
+  end
+end

data/lib/nt54/parser/visitors/wait_for_local_number.rb

@@ -0,0 +1,12 @@
+module NT54
+  class Parser
+    module Visitors
+      class WaitForLocalNumber < Visitor
+        def accept(keypress)
+          @number.local_number << keypress
+          super
+        end
+      end
+    end
+  end
+end

data/lib/nt54/parser/visitors/wait_for_local_prefix.rb

@@ -0,0 +1,19 @@
+module NT54
+  class Parser
+    module Visitors
+      class WaitForLocalPrefix < Visitor
+        def accept(keypress)
+          super
+          combo = [@number.area_code.length, @number.local_prefix.length]
+          if combo == [2,4] || combo == [3,3] || combo == [4,2] || combo == [0, 4]
+            @number.local_number << keypress
+            return :local_prefix_completed
+          else
+            @number.local_prefix << keypress
+            nil
+          end
+        end
+      end
+    end
+  end
+end

data/lib/nt54/parser/visitors/wait_for_mobile_prefix_completion.rb

@@ -0,0 +1,13 @@
+module NT54
+  class Parser
+    module Visitors
+      class WaitForMobilePrefixCompletion < Visitor
+        def accept(keypress)
+          super
+          raise "Expected 5, got #{keypress}" unless keypress.to_s == "5"
+          :mobile_prefix_completed
+        end
+      end
+    end
+  end
+end

data/lib/nt54/parser/visitors/wait_for_mobile_prefix_or_area_code.rb

@@ -0,0 +1,21 @@
+module NT54
+  class Parser
+    module Visitors
+      class WaitForMobilePrefixOrAreaCode < Visitor
+        def accept(keypress)
+          super
+          case keypress.to_s
+          when "1"
+            :mobile_prefix_or_area_code_indicated
+          when "9"
+            @number.mobile = true
+            :mobile_prefix_started
+          else
+            @number.area_code << keypress
+            :area_code_started
+          end
+        end
+      end
+    end
+  end
+end

data/lib/nt54/parser/visitors/wait_for_prefix.rb

@@ -0,0 +1,18 @@
+module NT54
+  class Parser
+    module Visitors
+      class WaitForPrefix < Visitor
+        def accept(keypress)
+          super
+          if keypress == "1"
+            @number.mobile = true
+            :mobile_prefix_started
+          else
+            @number.local_prefix << keypress
+            :local_prefix_started
+          end
+        end
+      end
+    end
+  end
+end

data/lib/nt54/parser/visitors/wait_for_special_number_completion.rb

@@ -0,0 +1,12 @@
+module NT54
+  class Parser
+    module Visitors
+      class WaitForSpecialNumberCompletion < Visitor
+        def accept(keypress)
+          @number.special_sequence << keypress
+          super
+        end
+      end
+    end
+  end
+end

data/lib/nt54/phone_number.rb

@@ -0,0 +1,83 @@
+module NT54
+  class PhoneNumber
+
+    attr_accessor :country_code, :area_code, :local_prefix, :local_number,
+      :city, :province_code, :mobile, :special_sequence, :special
+
+    def initialize
+      [:country_code, :area_code, :local_prefix, :local_number, :special_sequence].each do |var|
+        instance_variable_set :"@#{var}", ""
+      end
+    end
+
+    def area
+      @area ||= Area.get(area_code)
+    rescue Ambry::NotFoundError
+    end
+
+    def mobile?
+      !! mobile
+    end
+
+    def special
+      @special ||= SpecialNumber.get(special_sequence)
+    rescue Ambry::NotFoundError
+    end
+
+    def special?
+      !! special
+    end
+
+    def format_international
+      "+#{country_code} #{mobile? ? 9 : ''} (#{area_code}) #{local_prefix}-#{local_number}".squeeze(' ')
+    end
+
+    def format_international_sms
+      "+#{country_code} (#{area_code}) #{local_prefix}-#{local_number}"
+    end
+
+    def format_national
+      "(0#{area_code}) #{mobile? ? 15 : ''} #{local_prefix}-#{local_number}".squeeze(' ')
+    end
+
+    def format_local
+      "#{mobile? ? 15 : ''} #{local_prefix}-#{local_number}".squeeze(' ')
+    end
+
+    def real_length
+      area_code.length + local_prefix.length + local_number.length + special_sequence.length
+    end
+
+    def valid?
+      if special? && real_length == 3
+        return true
+      end
+      return false unless area_code
+      return false unless area
+      return false unless local_prefix.length >= 2
+      return false unless local_number.length >= 3
+      return false unless real_length == 10
+      true
+    end
+
+    def fix!
+      if real_length == 3 && special_sequence == ""
+        @special_sequence = "#{area_code}#{local_prefix}"
+        @area_code = ""
+        @local_prefix = ""
+        return self
+      end
+
+      @country_code = "54" if @country_code == ""
+      # If we didn't dial an area code, then we don't really know how long the
+      # prefix/local numbers are, so fake it.
+      unless area_code
+        until @local_number.length >= @local_prefix.length
+          @local_number.insert(0, @local_prefix.slice!(-1))
+        end
+      end
+      self
+    end
+
+  end
+end

data/lib/nt54/province.rb

@@ -0,0 +1,14 @@
+module NT54
+  class Province
+    extend Ambry::Model
+    field :code, :name
+
+    def areas
+      Area.find {|x| x.province_code == code}
+    end
+  end
+
+  CSV.foreach(Pathname(__FILE__).dirname.join("provinces.csv"))  do |row|
+    Province.create Hash[[:code, :name].zip(row)]
+  end
+end

data/lib/nt54/provinces.csv

@@ -0,0 +1,25 @@
+code,name
+C,Capital Federal
+B,Buenos Aires
+K,Catamarca
+X,Córdoba
+W,Corrientes
+H,Chaco
+U,Chubut
+E,Entre Ríos
+P,Formosa
+Y,Jujuy
+L,La Pampa
+F,La Rioja
+M,Mendoza
+N,Misiones
+Q,Neuquén
+R,Rio Negro
+A,Salta
+J,San Juan
+D,San Luis
+Z,Santa Cruz
+S,Santa Fe
+G,Santiago del Estero
+V,Tierra del Fuego
+T,Tucumán

data/lib/nt54/special_number.rb

@@ -0,0 +1,10 @@
+module NT54
+  class SpecialNumber
+    extend Ambry::Model
+    field :sequence, :comment, :comment_en
+  end
+
+  CSV.foreach(Pathname(__FILE__).dirname.join("special_numbers.csv"))  do |row|
+    SpecialNumber.create Hash[[:sequence, :comment, :comment_en].zip(row)]
+  end
+end

data/lib/nt54/special_numbers.csv

@@ -0,0 +1,14 @@
+100,Bomberos,Fire department
+101,Policía,Police
+102,Teléfono del niño,Child services
+103,Defensa civil,Civil defense
+106,Prefectura Naval,Coast Guard
+107,Servicio público de emergencias médicas,Ambulance
+110, Información de guía telefónica,Phone directory
+112,Atención comercial al cliente de la compañía telefónica,Customer service
+113,Hora oficial,Official time
+114,Servicio de reparación de la línea telefónica,Phone repair service
+115,Prueba de línea,Ring test
+121,Información del consumo de la línea,Phone usage info
+125,Asistencia para hipoacúsicos,Assistance service for the hearing-impaired
+911,Emergencias,Emergency

data/lib/nt54/version.rb

@@ -0,0 +1,3 @@
+module NT54
+  VERSION = "0.0.1"
+end

data/nt54.gemspec

@@ -0,0 +1,18 @@
+require File.expand_path("../lib/nt54/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name          = "nt54"
+  s.version       = NT54::VERSION
+  s.authors       = ["Norman Clarke"]
+  s.email         = ["norman@njclarke.com"]
+  s.homepage      = "http://github.com/norman/nt54"
+  s.summary       = "A library for working with Argentine phone numbers"
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test}/*`.split("\n")
+  s.require_paths = ["lib"]
+  s.description   = "Provides Argentine phone number parsing, validation, formatting and meta-information."
+
+  s.add_dependency "ambry"
+  s.add_dependency "micromachine"
+  s.add_development_dependency "minitest"
+end

data/test/helper.rb

@@ -0,0 +1,5 @@
+require "rubygems"
+require "nt54"
+require "minitest/unit"
+
+MiniTest::Unit.autorun

data/test/parser_test.rb

@@ -0,0 +1,57 @@
+require File.expand_path("../helper", __FILE__)
+
+module NT54
+  class ParserTest < MiniTest::Unit::TestCase
+
+    parsing_tests = {
+      "+54-11-4781-8888"    => ["11", "4781", "8888", false, true],
+      "0-11-4781-8888"      => ["11", "4781", "8888", false, true],
+      "11-4781-8888"        => ["11", "4781", "8888", false, true],
+      "15-6445-3333"        => ["", "6445", "3333", true, false],
+      "0342-15-631-2222"    => ["342", "631", "2222", true, true],
+      "0291-453-8888"       => ["291", "453", "8888", false, true],
+      "+54-291-453-8888"    => ["291", "453", "8888", false, true],
+      "0291-15-453-8888"    => ["291", "453", "8888", true, true],
+      "+54-9-291-453-8888"  => ["291", "453", "8888", true, true],
+      "0-11-15-4430-3333"   => ["11", "4430", "3333", true, true],
+      "0810-444-4444"       => ["810", "444", "4444", false, true],
+      "0 (221) 15 123-4567" => ["221", "123", "4567", true, true],
+      "0 (3722) 15 12-3456" => ["3722", "12", "3456", true, true],
+      "0387-431-9999"       => ["387", "431", "9999", false, true],
+      "03868-42-6666"       => ["3868", "42", "6666", false, true],
+      "0387-154-106666"     => ["387", "410", "6666", true, true],
+      "03873-424444"        => ["3873", "42", "4444", false, true],
+      "03488-218888"        => ["3488", "21", "8888", false, true],
+      "03488-15-218888"     => ["3488", "21", "8888", true, true],
+      "02965-422222"        => ["296", "542", "2222", false, false],
+      "+54 15-5310-7777"    => ["", "5310", "7777", true, false]
+    }
+
+    parsing_tests.each do |given, expected|
+      class_eval(<<-END, __FILE__, __LINE__+1)
+        def test_#{given.gsub(/[^0-9]/, "")}
+          number = Parser.parse("#{given}")
+          assert_equal "#{expected[0]}", number.area_code,    "Bad area code"
+          assert_equal "#{expected[1]}", number.local_prefix, "Bad local prefix"
+          assert_equal "#{expected[2]}", number.local_number, "Bad local number"
+          assert_equal  #{expected[3]},  number.mobile?,      "Bad mobile detection"
+          assert_equal  #{expected[4]},  number.valid?,       "Bad validity check"
+        end
+      END
+    end
+
+    def test_non_argentine_numbers_should_be_invalid
+      assert !Parser.valid?("+1-206-444-5555")
+    end
+
+    def test_incomplete_numbers_should_be_invalid
+      assert !Parser.valid?("+54")
+    end
+
+    def test_numbers_with_unknown_area_codes_should_be_invalid
+      assert  Parser.valid?("03861-22-4444")
+      # There's no "3864" area code
+      assert !Parser.valid?("03864-22-4444")
+    end
+  end
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: nt54
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Norman Clarke
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-01-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ambry
+  requirement: &70264475542380 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70264475542380
+- !ruby/object:Gem::Dependency
+  name: micromachine
+  requirement: &70264475541700 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70264475541700
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: &70264475541060 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70264475541060
+description: Provides Argentine phone number parsing, validation, formatting and meta-information.
+email:
+- norman@njclarke.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- README.md
+- Rakefile
+- lib/nt54.rb
+- lib/nt54/area.rb
+- lib/nt54/areas.csv
+- lib/nt54/parser.rb
+- lib/nt54/parser/machinery.rb
+- lib/nt54/parser/visitor.rb
+- lib/nt54/parser/visitors/dialtone.rb
+- lib/nt54/parser/visitors/wait_for_area_code.rb
+- lib/nt54/parser/visitors/wait_for_area_code_completion.rb
+- lib/nt54/parser/visitors/wait_for_area_code_or_mobile_prefix_completion.rb
+- lib/nt54/parser/visitors/wait_for_country_code_end.rb
+- lib/nt54/parser/visitors/wait_for_country_code_start.rb
+- lib/nt54/parser/visitors/wait_for_local_number.rb
+- lib/nt54/parser/visitors/wait_for_local_prefix.rb
+- lib/nt54/parser/visitors/wait_for_mobile_prefix_completion.rb
+- lib/nt54/parser/visitors/wait_for_mobile_prefix_or_area_code.rb
+- lib/nt54/parser/visitors/wait_for_prefix.rb
+- lib/nt54/parser/visitors/wait_for_special_number_completion.rb
+- lib/nt54/phone_number.rb
+- lib/nt54/province.rb
+- lib/nt54/provinces.csv
+- lib/nt54/special_number.rb
+- lib/nt54/special_numbers.csv
+- lib/nt54/version.rb
+- nt54.gemspec
+- test/helper.rb
+- test/parser_test.rb
+homepage: http://github.com/norman/nt54
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: A library for working with Argentine phone numbers
+test_files: []