dburkes-people_places_things 1.1.3 → 1.2.0

data/README.textile

@@ -4,6 +4,7 @@ PeoplePlacesThings is a collection of ruby classes for parsing and formatting U.
 
 h2. Using PeoplePlacesThings
 
+<pre><code>
   require 'people_places_things'
 
   name = PersonName.parse("george quincy harold peabody jr.")
@@ -30,6 +31,20 @@ h2. Using PeoplePlacesThings
   ANSICounties.code_for('GA', 'FULTON') => 13121
   ANSICounties.code_for(:state => 'ga', :county => 'fulton') => 13121
   ANSICounties.data_for(13121) => { :state => 'GA', :county => 'FULTON' }
+  
+  phone = PhoneNumber.parse '14045551212'
+  phone.country_code => 1
+  phone.area_code => '404'
+  phone.number => '5551212'
+  phone.exchange => '555'
+  phone.suffix => '1212'
+  phone.to_s => '1 (404) 555-1212'
+
+  zip = ZipCode.parse '30306-3522'
+  zip.base => '30306'
+  zip.plus_four => '3522'
+  zip.to_s => '30306-3522'
+</code></pre>
 
 h2. Data source
 

data/VERSION

@@ -1 +1 @@
-1.1.3
+1.2.0

data/lib/people_places_things.rb

@@ -2,6 +2,7 @@ require File.join(File.dirname(__FILE__), 'people_places_things', 'street_addres
 require File.join(File.dirname(__FILE__), 'people_places_things', 'person_name', 'person_name')
 require File.join(File.dirname(__FILE__), 'people_places_things', 'ansi_counties', 'ansi_counties')
 require File.join(File.dirname(__FILE__), 'people_places_things', 'phone_number', 'phone_number')
+require File.join(File.dirname(__FILE__), 'people_places_things', 'zip_code', 'zip_code')
 
 module PeoplePlacesThings
   VERSION = File.read('VERSION').chomp.strip rescue "Unknown"

data/lib/people_places_things/phone_number/phone_number.rb

@@ -7,10 +7,12 @@ class PhoneNumber
     parts.keys.each do |k|
       send("#{k}=", parts[k]) if @@SUPPORTED_PARTS.include?(k)
     end
+    
+    raise "Unsupported Format" if !self.exchange || !self.suffix
   end
   
   def self.parse(string)
-    extract = string.match(/.*?([-()\d ]+)/)[1].gsub(/[^\d]/, '') rescue nil
+    extract = string.strip.match(/^([-+()\d ]+)$/)[0].gsub(/[^\d]/, '') rescue nil
     raise "Unsupported Format" if !extract || extract.length < 10 || extract.length > 11
 
     parts = {}
@@ -35,4 +37,28 @@ class PhoneNumber
     ret.raw = string
     ret
   end
+  
+  def self.format(parts, fmt)
+    PhoneNumber.new(parts).to_s(fmt)
+  end
+  
+  def to_s(fmt = :full_formatted)
+    raise "Unsupported Format" if !OUTPUT_FORMATS.include?(fmt)
+
+    case fmt
+      when :full_digits
+        "#{self.country_code}#{self.area_code}#{self.exchange}#{self.suffix}"
+        
+      when :local_digits
+        "#{self.exchange}#{self.suffix}"
+        
+      when :full_formatted
+        "#{self.country_code} (#{self.area_code}) #{self.exchange}-#{self.suffix}"
+        
+      when :local_formatted
+        "#{self.exchange}-#{self.suffix}"
+    end
+  end
+  
+  OUTPUT_FORMATS = [:full_digits, :local_digits, :full_formatted, :local_formatted]
 end

data/lib/people_places_things/zip_code/zip_code.rb

@@ -0,0 +1,42 @@
+class ZipCode
+  @@SUPPORTED_PARTS = [:base, :plus_four]
+  @@SUPPORTED_PARTS.each {|attr| attr_accessor attr}
+  attr_accessor :raw
+  
+  def initialize(parts={})
+    parts.keys.each do |k|
+      send("#{k}=", parts[k]) if @@SUPPORTED_PARTS.include?(k)
+    end
+  end
+  
+  def self.parse(string)
+    tokens = string.strip.match(/^(\d{5})(-\d{4})?$/)[0].split('-') rescue nil
+    raise "Unsupported Format" if !tokens
+
+    parts = {}
+    parts[:base] = tokens.first
+    parts[:plus_four] = tokens[1] rescue nil
+    
+    ret = ZipCode.new parts
+    ret.raw = string
+    ret
+  end
+  
+  def self.format(parts, fmt)
+    ZipCode.new(parts).to_s(fmt)
+  end
+  
+  def to_s(fmt = :plus_four)
+    raise "Unsupported Format" if !OUTPUT_FORMATS.include?(fmt)
+
+    case fmt
+      when :base
+        self.base
+        
+      when :plus_four
+        [self.base, self.plus_four].compact.join('-')
+    end
+  end
+  
+  OUTPUT_FORMATS = [:base, :plus_four]
+end

data/people_places_things.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{people_places_things}
-  s.version = "1.1.3"
+  s.version = "1.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Danny Burkes"]
@@ -28,12 +28,14 @@ Gem::Specification.new do |s|
      "lib/people_places_things/person_name/person_name.rb",
      "lib/people_places_things/phone_number/phone_number.rb",
      "lib/people_places_things/street_address/street_address.rb",
+     "lib/people_places_things/zip_code/zip_code.rb",
      "people_places_things.gemspec",
      "spec/ansi_counties_spec.rb",
      "spec/helper.rb",
      "spec/person_name_spec.rb",
      "spec/phone_number_spec.rb",
-     "spec/street_address_spec.rb"
+     "spec/street_address_spec.rb",
+     "spec/zip_code_spec.rb"
   ]
   s.has_rdoc = true
   s.homepage = %q{http://github.com/dburkes/people_places_things}
@@ -46,7 +48,8 @@ Gem::Specification.new do |s|
      "spec/helper.rb",
      "spec/person_name_spec.rb",
      "spec/phone_number_spec.rb",
-     "spec/street_address_spec.rb"
+     "spec/street_address_spec.rb",
+     "spec/zip_code_spec.rb"
   ]
 
   if s.respond_to? :specification_version then

data/spec/phone_number_spec.rb

@@ -33,7 +33,27 @@ describe PhoneNumber do
     phone.suffix.should == '1212'
   end
   
-  it "should throw exception on unsupported format" do
+  it "should throw exception on unsupported parse format" do
     lambda { PhoneNumber.parse('40455512') }.should raise_error
   end
+  
+  it "should format :full_digits" do
+    PhoneNumber.parse('14045551212').to_s(:full_digits).should == '14045551212'
+  end
+
+  it "should format :local_digits" do
+    PhoneNumber.parse('14045551212').to_s(:local_digits).should == '5551212'
+  end
+
+  it "should format :full_formatted" do
+    PhoneNumber.parse('14045551212').to_s(:full_formatted).should == '1 (404) 555-1212'
+  end
+
+  it "should format :local_formatted" do
+    PhoneNumber.parse('14045551212').to_s(:local_formatted).should == '555-1212'
+  end
+
+  it "should throw exception on unsupported to_sformat" do
+    lambda { PhoneNumber.parse('14045551212').to_s(:bogus) }.should raise_error
+  end
 end

data/spec/zip_code_spec.rb

@@ -0,0 +1,31 @@
+require 'spec/helper'
+
+describe ZipCode do
+  it "should parse base" do
+    zip = ZipCode.parse '30306'
+    zip.base.should == '30306'
+    zip.plus_four.should == nil
+  end
+
+  it "should parse plus four" do
+    zip = ZipCode.parse '30306-3522'
+    zip.base.should == '30306'
+    zip.plus_four.should == '3522'
+  end
+
+  it "should throw exception on unsupported parse format" do
+    lambda { ZipCode.parse('303065344') }.should raise_error
+  end
+
+  it "should format :base" do 
+    ZipCode.parse('30306-3522').to_s(:base).should == '30306'
+  end
+
+  it "should format :plus_four" do 
+    ZipCode.parse('30306-3522').to_s(:plus_four).should == '30306-3522'
+  end
+
+  it "should throw exception on unsupported to_s format" do
+    lambda { ZipCode.parse('30306-3522').to_s(:bogus) }.should raise_error
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: dburkes-people_places_things
 version: !ruby/object:Gem::Version 
-  version: 1.1.3
+  version: 1.2.0
 platform: ruby
 authors: 
 - Danny Burkes
@@ -34,12 +34,14 @@ files:
 - lib/people_places_things/person_name/person_name.rb
 - lib/people_places_things/phone_number/phone_number.rb
 - lib/people_places_things/street_address/street_address.rb
+- lib/people_places_things/zip_code/zip_code.rb
 - people_places_things.gemspec
 - spec/ansi_counties_spec.rb
 - spec/helper.rb
 - spec/person_name_spec.rb
 - spec/phone_number_spec.rb
 - spec/street_address_spec.rb
+- spec/zip_code_spec.rb
 has_rdoc: true
 homepage: http://github.com/dburkes/people_places_things
 post_install_message: 
@@ -72,3 +74,4 @@ test_files:
 - spec/person_name_spec.rb
 - spec/phone_number_spec.rb
 - spec/street_address_spec.rb
+- spec/zip_code_spec.rb