my_zipcode_gem 0.1.1 → 0.1.2

data/README.textile

@@ -1,6 +1,6 @@
 h1. My Zipcode Gem
 
-Simple gem to handle zipcode lookups and related functionality.
+Simple gem to handle zipcode lookups and related functionality.  @rake zipcodes:update@ will automatically download and update your local zipcode database.  Generates three models for extended zipcode functionality.
 
 h2. Installation
 
@@ -15,20 +15,20 @@ bc. rake bundle install
 Generate the models and populate the data:
 
 bc. rails g my_zipcode_gem:models
-    rake db:migrate
-    rake zipcodes:update
+rake db:migrate
+rake zipcodes:update
   
 You should now have three new tables and three new models, Zipcode, State, County.
 
 h2. Usage
 
 bc. zipcode = Zipcode.find_by_code '66206'
-    zipcode.state.abbr    # => 'KS'
-    zipcode.city          # => 'Shawnee Mission'
-    zipcode.county.name   # => 'Johnson'
-    zipcode.lat.to_s      # => '38.959356', it is actually a BigDecimal object converted to_s for documentation.
-    zipcode.lon.to_s      # => '-94.716155', ditto
-    zipcode.is_geocoded?  # => true, most if not all should be pre-geocoded.
+zipcode.state.abbr    # => 'KS'
+zipcode.city          # => 'Shawnee Mission'
+zipcode.county.name   # => 'Johnson'
+zipcode.lat.to_s      # => '38.959356', it is actually a BigDecimal object converted to_s for documentation.
+zipcode.lon.to_s      # => '-94.716155', ditto
+zipcode.is_geocoded?  # => true, most if not all should be pre-geocoded.
   
 You can also look for a zipcode from a city and state:
 
@@ -37,14 +37,14 @@ bc. Zipcode.find_by_city_state "Shawnee Mission", "KS"
 You can use State and County objects as follows:
 
 bc. state = State.find_by_abbr "MO"
-    state.cities.count    # => 963
-    state.cities          # gives you an sorted array of all cities for the state
-    state.zipcodes.count  # => 1195
-    ...
-    county = state.counties.first
-    county.cities.count   # => 5
-    county.cities         # gives you an sorted array of all cities for the county
-    county.zipcodes.count # => 5
+state.cities.count    # => 963
+state.cities          # gives you a sorted array of all cities for the state
+state.zipcodes.count  # => 1195
+...
+county = state.counties.first
+county.cities.count   # => 5
+county.cities         # gives you a sorted array of all cities for the county
+county.zipcodes.count # => 5
   
 h3. Automatic JQuery/AJAX lookup
 
@@ -53,13 +53,13 @@ You can have a user enter a zipcode and automatically lookup their city, state a
 Put something like this in your view:
 
 bc. f.text_field :zip, :size => 5, :maxlength => 5, :class => 'zipcode_interactive'
-    f.text_field :city, :size => 20, :maxlength => 60, :readonly => true
-    f.text_field(:state, :size => 2, :maxlength => 2, :readonly => true)
-    f.text_field(:county, :size => 20, :maxlength => 60, :readonly => true)
+f.text_field :city, :size => 20, :maxlength => 60, :readonly => true
+f.text_field(:state, :size => 2, :maxlength => 2, :readonly => true)
+f.text_field(:county, :size => 20, :maxlength => 60, :readonly => true)
 
 Then add this to your application.js, but remember to replace [mycontrollername] with your own controller.
 
-bc. $(document).ready(function() {
+bc.    $(document).ready(function() {
         // Interactive Zipcodes
         $('input.zipcode_interactive').blur(function(data) {
             var elem_id = $(this).attr("id");
@@ -83,7 +83,7 @@ bc. $(document).ready(function() {
 
 You will also need a controller method similar to this, which will return the data to your form:
 
-bc. def get_zip_data
+bc.    def get_zip_data
       @zipcode = Zipcode.find_by_code(params[:code], :include => [:county, :state])
       if @zipcode
         @counties = County.find(:all, :conditions => [ "state_id = ?", @zipcode.county.state_id ])

data/lib/generators/my_zipcode_gem/templates/zipcodes.rake

@@ -93,4 +93,71 @@ namespace :zipcodes do
     Rake::Task['zipcodes:update_zipcodes'].invoke
   end
 
+  desc "Export US States to a .csv file"
+  task :export_states => :environment do
+    @states = State.order("name ASC")
+    csv_string = FasterCSV.generate do |csv|
+      csv << ["abbr", "name"]
+      @states.each do |state|
+        csv << [
+          state.abbr,
+          state.name
+          ]
+      end
+    end
+    filename = "all_us_states.csv"
+    open("#{Rails.root}/db/#{filename}", 'w') do |f|
+      f.write(csv_string)
+    end
+  end
+
+  desc "Export all US Counties to a .csv file"
+  task :export_counties => :environment do
+    @counties = County.order("name ASC")
+    csv_string = FasterCSV.generate do |csv|
+      csv << ["name", "state", "county_seat"]
+      @counties.each do |county|
+        csv << [
+          county.name,
+          county.state.abbr,
+          county.county_seat
+          ]
+      end
+    end
+    filename = "all_us_counties.csv"
+    open("#{Rails.root}/db/#{filename}", 'w') do |f|
+      f.write(csv_string)
+    end
+  end
+
+  desc "Export the zipcodes with county and state data"
+  task :export_zipcodes => :environment do
+    @zipcodes = Zipcode.order("code ASC")
+    csv_string = FasterCSV.generate do |csv|
+      csv << ["code", "city", "state", "county", "area_code", "lat", "lon"]
+      @zipcodes.each do |zip|
+        csv << [
+          zip.code,
+          zip.city,
+          zip.state.abbr,
+          zip.county.nil? ? '' : zip.county.name,
+          zip.area_code,
+          zip.lat,
+          zip.lon
+          ]
+      end
+    end
+    filename = "all_us_zipcodes.csv"
+    open("#{Rails.root}/db/#{filename}", 'w') do |f|
+      f.write(csv_string)
+    end
+  end
+
+  desc "Export zipcodes, states and counties tables"
+  task :export => :environment do
+    Rake::Task['zipcodes:export_states'].invoke
+    Rake::Task['zipcodes:export_counties'].invoke
+    Rake::Task['zipcodes:export_zipcodes'].invoke
+  end
+
 end

data/lib/generators/my_zipcode_gem/version.rb

@@ -1,3 +1,3 @@
 module MyZipcodeGem
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/my_zipcode_gem.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |s|
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
 
-  s.add_dependency('rails', '3.0.3')
+  s.add_dependency('rails', '>= 3.0.0')
   s.add_dependency('rubigen', '1.5.6')
   s.add_dependency('fastercsv')
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: my_zipcode_gem
 version: !ruby/object:Gem::Version 
-  hash: 25
+  hash: 31
   prerelease: 
   segments: 
   - 0
   - 1
-  - 1
-  version: 0.1.1
+  - 2
+  version: 0.1.2
 platform: ruby
 authors: 
 - Chris Blackburn
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-05-03 00:00:00 -05:00
+date: 2011-06-29 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -24,14 +24,14 @@ dependencies:
   requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - "="
+    - - ">="
       - !ruby/object:Gem::Version 
-        hash: 1
+        hash: 7
         segments: 
         - 3
         - 0
-        - 3
-        version: 3.0.3
+        - 0
+        version: 3.0.0
   type: :runtime
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
@@ -208,7 +208,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: my_zipcode_gem
-rubygems_version: 1.6.2
+rubygems_version: 1.5.3
 signing_key: 
 specification_version: 3
 summary: A Ruby gem to handle all things zipcode.