area 0.2.2 → 0.3

data/lib/area.rb

@@ -1,27 +1,117 @@
-require 'csv'
+if RUBY_VERSION.to_f >= 1.9 # ;_;
+  require 'csv'
+else
+  require 'rubygems'
+  require 'faster_csv'
+end
 
 module Area
-  DATA = CSV.read(File.open(File.join(File.dirname(__FILE__), '..', 'data', 'areacodes.csv')))
-end
 
+  zip_path = File.open(File.join(File.dirname(__FILE__), '..', 'data', 'zipcodes.csv'))
+  area_path = File.open(File.join(File.dirname(__FILE__), '..', 'data', 'areacodes.csv'))
+
+  # there is probably a better way to do this...
+  if RUBY_VERSION.to_f >= 1.9
+    AREA_CODES = CSV.read(area_path)
+    ZIP_CODES = CSV.read(zip_path)
+  else
+    AREA_CODES = FasterCSV.parse(area_path)
+    ZIP_CODES = FasterCSV.parse(zip_path)
+  end
+end
+      
 class Integer
-  def to_region
-    Area::DATA.each do |row|
+  def to_region(options = {})
+    if self.to_s.length == 3 # an area code
+      Area::AREA_CODES.each do |row|
+        if row.first == self.to_s
+          return row.last
+        end
+      end
+    else # more than 3 digits, assume a zipcode
+      Area::ZIP_CODES.each do |row|
+        if row.first == self.to_s
+          if options[:city]
+            return row[1]
+          elsif options[:state]
+            return row[2]
+          else
+            return row[1] + ', ' + row[2]
+          end
+        end
+      end
+    end
+  end
+
+  def to_latlon
+    Area::ZIP_CODES.each do |row|
+      if row.first == self.to_s
+        return row[3] + ', ' + row[4]
+      end
+    end
+  end
+
+  def to_lat
+    Area::ZIP_CODES.each do |row|
+      if row.first == self.to_s
+        return row[3]
+      end
+    end
+  end
+
+  def to_lon
+    Area::ZIP_CODES.each do |row|
       if row.first == self.to_s
-        return row.last
+        return row[4]
       end
     end
   end
+
+  def to_gmt_offset
+    Area::ZIP_CODES.each do |row|
+      if row.first == self.to_s
+        return row[5]
+      end
+    end
+  end
+
 end
 
 class String
   def to_area
     @area_codes = []
-    Area::DATA.each do |row|
-      if row[1] == self        
+    Area::AREA_CODES.each do |row|
+      if row[1].upcase == self        
         @area_codes.push(row.first)
       end
     end
-    @area_codes
+    if @area_codes.length == 1
+      return @area_codes.first
+    else
+      return @area_codes
+    end
+  end
+
+  def to_zip
+    @zip_codes = []
+    Area::ZIP_CODES.each do |row|
+      if row[1] and row[1].downcase == self.downcase
+        @zip_codes.push(row.first)
+      end
+    end
+    if @zip_codes.length == 1
+      return @zip_codes.first
+    else
+      return @zip_codes
+    end
   end
+
+  def to_gmt_offset
+    Area::ZIP_CODES.each do |row|
+      if row[2].upcase == self.to_s.upcase
+        return row[5]
+      end      
+    end
+  end
+
 end

data/readme.md

@@ -2,20 +2,80 @@
 
 # Area
 
-Hi. This gem allows you to convert a region in the United States to an area code and vice versa. Area uses public data and does not rely on any external services or have any dependencies. 
+Hi. This gem allows you to perform the following conversions:
 
-## Usage
+* An area code to a region (state)
+* A state to an area code
+* A zip code to a place (control granularity with city and state options)
+* A zipcode to a lat/lon
+* A zipcode to just a lat
+* A zipcode to just a lon
+* A zipcode to its GMT offset
+* A state to its GMT offset
+
+Area uses public domain data and does not rely on any external services.
+
+## Installation
 
 In your gemfile: `gem 'area'`
 
-In your code: 
+## Usaage
 
+#### Convert an area code to a state/region
 ``` ruby
 646.to_region #=> NY
-"AK".to_area #=> ["907"]
+```
+
+#### Convert a state to an area code
+```` ruby
+"AK".to_area #=> "907"
 "CT".to_area #=> ["203", "860"]
 ```
 
-### Testing and Contributing
+#### Convert a zip code to a place
+```` ruby
+"11211".to_region #=> "Brooklyn, NY"
+"11211".to_region(:city => true) #=> "Brooklyn"
+"11211".to_region(:state => true) #=> "NY"
+```
+
+#### Convert a zip code to a lat/lon
+```` ruby
+"11211".to_latlon #=> "40.71209, -73.95427"
+```
+
+#### Convert a zip code to a lat
+```` ruby
+"11211".to_lat #=> "40.71209"
+```
+
+#### Convert a zip code to a lon
+```` ruby
+"11211".to_lon #=> "40.71209, -73.95427"
+```
+
+#### Get the GMT offset of a zipcode
+```` ruby
+"11211".to_gmt_offset #=> "-5"
+```
+
+#### Get the GMT offset of a state
+```` ruby
+"NY".to_gmt_offset #=> "-5" # by state
+```
+
+## Testing and Contributing and Stuff
+
+Contributions are more than welcome. I'm [testing](http://travis-ci.org/jgv/area) with minitest. This gem supports:
+
+* Ruby 1.8.7
+* Ruby 1.9.2
+* Ruby 1.9.3
+* JRuby 1.8
+* JRuby 1.9
+* Rubinius 1.8
+* Rubinius 1.9
+
+## Copyright
 
-Contributions are more than welcome. I'm testing with minitest.
+Copyright (c) 2012 Jonathan Vingiano. See [LICENSE](https://github.com/jgv/area/blob/master/MIT-LICENSE) for details.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: area
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: '0.3'
   prerelease: 
 platform: ruby
 authors:
@@ -11,6 +11,22 @@ bindir: bin
 cert_chain: []
 date: 2012-06-23 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: fastercsv
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -27,16 +43,47 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: Area allows you to convert a region in the United States to an area code
-  and vice versa. Area uses public data and does not rely on any external services
-  or have any dependencies.
-email:
-- jgv@jonathanvingiano.com
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Area allows you to perform a variety of conversions between places in
+  the United States and area codes or zip codes.
+email: jgv@jonathanvingiano.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - data/areacodes.csv
+- data/zipcodes.csv
 - lib/area.rb
 - MIT-LICENSE
 - Rakefile