dburkes-people_places_things 1.0.0

data/README.rdoc

@@ -0,0 +1,38 @@
+PeoplePlacesThings
+=
+PeoplePlacesThings is a collection of ruby classes for parsing and formatting U.S person names, street addresses, phone numbers, and more.
+
+Using PeoplePlacesThings
+=
+  require 'people_places_things'
+
+  name = PersonName.parse("george quincy harold peabody jr.")
+  name.first => "george"
+  name.first_i => "g"
+  name.last => "peabody"
+  name.middle => "quincy harold"
+  name.suffix => "jr."
+  name.to_s(:last_comma_first) => "peabody,george"
+  name.to_s(:full) => "george quincy peabody jr."
+
+  name2 = PersonName.parse("peabody jr., george quincy harold", :last_first_middle)
+  name.eql?(name2) => true
+
+  addr = StreetAddress.parse("204-b ne. 1st ave suite 4")
+  addr.number => "204-b"
+  addr.pre_direction => :northeast
+  addr.name => "1st"
+  addr.suffix => :avenue
+  addr.unit_type => :suite
+  addr.unit => "4"
+  addr.to_s => "204-b northeast 1st avenue suite 4"
+
+  ANSICounties.code_for('GA', 'FULTON') => 13121
+  ANSICounties.code_for(:state => 'ga', :county => 'fulton') => 13121
+  ANSICounties.data_for(13121) => { :state => 'GA', :county => 'FULTON' }
+
+Data source
+=
+The data that makes up `lib/people_places_things/ansi_counties/data/data.yml` was generated from `lib/people_places_things/ansi_counties/data/raw.txt`, which was downloaded from [the US Census website](http://www.census.gov/geo/www/ansi/download.html).
+    
+    

data/spec/ansi_counties_spec.rb

@@ -0,0 +1,27 @@
+require 'spec/helper'
+
+describe ANSICounties do
+  it "should find code for valid state and county" do
+    ANSICounties.code_for('ga', 'fulton').should == 13121
+  end
+  
+  it "should find code for valid state and county hash" do
+    ANSICounties.code_for(:state => 'ga', :county => 'fulton').should == 13121
+  end
+  
+  it "should return nil for invalid state and county" do
+    ANSICounties.code_for(:state => 'ga', :county => 'fubar').should == nil
+  end
+  
+  it "should find code for alternate st. form" do
+    ANSICounties.code_for(:state => 'MO', :county => 'saint LOUIS').should == 29510
+  end
+  
+  it "should find data for valid code" do 
+    ANSICounties.data_for(13121).should == { :state => 'GA', :county => 'FULTON' }
+  end
+  
+  it "should return nil for invalid code" do 
+    ANSICounties.data_for(1312111).should == nil
+  end
+end

data/spec/helper.rb

@@ -0,0 +1 @@
+require 'lib/people_places_things'

data/spec/person_name_spec.rb

@@ -0,0 +1,182 @@
+require 'spec/helper'
+
+describe PersonName do
+  it "should parse first_middle_last" do
+    name = PersonName.parse "george quincy drake peabody", :first_middle_last
+    name.first.should == 'george'
+    name.middle.should == 'quincy drake'
+    name.last.should == 'peabody'
+  end
+  
+  it "should parse last_first_middle" do
+    name = PersonName.parse "peabody george quincy drake", :last_first_middle
+    name.first.should == 'george'
+    name.middle.should == 'quincy drake'
+    name.last.should == 'peabody'
+  end
+  
+  it "should parse last only in first_middle_last format" do
+    name = PersonName.parse "peabody", :first_middle_last
+    name.first.should == nil
+    name.middle.should == nil
+    name.last.should == 'peabody'
+  end
+  
+  it "should parse last only in last_first_middle format" do
+    name = PersonName.parse "peabody", :last_first_middle
+    name.first.should == nil
+    name.middle.should == nil
+    name.last.should == 'peabody'
+  end
+  
+  it "should parse first middle last suffix" do
+    name = PersonName.parse "george f. peabody jr"
+    name.first.should == 'george'
+    name.middle.should == 'f.'
+    name.last.should == 'peabody'
+    name.suffix.should == 'jr'
+  end
+
+  it "should parse last suffix first middle" do
+    name = PersonName.parse "peabody jr george f.", :last_first_middle
+    name.first.should == 'george'
+    name.middle.should == 'f.'
+    name.last.should == 'peabody'
+    name.suffix.should == 'jr'
+  end
+  
+  it "should default to first_middle_last" do
+    name = PersonName.parse "george quincy drake peabody"
+    name.first.should == 'george'
+    name.middle.should == 'quincy drake'
+    name.last.should == 'peabody'
+  end
+  
+  it "should ignore spaces and commas" do
+    name = PersonName.parse "  peabody,george  quincy       drake ", :last_first_middle
+    name.first.should == 'george'
+    name.middle.should == 'quincy drake'
+    name.last.should == 'peabody'
+  end
+  
+  it "should strip periods from initials" do 
+    name = PersonName.parse "george f. peabody", :first_middle_last
+    name.first.should == 'george'
+    name.middle.should == 'f.'
+    name.middle_i == 'f'
+    name.last.should == 'peabody'
+  end
+  
+  it "should format for :first" do
+    name = PersonName.new :first => 'george', :middle => 'quincy', :last => 'peabody'
+    name.to_s(:first).should == 'george'
+  end
+  
+  it "should format for :middle" do
+    name = PersonName.new :first => 'george', :middle => 'quincy', :last => 'peabody'
+    name.to_s(:middle).should == 'quincy'
+  end
+  
+  it "should format for :last" do
+    name = PersonName.new :first => 'george', :middle => 'quincy', :last => 'peabody'
+    name.to_s(:last).should == 'peabody'
+  end
+  
+  it "should format for :full" do
+    name = PersonName.new :first => 'george', :middle => 'quincy', :last => 'peabody'
+    name.to_s(:full).should == 'george quincy peabody'
+  end
+
+  it "should format for :full_reverse" do
+    name = PersonName.new :first => 'george', :middle => 'quincy', :last => 'peabody', :suffix => 'jr.'
+    name.to_s(:full_reverse).should == 'peabody george quincy jr.'
+  end
+  
+  it "should format for :first_space_last" do
+    name = PersonName.new :first => 'george', :middle => 'quincy', :last => 'peabody'
+    name.to_s(:first_space_last).should == 'george peabody'
+  end
+  
+  it "should format for :last_space_first" do
+    name = PersonName.new :first => 'george', :middle => 'quincy', :last => 'peabody'
+    name.to_s(:last_space_first).should == 'peabody george'
+  end
+  
+  it "should format for :last_comma_first" do
+    name = PersonName.new :first => 'george', :middle => 'quincy', :last => 'peabody'
+    name.to_s(:last_comma_first).should == 'peabody,george'
+  end
+  
+  it "should format for :last_comma_space_first" do
+    name = PersonName.new :first => 'george', :middle => 'quincy', :last => 'peabody'
+    name.to_s(:last_comma_space_first).should == 'peabody, george'
+  end
+  
+  it "should handle missing parts when formatting" do 
+    PersonName.new({ :last => 'peabody' }).to_s(:last_comma_space_first).should == 'peabody'
+  end
+  
+  it "should respond to index method" do
+    name = PersonName.new :first => 'george', :middle => 'quincy', :last => 'peabody'
+    name[:first].should == 'george'
+    name[:middle].should == 'quincy'
+    name[:last].should == 'peabody'
+  end
+  
+  it "should respond to individual accessors" do 
+    name = PersonName.new :first => 'george', :middle => 'quincy', :last => 'peabody'
+    name.first.should == 'george'
+    name.first_i.should == 'g'
+    name.middle.should == 'quincy'
+    name.middle_i.should == 'q'
+    name.last.should == 'peabody'
+    name.last_i.should == 'p'
+  end
+  
+  it "should recognize exact equality" do
+    PersonName.parse("george quincy peabody").should be_eql(PersonName.parse("george quincy peabody"))
+  end
+
+  it "should ignore case for equality" do
+    PersonName.parse("george quincy peabody").should be_eql(PersonName.parse("george quincy PEABODY"))
+  end
+  
+  it "should recognize subset equality" do
+    PersonName.parse("george quincy peabody").should be_eql(PersonName.parse("george peabody"))
+  end
+  
+  it "should parse mc donald for first_middle_last" do
+    name = PersonName.parse "george quincy drake mc donald", :first_middle_last
+    name.first.should == 'george'
+    name.middle.should == 'quincy drake'
+    name.last.should == 'mcdonald'
+  end
+  
+  it "should parse mc donald for last_first_middle" do
+    name = PersonName.parse "mc donald george quincy drake", :last_first_middle
+    name.first.should == 'george'
+    name.middle.should == 'quincy drake'
+    name.last.should == 'mcdonald'
+  end
+  
+  it "should normalize suffixes" do
+    name = PersonName.parse "george quincy peabody jr"
+    name2 = PersonName.parse "peabody jr., george quincy", :last_first_middle
+    name.should be_eql(name2)
+  end
+  
+  it "should support auto detect formatting for first_middle_last" do
+    name = PersonName.parse "george f. peabody jr"
+    name.first.should == 'george'
+    name.middle.should == 'f.'
+    name.last.should == 'peabody'
+    name.suffix.should == 'jr'
+  end
+  
+  it "should support auto detect formatting for last_first_middle" do
+    name = PersonName.parse "peabody, george quincy drake"
+    name.first.should == 'george'
+    name.middle.should == 'quincy drake'
+    name.last.should == 'peabody'
+  end
+end

data/spec/street_address_spec.rb

@@ -0,0 +1,159 @@
+require 'spec/helper'
+
+describe StreetAddress do
+  it "should parse number street" do
+    addr = StreetAddress.parse "123 Main Street"
+    addr.number.should == '123'
+    addr.name.should == 'Main'
+    addr.suffix.should == :street
+  end
+  
+  it "should parse number with letter" do
+    addr = StreetAddress.parse "204-B Main Street"
+    addr.number.should == '204-B'
+    addr.name.should == 'Main'
+    addr.suffix.should == :street
+  end
+  
+  it "should parse pre direction" do 
+    addr = StreetAddress.parse "123 E Main Street"
+    addr.number.should == '123'
+    addr.pre_direction.should == :east
+    addr.name.should == 'Main'
+    addr.suffix.should == :street
+  end
+
+  it "should parse post direction" do 
+    addr = StreetAddress.parse "123 Main Street NE"
+    addr.number.should == '123'
+    addr.name.should == 'Main'
+    addr.suffix.should == :street
+    addr.post_direction.should == :northeast
+  end
+  
+  it "should parse pre and post direction" do 
+    addr = StreetAddress.parse "123 E Main Street North"
+    addr.number.should == '123'
+    addr.pre_direction.should == :east
+    addr.name.should == 'Main'
+    addr.suffix.should == :street
+    addr.post_direction.should == :north
+  end
+  
+  it "should parse street names that look like directions" do 
+    addr = StreetAddress.parse "123 E E St"
+    addr.number.should == '123'
+    addr.pre_direction.should == :east
+    addr.name.should == 'E'
+    addr.suffix.should == :street
+  end
+
+  it "should parse street names that look like directions, with post directions" do 
+    addr = StreetAddress.parse "123 E E St NE"
+    addr.number.should == '123'
+    addr.pre_direction.should == :east
+    addr.name.should == 'E'
+    addr.suffix.should == :street
+    addr.post_direction.should == :northeast
+  end
+  
+  it "should parse abbreviations" do 
+    addr = StreetAddress.parse "123 e. 1st ave"
+    addr.number.should == '123'
+    addr.pre_direction.should == :east
+    addr.name.should == '1st'
+    addr.suffix.should == :avenue
+  end
+  
+  it "should parse suites" do
+    addr = StreetAddress.parse "123 E E St NE Ste 23"
+    addr.number.should == '123'
+    addr.pre_direction.should == :east
+    addr.name.should == 'E'
+    addr.suffix.should == :street
+    addr.post_direction.should == :northeast
+    addr.unit_type.should == :suite
+    addr.unit.should == '23'
+  end
+
+  it "should parse apartments" do
+    addr = StreetAddress.parse "123 E E St NE Apartment 4"
+    addr.number.should == '123'
+    addr.pre_direction.should == :east
+    addr.name.should == 'E'
+    addr.suffix.should == :street
+    addr.post_direction.should == :northeast
+    addr.unit_type.should == :apartment
+    addr.unit.should == '4'
+  end
+  
+  it "should parse numbers" do
+    addr = StreetAddress.parse '123 E E St NE # 5'
+    addr.number.should == '123'
+    addr.pre_direction.should == :east
+    addr.name.should == 'E'
+    addr.suffix.should == :street
+    addr.post_direction.should == :northeast
+    addr.unit_type.should == :number
+    addr.unit.should == '5'
+  end
+  
+  it "should parse no number" do 
+    addr = StreetAddress.parse "Westside Highway"
+    addr.number.should == nil
+    addr.name.should == 'Westside'
+    addr.suffix.should == :highway
+  end
+
+  it "should parse directional street with suffix" do 
+    addr = StreetAddress.parse "12 north avenue"
+    addr.number.should == '12'
+    addr.name.should == 'north'
+    addr.suffix.should == :avenue
+  end
+  
+  it "should parse directional street without suffix" do 
+    addr = StreetAddress.parse "12 north"
+    addr.number.should == '12'
+    addr.name.should == 'north'
+  end
+
+  it "should parse directional street with postdir" do 
+    addr = StreetAddress.parse "12 north w"
+    addr.number.should == '12'
+    addr.name.should == 'north'
+    addr.post_direction.should == :west
+  end
+  
+  it "should parse directional street with postdir and unit" do 
+    addr = StreetAddress.parse "12 n sw apt. 2"
+    addr.number.should == '12'
+    addr.name.should == 'n'
+    addr.post_direction.should == :southwest
+    addr.unit_type.should == :apartment
+    addr.unit.should == '2'
+  end
+  
+  it "should handle commas" do
+    addr = StreetAddress.parse "123 E E St NE, suite 23"
+    addr.number.should == '123'
+    addr.pre_direction.should == :east
+    addr.name.should == 'E'
+    addr.suffix.should == :street
+    addr.post_direction.should == :northeast
+    addr.unit_type.should == :suite
+    addr.unit.should == '23'
+  end
+  
+  it "should support long form" do
+    StreetAddress.string_for(:northwest, :long).should == 'northwest'
+  end
+  
+  it "should support short form" do
+    StreetAddress.string_for(:road, :short).should == 'rd'
+  end
+  
+  it "should support short form when none exists" do
+    StreetAddress.string_for(:oaks, :short).should == StreetAddress.string_for(:oaks, :long)
+  end
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification 
+name: dburkes-people_places_things
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Danny Burkes
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-08-28 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Parsers and formatters for person names, street addresses, city/state/zip, phone numbers, etc.
+email: dburkes@netable.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+has_rdoc: true
+homepage: http://github.com/dburkes/people_places_things
+licenses: 
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 2
+summary: Parsers and formatters for person names, street addresses, city/state/zip, phone numbers, etc.
+test_files: 
+- spec/person_name_spec.rb
+- spec/street_address_spec.rb
+- spec/ansi_counties_spec.rb
+- spec/helper.rb