my_zipcode_gem 0.1.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+tmp/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in my_zipcode_gem.gemspec
+gemspec

data/README.textile

@@ -0,0 +1,126 @@
+h1. My Zipcode Gem
+
+Simple gem to handle zipcode lookups and related functionality.
+
+h2. Installation
+
+Add the following line to your Gemfile:
+
+bc. gem 'my_zipcode_gem'
+  
+Run:
+
+bc. rake bundle install
+  
+Generate the models and populate the data:
+
+bc. rails g my_zipcode_gem:models
+    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.
+  
+You can also look for a zipcode from a city and state:
+
+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
+  
+h3. Automatic JQuery/AJAX lookup
+
+You can have a user enter a zipcode and automatically lookup their city, state and county.
+
+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)
+
+Then add this to your application.js, but remember to replace [mycontrollername] with your own controller.
+
+bc. $(document).ready(function() {
+        // Interactive Zipcodes
+        $('input.zipcode_interactive').blur(function(data) {
+            var elem_id = $(this).attr("id");
+            var base_id = elem_id.substring(0, elem_id.lastIndexOf("_"));
+            $.get("/mycontrollername/get_zip_data/" + this.value, {},
+            function(data) {
+                var zipcode = $.parseJSON(data);
+                var city = $('#' + base_id + '_city');
+                var state = $('#' + base_id + '_state');
+                var county = $('#' + base_id + '_county');
+                if (zipcode.err) {
+                    alert(zipcode.err);
+                } else {
+                    city.val(zipcode.city);
+                    state.val(zipcode.state)
+                    county.val(zipcode.county)
+                }
+            })
+        });
+    });
+
+You will also need a controller method similar to this, which will return the data to your form:
+
+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 = {
+          'state' => @zipcode.state.abbr,
+          'county' => @zipcode.county.name,
+          'city' => @zipcode.city.titleize
+        }
+        render :text => data.to_json
+      else
+        if params[:code].blank?
+          return true
+        else
+          if params[:code].is_zipcode?
+            data = {
+              'err' => "Could not find Zipcode [#{params[:code]}].  If this is a valid zipcode please notify support <support@mydomain.com>, so we can update our database."
+            }
+          else
+            data = {
+              'err' => "[#{params[:code]}] is not a valid Zipcode."
+            }
+          end
+          render :text => data.to_json
+        end
+      end
+    end
+
+And define a route for the AJAX function in routes.rb:
+
+bc. get 'mycontrollername/get_zip_data/:code', :controller => 'mycontrollername', :action => 'get_zip_data'
+
+That's about it.  
+
+Let me know if there are any errors.  I cut and pasted the code above from a working application, but there may be some gotchas that I missed.
+
+h2. LOG
+
+h3. 05/03/2011:
+
+Initial Release

data/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'cucumber'
+require 'cucumber/rake/task'
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --format progress"
+end
+
+task :default => :features
+task :test => :features

data/features/step_definitions/common_steps.rb

@@ -0,0 +1,76 @@
+When(/^I run "([^\"]*)"$/) do |command|
+  system("cd #{@current_directory} && #{command}").should be_true
+end
+
+When(/^I add "([^\"]*)" to file "([^\"]*)"$/) do |content, short_path|
+  path = File.join(@current_directory, short_path)
+  File.should exist(path)
+  File.open(path, 'a') { |f| f.write(content + "\n") }
+end
+
+When(/^I replace "([^\"]*)" with "([^\"]*)" in file "([^\"]*)"$/) do |old_content, new_content, short_path|
+  path = File.join(@current_directory, short_path)
+  File.should exist(path)
+  content = File.read(path).gsub(old_content, new_content)
+  File.open(path, 'w') { |f| f.write(content) }
+end
+
+When(/^I insert "([^\"]*)" into "([^\"]*)" after line (\d+)$/) do |content, short_path, after_line|
+  path = File.join(@current_directory, short_path)
+  File.should exist(path)
+  lines = File.read(path).split("\n")
+  lines[after_line.to_i, 0] = content
+  File.open(path, 'w') { |f| f.write(lines.join("\n")) }
+end
+
+Then(/^I should see file "([^\"]*)"$/) do |path|
+  File.should exist(File.join(@current_directory, path))
+end
+
+Then(/^I should see "(.*)" in file "([^\"]*)"$/) do |content, short_path|
+  path = File.join(@current_directory, short_path)
+  File.should exist(path)
+  File.readlines(path).join.should include(content)
+end
+
+Then(/^I should not see "(.*)" in file "([^\"]*)"$/) do |content, short_path|
+  path = File.join(@current_directory, short_path)
+  File.should exist(path)
+  File.readlines(path).join.should_not include(content)
+end
+
+Then(/^I should see the following files$/) do |table|
+  table.raw.flatten.each do |path|
+    File.should exist(File.join(@current_directory, path))
+  end
+end
+
+Then(/^I should see the following in file "([^\"]*)"$/) do |short_path, table|
+  path = File.join(@current_directory, short_path)
+  File.should exist(path)
+  table.raw.flatten.each do |content|
+    File.readlines(path).join.should include(content)
+  end
+end
+
+Then(/^I should successfully run "([^\"]*)"$/) do |command|
+  system("cd #{@current_directory} && #{command}").should be_true
+end
+
+Then(/^I should see "([^\"]*)" when running "([^\"]*)"$/) do |expected_response, command|
+  `cd #{@current_directory} && #{command}`.should include(expected_response)
+end
+
+Then(/^I should see (\d+) records in the "([^\"]*)" table$/) do |count, table_name|
+  FileUtils.chdir(@current_directory)
+  ActiveRecord::Base.establish_connection(
+    :adapter => 'sqlite3', 
+    :database => "db/development.sqlite3",
+    :pool => 5,
+    :timeout => 5000
+  )
+  sql = "SELECT COUNT(*) FROM #{table_name}"
+  result = ActiveRecord::Base.connection.select_rows(sql)
+  puts ">>> result: [#{result.flatten.first}]"
+  "Record Count:#{result.flatten.first}".should == "Record Count:#{count}"
+end

data/features/step_definitions/rails_setup_steps.rb

@@ -0,0 +1,17 @@
+Given(/^a new Rails app$/) do
+  FileUtils.rm_rf "tmp/rails_app"
+  FileUtils.mkdir_p("tmp")
+  system("rails new tmp/rails_app").should be_true
+  system("ln -s ../../../lib/generators tmp/rails_app/lib/generators").should be_true
+  @current_directory = File.expand_path("tmp/rails_app")
+end
+
+Given %{a new migrated Rails app} do
+  # Don't delete the rails app
+  FileUtils.mkdir_p("tmp")
+  system("rails new tmp/rails_app").should be_true
+  system("ln -s ../../../lib/generators tmp/rails_app/lib/generators").should be_true
+  @current_directory = File.expand_path("tmp/rails_app")
+  When %{I run "rails g my_zipcode_gem:models"}
+  Then %{I should successfully run "rake db:migrate"}
+end

data/features/support/env.rb

@@ -0,0 +1,8 @@
+require 'cucumber'
+require 'rspec'
+require 'rails'
+require 'active_record'
+
+Before do
+  # FileUtils.rm_rf "tmp/rails_app"
+end

data/features/support/string.rb

@@ -0,0 +1,128 @@
+class String
+  
+  class << self
+    def random(count = 6, ranges = [('a'..'z'),('A'..'Z'),('0'..'9')])
+      o =  ranges.map{|i| i.to_a}.flatten;  
+      string  =  (0..(count-1)).map{ o[rand(o.length)]  }.join;
+    end
+  end
+  
+  def left(count)
+    self.slice(0,count)
+  end
+  
+  def right(count)
+    self.slice(-count,count)
+  end
+  
+  def left_trim
+    # remove leading whitespace
+    self.gsub(/^[\t\s]+/, '')
+  end
+  
+  def right_trim
+    # remove trailing whitespace
+    self.gsub(/[\t\s]+$/, '')
+  end
+  
+  def trim
+    # remove leading and trailing whitespace
+    self.left_trim.right_trim
+  end
+
+  # html = <<-stop.here_with_pipe
+  #   |<!-- Begin: comment  -->
+  #   |<script type="text/javascript">
+  # stop
+  def here_with_pipe(linefeeds = false)
+    lines = self.split("\n")
+    lines.map! {|c| c.sub!(/\s*\|/, '')}
+    new_string = lines.join(linefeeds ? "\n" : " ")
+    self.replace(new_string)
+  end
+
+  def is_alpha_numeric?
+    regex = /^[a-zA-Z0-9]+$/
+    return (self =~ regex) == 0 ? true : false
+  end
+
+  def is_email_address?
+    # //Email address
+    # //Use this version to seek out email addresses in random documents and texts.
+    # //Does not match email addresses using an IP address instead of a domain name.
+    # //Does not match email addresses on new-fangled top-level domains with more than 4 letters such as .museum.
+    # //Including these increases the risk of false positives when applying the regex to random documents.
+    # '\b[A-Z0-9._%-]+@[A-Z0-9.-]+\.[A-Z]{2,4}\b'
+    # 
+    # //Email address (anchored)
+    # //Use this anchored version to check if a valid email address was entered.
+    # //Does not match email addresses using an IP address instead of a domain name.
+    # //Does not match email addresses on new-fangled top-level domains with more than 4 letters such as .museum.
+    # //Requires the "case insensitive" option to be ON.
+    # '^[A-Z0-9._%-]+@[A-Z0-9.-]+\.[A-Z]{2,4}$'
+    # 
+    # //Email address (anchored; no consecutive dots)
+    # //Use this anchored version to check if a valid email address was entered.
+    # //Improves on the original email address regex by excluding addresses with consecutive dots such as john@aol...com
+    # //Does not match email addresses using an IP address instead of a domain name.
+    # //Does not match email addresses on new-fangled top-level domains with more than 4 letters such as .museum.
+    # //Including these increases the risk of false positives when applying the regex to random documents.
+    # '^[A-Z0-9._%-]+@(?:[A-Z0-9-]+\.)+[A-Z]{2,4}$'
+    # 
+    # //Email address (no consecutive dots)
+    # //Use this version to seek out email addresses in random documents and texts.
+    # //Improves on the original email address regex by excluding addresses with consecutive dots such as john@aol...com
+    # //Does not match email addresses using an IP address instead of a domain name.
+    # //Does not match email addresses on new-fangled top-level domains with more than 4 letters such as .museum.
+    # //Including these increases the risk of false positives when applying the regex to random documents.
+    # '\b[A-Z0-9._%-]+@(?:[A-Z0-9-]+\.)+[A-Z]{2,4}\b'
+    # 
+    # //Email address (specific TLDs)
+    # //Does not match email addresses using an IP address instead of a domain name.
+    # //Matches all country code top level domains, and specific common top level domains.
+    # '^[A-Z0-9._%-]+@[A-Z0-9.-]+\.(?:[A-Z]{2}|com|org|net|biz|info|name|aero|biz|info|jobs|museum|name)$'
+    # 
+    # //Email address: Replace with HTML link
+    # '\b(?:mailto:)?([A-Z0-9._%-]+@[A-Z0-9.-]+\.[A-Z]{2,4})\b'
+    
+    email_regex = %r{^[A-Z0-9._%-]+@[A-Z0-9.-]+\.(?:[A-Z]{2}|com|org|net|biz|info|name|aero|biz|info|jobs|museum|name)$}xi # Case insensitive
+    
+    return (self =~ email_regex) == 0 ? true : false
+  end
+  
+  def is_zipcode?
+    self =~ %r{^(\d{5})(-\d{4})?$}x ? true : false
+  end
+
+  def format_phone
+    '(' << slice(0..2) << ')' << slice(3..5) << '-' << slice(-4,4)
+  end
+
+  def is_numeric?
+    begin
+      Float(self)
+    rescue
+      false # not numeric
+    else
+      true # numeric
+    end
+  end
+
+  def sanitize
+    clean_string = self.gsub(/[^a-z0-9,! \-\(\)\:\;\.\&\$]+/i, '')
+    #p "SAN: #{clean_string}"
+    clean_string
+  end
+
+  def shorten(count = 30)
+    if self.length >= count
+      shortened = self[0, count]
+      splitted = shortened.split(/\s/)
+      words = splitted.length
+      splitted[0, words-1].join(" ") + ' ...'
+    else
+      self
+    end
+  end
+  
+end

data/features/zipcodes.feature

@@ -0,0 +1,24 @@
+Feature: My Zipcode Gem
+  In order to manage zipcode resources
+  As a rails developer
+  I want to generate models for zipcode, county and state, and populate their tables
+
+  Scenario: Generate models and migration for zipcode, county and state
+    Given a new Rails app
+    Then I should see "my_zipcode_gem:models" when running "rails g"
+    When I run "rails g my_zipcode_gem:models"
+    Then I should see the following files
+      | app/models/zipcode.rb    |
+      | app/models/state.rb      |
+      | app/models/county.rb     |
+      | lib/tasks/zipcodes.rake  |
+      | db/migrate               |
+    And I should see "gem "mocha", :group => :test" in file "Gemfile"
+    And I should successfully run "rake db:migrate"
+
+  Scenario: Update data for zipcodes, counties and states tables
+    Given a new migrated Rails app
+    Then I should successfully run "rake zipcodes:update"
+    And I should see 51 records in the "states" table
+    And I should see 3142 records in the "counties" table
+    And I should see 42366 records in the "zipcodes" table

data/lib/generators/my_zipcode_gem/models_generator.rb

@@ -0,0 +1,46 @@
+module MyZipcodeGem
+  class ModelsGenerator < Base
+    include Rails::Generators::Migration
+
+    source_root File.expand_path('../templates', __FILE__)
+    
+    def initialize(*args, &block)
+      super
+    end
+
+    def generate_models
+      # puts ">>> generate_zipcodes:"
+    end
+    
+    def add_gems
+      add_gem "mocha", :group => :test
+    end
+    
+    def create_models
+      template 'zipcode_model.rb', "app/models/zipcode.rb"
+      template 'county_model.rb', "app/models/county.rb"
+      template 'state_model.rb', "app/models/state.rb"
+    end
+
+    # Implement the required interface for Rails::Generators::Migration.
+    # taken from http://github.com/rails/rails/blob/master/activerecord/lib/generators/active_record.rb
+    def self.next_migration_number(dirname)
+      if ActiveRecord::Base.timestamped_migrations
+        Time.now.utc.strftime("%Y%m%d%H%M%S")
+      else
+        "%.3d" % (current_migration_number(dirname) + 1)
+      end
+    end
+    
+    def create_migration
+      migration_template 'migration.rb', "db/migrate/create_my_zipcode_gem_models.rb"
+    end
+    
+    def create_rakefile
+      template 'zipcodes.rake', "lib/tasks/zipcodes.rake"
+    end
+    
+  end
+end
+
+# /Users/cblackburn/.rvm/gems/ruby-1.9.2-p136/gems/activerecord-3.0.3/lib/rails/generators/active_record/

data/lib/generators/my_zipcode_gem/templates/county_model.rb

@@ -0,0 +1,17 @@
+class County < ActiveRecord::Base
+  extend ActiveSupport::Memoizable
+  attr_accessible :state_id, :region_id, :abbr, :name, :count_seat
+
+  belongs_to :state
+  has_many :zipcodes
+  
+  validates :name, :uniqueness => {:scope => :state_id, :case_sensitive => false}, :presence => true
+  
+  scope :without_zipcodes, joins("LEFT JOIN zipcodes ON zipcodes.county_id = counties.id").where("zipcodes.county_id IS NULL")
+  scope :without_state, where("state_id IS NULL")
+  
+  def cities
+    zipcodes.map(&:city).sort.uniq
+  end
+  memoize :cities
+end

data/lib/generators/my_zipcode_gem/templates/migration.rb

@@ -0,0 +1,44 @@
+class CreateMyZipcodeGemModels < ActiveRecord::Migration
+  def self.up
+    # Zipcodes Table
+    create_table :zipcodes do |t|
+      t.string :code
+      t.string :city
+      t.integer :state_id
+      t.integer :county_id
+      t.string :area_code
+      t.decimal :lat, :precision => 15, :scale => 10
+      t.decimal :lon, :precision => 15, :scale => 10
+      t.timestamps
+    end
+    add_index :zipcodes, :code
+    add_index :zipcodes, :county_id
+    add_index :zipcodes, :state_id
+    add_index :zipcodes, [:lat, :lon]
+
+    # States Table
+    create_table :states do |t|
+      t.string :abbr, :limit => 2
+      t.string :name
+      t.timestamps
+    end
+    add_index :states, :abbr
+
+    # Counties Table
+    create_table :counties do |t|
+      t.integer :state_id
+      t.string :abbr
+      t.string :name
+      t.string :county_seat
+      t.timestamps
+    end
+    add_index :counties, :name
+    add_index :counties, :state_id
+  end
+
+  def self.down
+    drop_table :counties
+    drop_table :states
+    drop_table :zipcodes
+  end
+end

data/lib/generators/my_zipcode_gem/templates/state_model.rb

@@ -0,0 +1,15 @@
+class State < ActiveRecord::Base
+  extend ActiveSupport::Memoizable
+  attr_accessible :abbr, :name
+
+  has_many :zipcodes
+  has_many :counties
+
+  validates :abbr, :uniqueness => { :case_sensitive => false }, :presence => true
+  validates :name, :uniqueness => { :case_sensitive => false }, :presence => true
+  
+  def cities
+    zipcodes.map(&:city).sort.uniq
+  end
+  memoize :cities
+end

data/lib/generators/my_zipcode_gem/templates/zipcode_model.rb

@@ -0,0 +1,27 @@
+class Zipcode < ActiveRecord::Base
+  attr_accessible :code, :city, :state_id, :county_id, :lat, :lon
+  
+  belongs_to :county
+  belongs_to :state
+  
+  validates :code, :uniqueness => true, :presence => true
+  validates :state_id, :county_id, :city, :presence => true
+  
+  scope :without_county, where("county_id IS NULL")
+  scope :without_state, where("state_id IS NULL")
+  scope :ungeocoded, where("lat IS NULL OR lon IS NULL")
+
+  class << self
+    def find_by_city_state(city, state)
+      find(:first, :conditions => "city like '#{city}%' AND states.abbr like '%#{state}%'", :include => [:county => :state])
+    end
+  end
+
+  def latlon
+    [lat, lon]
+  end
+
+  def is_geocoded?
+    (!lat.nil? && !lon.nil?)
+  end
+end

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

@@ -0,0 +1,96 @@
+require 'open-uri'
+require 'fastercsv'
+namespace :zipcodes do
+
+  desc "Update states table"
+  task :update_states => :environment do
+    puts ">>> Begin update of states table..."
+    url = "https://github.com/midwire/free_zipcode_data/raw/master/all_us_states.csv"
+    data = open(url)
+    file = nil
+    if data.is_a? StringIO
+      file = Tempfile.new('all_us_states.csv')
+      file.write(data.read)
+      file.flush
+      file.close
+    else
+      file = data
+    end
+    FasterCSV.foreach(file.path, :headers => true) do |row|
+      puts "Updating state: [#{row['name']}]"
+      state = State.find_or_initialize_by_abbr(row['abbr'])
+      state.update_attribute(:name, row['name'])
+    end
+    data.close
+    puts ">>> End update of states table..."
+  end
+
+  desc "Update counties table"
+  task :update_counties => :update_states do
+    puts ">>> Begin update of counties table..."
+    url = "https://github.com/midwire/free_zipcode_data/raw/master/all_us_counties.csv"
+    data = open(url)
+    file = nil
+    if data.is_a? StringIO
+      file = Tempfile.new('all_us_counties.csv')
+      file.write(data.read)
+      file.flush
+      file.close
+    else
+      file = data
+    end
+    FasterCSV.foreach(file.path, :headers => true) do |row|
+      puts "Updating county: [#{row['name']}]"
+      # lookup state
+      state = State.find_by_abbr!(row['state'])
+      county = County.find_or_initialize_by_name_and_state_id(row['name'], state.to_param)
+      county.update_attribute(:county_seat, row['county_seat'])
+    end
+    data.close
+    puts ">>> End update of counties table..."
+  end
+
+  desc "Update zipcodes table"
+  task :update_zipcodes => :update_counties do
+    puts ">>> Begin update of zipcodes table..."
+    url = "https://github.com/midwire/free_zipcode_data/raw/master/all_us_zipcodes.csv"
+    data = open(url)
+    file = nil
+    if data.is_a? StringIO
+      file = Tempfile.new('all_us_zipcodes.csv')
+      file.write(data.read)
+      file.flush
+      file.close
+    else
+      file = data
+    end
+    FasterCSV.foreach(file.path, :headers => true) do |row|
+      puts "Updating zipcode: [#{row['code']}], '#{row['city']}, #{row['state']}, #{row['county']}"
+      # lookup state
+      state = State.find_by_abbr!(row['state'])
+      begin
+        county = County.find_by_name_and_state_id!(row['county'], state.to_param)
+      rescue Exception => e
+        puts ">>> e: [#{e}]"
+        puts ">>>> No county found for zipcode: [#{row['code']}], '#{row['city']}, #{row['state']}, #{row['county']}... SKIPPING..."
+        next
+      end
+      zipcode = Zipcode.find_or_initialize_by_code(row['code'])
+      zipcode.update_attributes!(
+        :city => row['city'].titleize,
+        :state_id => state.to_param,
+        :county_id => county.to_param,
+        :lat => row['lat'],
+        :lon => row['lon']
+      )
+    end
+    data.close
+    puts ">>> End update of zipcodes table..."
+  end
+
+  desc "Populate or update the zipcodes related tables"
+  task :update => :environment do
+    Rake::Task['zipcodes:update_zipcodes'].invoke
+  end
+
+end

data/lib/generators/my_zipcode_gem/version.rb

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

data/lib/my_zipcode_gem.rb

@@ -0,0 +1,33 @@
+require 'rails/generators/base'
+
+module MyZipcodeGem
+  class Base < Rails::Generators::Base #:nodoc:
+    # def self.source_root
+    #   @_source_root ||= File.expand_path(File.join(File.dirname(__FILE__), 'nifty', generator_name, 'templates'))
+    #   puts ">>> @_source_root: [#{@_source_root}]"
+    #   @_source_root
+    # end
+
+    def self.banner
+      "rails generate my_zipcode_gem:#{generator_name} #{self.arguments.map{ |a| a.usage }.join(' ')} [options]"
+    end
+
+    private
+
+      def add_gem(name, options = {})
+        gemfile_content = File.read(destination_path("Gemfile"))
+        File.open(destination_path("Gemfile"), 'a') { |f| f.write("\n") } unless gemfile_content =~ /\n\Z/
+        gem name, options unless gemfile_content.include? name
+      end
+
+      def print_usage
+        self.class.help(Thor::Base.shell.new)
+        exit
+      end
+
+      def destination_path(path)
+        File.join(destination_root, path)
+      end
+
+  end
+end

data/my_zipcode_gem.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "generators/my_zipcode_gem/version"
+
+Gem::Specification.new do |s|
+  s.name        = "my_zipcode_gem"
+  s.version     = MyZipcodeGem::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Chris Blackburn"]
+  s.email       = ["chris [at] midwiretech [dot] com"]
+  s.homepage    = "https://github.com/midwire/my_zipcode_gem"
+  s.summary     = %q{A Ruby gem to handle all things zipcode.}
+  s.description = %q{A Ruby gem for looking up and manipulating US postal codes and geocodes.}
+
+  s.rubyforge_project = "my_zipcode_gem"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  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('rubigen', '1.5.6')
+  s.add_dependency('fastercsv')
+
+  s.add_development_dependency('sqlite3-ruby')
+  s.add_development_dependency('shoulda', '2.11.3')
+  s.add_development_dependency('rspec')
+  s.add_development_dependency('rspec-rails')
+  s.add_development_dependency('cucumber')
+  s.add_development_dependency('cucumber-rails')
+end

metadata

@@ -0,0 +1,220 @@
+--- !ruby/object:Gem::Specification 
+name: my_zipcode_gem
+version: !ruby/object:Gem::Version 
+  hash: 25
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
+platform: ruby
+authors: 
+- Chris Blackburn
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-03 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rails
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 3
+        - 0
+        - 3
+        version: 3.0.3
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rubigen
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 5
+        - 6
+        version: 1.5.6
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: fastercsv
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: sqlite3-ruby
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: shoulda
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 37
+        segments: 
+        - 2
+        - 11
+        - 3
+        version: 2.11.3
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: rspec-rails
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id008
+- !ruby/object:Gem::Dependency 
+  name: cucumber-rails
+  prerelease: false
+  requirement: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id009
+description: A Ruby gem for looking up and manipulating US postal codes and geocodes.
+email: 
+- chris [at] midwiretech [dot] com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.textile
+- Rakefile
+- features/step_definitions/common_steps.rb
+- features/step_definitions/rails_setup_steps.rb
+- features/support/env.rb
+- features/support/string.rb
+- features/zipcodes.feature
+- lib/generators/my_zipcode_gem/models_generator.rb
+- lib/generators/my_zipcode_gem/templates/county_model.rb
+- lib/generators/my_zipcode_gem/templates/migration.rb
+- lib/generators/my_zipcode_gem/templates/state_model.rb
+- lib/generators/my_zipcode_gem/templates/zipcode_model.rb
+- lib/generators/my_zipcode_gem/templates/zipcodes.rake
+- lib/generators/my_zipcode_gem/version.rb
+- lib/my_zipcode_gem.rb
+- my_zipcode_gem.gemspec
+has_rdoc: true
+homepage: https://github.com/midwire/my_zipcode_gem
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: my_zipcode_gem
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: A Ruby gem to handle all things zipcode.
+test_files: 
+- features/step_definitions/common_steps.rb
+- features/step_definitions/rails_setup_steps.rb
+- features/support/env.rb
+- features/support/string.rb
+- features/zipcodes.feature