snail 1.2.3 → 2.0.0

data/lib/snail.rb

@@ -5,6 +5,7 @@ require 'snail/helpers'
 
 require 'cgi'
 require 'active_support/core_ext/string/output_safety'
+require 'yaml'
 
 class Snail
   include Snail::Initializable
@@ -21,7 +22,12 @@ class Snail
   attr_accessor :city
   attr_accessor :region
   attr_accessor :postal_code
-  attr_accessor :country
+  attr_reader   :country
+
+  # Store country as ISO-3166 Alpha 2
+  def country=(val)
+    @country = Snail.lookup_country_iso(val)
+  end
 
   # Aliases for easier assignment compatibility
   {
@@ -84,11 +90,6 @@ class Snail
     @origin ||= Snail.home_country
   end
 
-  # Store country as ISO-3166 Alpha 2
-  def country=(val)
-    @country = Snail.lookup_country_iso(val)
-  end
-
   def to_s
     [name, line_1, line_2, city_line, country_line].select{|line| !(line.nil? or line.empty?)}.join("\n")
   end
@@ -113,7 +114,7 @@ class Snail
       "#{postal_code} #{city}-(#{region})"
     when 'US', 'CA', 'AU', nil, ""
       "#{city} #{region}  #{postal_code}"
-    when 'IL', 'DK', 'FI', 'FR', 'DE', 'GR', 'IT', 'NO', 'ES', 'SE', 'TR', 'CY', 'PT', 'MK', 'BA'
+    when 'IL', 'DK', 'FI', 'FR', 'DE', 'GR', 'NO', 'ES', 'SE', 'TR', 'CY', 'PT', 'MK', 'BA'
       "#{postal_code} #{city}"
     when 'KW', 'SY', 'OM', 'EE', 'LU', 'BE', 'IS', 'CH', 'AT', 'MD', 'ME', 'RS', 'BG', 'GE', 'PL', 'AM', 'HR', 'RO', 'AZ'
       "#{postal_code} #{city}"
@@ -149,8 +150,14 @@ class Snail
     end
   end
 
-  # TODO localize to the origin country
   def country_line
-    ::Snail::Iso3166::ALPHA2[country].first if country and self.origin != country
+    if country and self.origin != country
+      (translated_country(self.origin, country) || translated_country("US", country))
+    end
+  end
+
+  def translated_country(origin, country)
+    path = File.join(File.dirname(File.expand_path(__FILE__)), "../assets/#{origin}.yml")
+    File.read(path).match(/^#{country}: (.*)$/)[1]
   end
 end

data/lib/snail/version.rb

@@ -1,3 +1,3 @@
 class Snail
-  VERSION = '1.2.3'
+  VERSION = '2.0.0'
 end

data/test/snail_test.rb

@@ -69,7 +69,7 @@ class SnailTest < Snail::TestCase
 
   test "includes two spaces between region and zip for domestic mail" do
     s = Snail.new(@us)
-    assert /NY  12345/, s.city_line
+    assert s.city_line.match(/NY  12345/)
   end
 
   test "does not include country name for domestic addresses" do
@@ -86,6 +86,13 @@ class SnailTest < Snail::TestCase
     assert s.to_s.match(/Canada/i)
   end
 
+  test "includes translated country name for international addresses" do
+    s = Snail.new(@us.merge(:origin => 'FR'))
+    assert s.to_s.match(/ÉTATS-UNIS/i)
+    s = Snail.new(@ca.merge(:origin => 'EC'))
+    assert s.to_s.match(/CANADÁ/i)
+  end
+
   test "includes first country name for countries with many commonly used names" do
     s = Snail.new(@ca.merge(:country => 'UK'))
     assert s.to_s.match(/United Kingdom\Z/i), s.to_s

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: snail
 version: !ruby/object:Gem::Version
-  version: 1.2.3
+  version: 2.0.0
 platform: ruby
 authors:
 - Lance Ivy
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-23 00:00:00.000000000 Z
+date: 2016-05-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -33,8 +33,257 @@ extensions: []
 extra_rdoc_files: []
 files:
 - MIT-LICENSE
-- README.rdoc
+- README.md
 - Rakefile
+- assets/AD.yml
+- assets/AE.yml
+- assets/AF.yml
+- assets/AG.yml
+- assets/AI.yml
+- assets/AL.yml
+- assets/AM.yml
+- assets/AO.yml
+- assets/AQ.yml
+- assets/AR.yml
+- assets/AS.yml
+- assets/AT.yml
+- assets/AU.yml
+- assets/AW.yml
+- assets/AX.yml
+- assets/AZ.yml
+- assets/BA.yml
+- assets/BB.yml
+- assets/BD.yml
+- assets/BE.yml
+- assets/BF.yml
+- assets/BG.yml
+- assets/BH.yml
+- assets/BI.yml
+- assets/BJ.yml
+- assets/BL.yml
+- assets/BM.yml
+- assets/BN.yml
+- assets/BO.yml
+- assets/BQ.yml
+- assets/BR.yml
+- assets/BS.yml
+- assets/BT.yml
+- assets/BV.yml
+- assets/BW.yml
+- assets/BY.yml
+- assets/BZ.yml
+- assets/CA.yml
+- assets/CC.yml
+- assets/CD.yml
+- assets/CF.yml
+- assets/CG.yml
+- assets/CH.yml
+- assets/CI.yml
+- assets/CK.yml
+- assets/CL.yml
+- assets/CM.yml
+- assets/CN.yml
+- assets/CO.yml
+- assets/CR.yml
+- assets/CU.yml
+- assets/CV.yml
+- assets/CW.yml
+- assets/CX.yml
+- assets/CY.yml
+- assets/CZ.yml
+- assets/DE.yml
+- assets/DJ.yml
+- assets/DK.yml
+- assets/DM.yml
+- assets/DO.yml
+- assets/DZ.yml
+- assets/EC.yml
+- assets/EE.yml
+- assets/EG.yml
+- assets/EH.yml
+- assets/ER.yml
+- assets/ES.yml
+- assets/ET.yml
+- assets/FI.yml
+- assets/FJ.yml
+- assets/FK.yml
+- assets/FM.yml
+- assets/FO.yml
+- assets/FR.yml
+- assets/GA.yml
+- assets/GB.yml
+- assets/GD.yml
+- assets/GE.yml
+- assets/GF.yml
+- assets/GG.yml
+- assets/GH.yml
+- assets/GI.yml
+- assets/GL.yml
+- assets/GM.yml
+- assets/GN.yml
+- assets/GP.yml
+- assets/GQ.yml
+- assets/GR.yml
+- assets/GS.yml
+- assets/GT.yml
+- assets/GU.yml
+- assets/GW.yml
+- assets/GY.yml
+- assets/HK.yml
+- assets/HM.yml
+- assets/HN.yml
+- assets/HR.yml
+- assets/HT.yml
+- assets/HU.yml
+- assets/ID.yml
+- assets/IE.yml
+- assets/IL.yml
+- assets/IM.yml
+- assets/IN.yml
+- assets/IO.yml
+- assets/IQ.yml
+- assets/IR.yml
+- assets/IS.yml
+- assets/IT.yml
+- assets/JE.yml
+- assets/JM.yml
+- assets/JO.yml
+- assets/JP.yml
+- assets/KE.yml
+- assets/KG.yml
+- assets/KH.yml
+- assets/KI.yml
+- assets/KM.yml
+- assets/KN.yml
+- assets/KP.yml
+- assets/KR.yml
+- assets/KW.yml
+- assets/KY.yml
+- assets/KZ.yml
+- assets/LA.yml
+- assets/LB.yml
+- assets/LC.yml
+- assets/LI.yml
+- assets/LK.yml
+- assets/LR.yml
+- assets/LS.yml
+- assets/LT.yml
+- assets/LU.yml
+- assets/LV.yml
+- assets/LY.yml
+- assets/MA.yml
+- assets/MC.yml
+- assets/MD.yml
+- assets/ME.yml
+- assets/MF.yml
+- assets/MG.yml
+- assets/MH.yml
+- assets/MK.yml
+- assets/ML.yml
+- assets/MM.yml
+- assets/MN.yml
+- assets/MO.yml
+- assets/MP.yml
+- assets/MQ.yml
+- assets/MR.yml
+- assets/MS.yml
+- assets/MT.yml
+- assets/MU.yml
+- assets/MV.yml
+- assets/MW.yml
+- assets/MX.yml
+- assets/MY.yml
+- assets/MZ.yml
+- assets/NA.yml
+- assets/NC.yml
+- assets/NE.yml
+- assets/NF.yml
+- assets/NG.yml
+- assets/NI.yml
+- assets/NL.yml
+- assets/NO.yml
+- assets/NP.yml
+- assets/NR.yml
+- assets/NU.yml
+- assets/NZ.yml
+- assets/OM.yml
+- assets/PA.yml
+- assets/PE.yml
+- assets/PF.yml
+- assets/PG.yml
+- assets/PH.yml
+- assets/PK.yml
+- assets/PL.yml
+- assets/PM.yml
+- assets/PN.yml
+- assets/PR.yml
+- assets/PS.yml
+- assets/PT.yml
+- assets/PW.yml
+- assets/PY.yml
+- assets/QA.yml
+- assets/RE.yml
+- assets/RO.yml
+- assets/RS.yml
+- assets/RU.yml
+- assets/RW.yml
+- assets/SA.yml
+- assets/SB.yml
+- assets/SC.yml
+- assets/SD.yml
+- assets/SE.yml
+- assets/SG.yml
+- assets/SH.yml
+- assets/SI.yml
+- assets/SJ.yml
+- assets/SK.yml
+- assets/SL.yml
+- assets/SM.yml
+- assets/SN.yml
+- assets/SO.yml
+- assets/SR.yml
+- assets/SS.yml
+- assets/ST.yml
+- assets/SV.yml
+- assets/SX.yml
+- assets/SY.yml
+- assets/SZ.yml
+- assets/TC.yml
+- assets/TD.yml
+- assets/TF.yml
+- assets/TG.yml
+- assets/TH.yml
+- assets/TJ.yml
+- assets/TK.yml
+- assets/TL.yml
+- assets/TM.yml
+- assets/TN.yml
+- assets/TO.yml
+- assets/TR.yml
+- assets/TT.yml
+- assets/TV.yml
+- assets/TW.yml
+- assets/TZ.yml
+- assets/UA.yml
+- assets/UG.yml
+- assets/UM.yml
+- assets/US.yml
+- assets/UY.yml
+- assets/UZ.yml
+- assets/VA.yml
+- assets/VC.yml
+- assets/VE.yml
+- assets/VG.yml
+- assets/VI.yml
+- assets/VN.yml
+- assets/VU.yml
+- assets/WF.yml
+- assets/WS.yml
+- assets/YE.yml
+- assets/YT.yml
+- assets/ZA.yml
+- assets/ZM.yml
+- assets/ZW.yml
 - lib/snail.rb
 - lib/snail/constants.rb
 - lib/snail/helpers.rb
@@ -62,7 +311,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
 summary: Easily format snail mail addresses for international delivery

data/README.rdoc

@@ -1,68 +0,0 @@
-= Snail
-
-International snail mail addressing is a pain. This plugin begins to make it easier.
-
-== How?
-
-The basic idea is that mailing addresses need first and foremost to make it OUT of the originating country. It's beyond the scope of my current work to consider any originating country besides the United States, so that's where I am beginning. I will leave other countries of origination to the open source community.
-
-Given the United States as a point of origin, my effort here is based on Frank's Compulsive Guide to Postal Addresses, available from http://www.columbia.edu/kermit/postal.html as of July 2009, and the USPS International Mail Manual (IMM), available from http://pe.usps.gov/text/imm/immidx.htm.
-
-The United States Postal Service (USPS) requires (strongly prefers?) a few things:
-
-* That the address be 5 lines long or less.
-* That the last address line be a country name recognized by the USPS, in all uppercase.
-* That the city line (comprising the city, state, and postal code as appropriate) immediately precede the country line.
-
-The rest of the address should be formatted according to the rules of the receiving country.
-
-Nearly all of the variation in formatting rules applies to the city line. Depending on the receiving country, the three component pieces (e.g. city, state, postal code) have different names, are pieced together in different order with different punctuation, and may or may not be required.
-
-And then there's Great Britain, which Frank's Compulsive Guide describes as "where to find the most confusing addresses on earth" (a description confirmed and further confused by a source from within Royal Mail).
-
-== The Future
-
-I hope to tackle this plugin in stages, with help from the open source community:
-
-1. Provide standardized USPS country names
-2. Provide basic formatting rules for the city line in major countries
-3. Provide basic country-specific validation logic
-4. Build a best-practice form field generator to collect appropriate address information
-5. Expand to other originating countries
-6. Continue fleshing out the formatting and validation
-
-== Example
-
-Taking regular data and formatting it into an internationally mailable address:
-
-  Snail.new(
-    :name => "Jon Doe",
-    :line_1 => "12345 Somewhere Ln",
-    :line_2 => nil,
-    :city => "Bentley",
-    :region => "WA",
-    :postal_code => "6102",
-    :country => "AU"
-  ).to_s
-  
-  => "Jon Doe\n12345 Somewhere Ln\nBENTLEY WA  6102\nAUSTRALIA"
-
-By default addresses with a country of USA are considered domestic and the country will
-be left off any output. To change the home country:
-
-  Snail.home_country = "Australia"
-  Snail.new(
-    :name => "Jon Doe",
-    :line_1 => "12345 Somewhere Ln",
-    :line_2 => nil,
-    :city => "Bentley",
-    :region => "WA",
-    :postal_code => "6102",
-    :country => "AU"
-  ).to_s
-
-  => "Jon Doe\n12345 Somewhere Ln\nBENTLEY WA  6102"
-
-See the test cases for more.
-
-Copyright (c) 2009 Lance Ivy, released under the MIT license