populator 0.2.1

data/CHANGELOG

@@ -0,0 +1,19 @@
+*0.2.1* (August 30th, 2008)
+
+* wrap sqlite inserts in transaction to improve performance
+
+* default created_at/on and updated_at/on columns to current time
+
+*0.2.0* (August 30th, 2008)
+
+* adding :per_query option to limit how many inserts are made per query
+
+* improving performance when nesting factories
+
+* adding Populate.sentences to generate a lot of text
+
+* adding Populate.words to fetch some random words
+
+*0.1.0* (August 27th, 2008)
+
+* initial release

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Ryan Bates
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Manifest

@@ -0,0 +1,26 @@
+CHANGELOG
+lib/populator/adapters/abstract.rb
+lib/populator/adapters/sqlite.rb
+lib/populator/factory.rb
+lib/populator/model_additions.rb
+lib/populator/random.rb
+lib/populator/record.rb
+lib/populator.rb
+LICENSE
+Manifest
+populator.gemspec
+README
+spec/database.yml
+spec/example_database.yml
+spec/models/category.rb
+spec/models/product.rb
+spec/populator/factory_spec.rb
+spec/populator/model_additions_spec.rb
+spec/populator/random_spec.rb
+spec/populator/record_spec.rb
+spec/README
+spec/spec.opts
+spec/spec_helper.rb
+tasks/deployment.rake
+tasks/spec.rake
+TODO

data/README

@@ -0,0 +1,86 @@
+= Populator
+
+Populate an Active Record database with mass insert.
+
+Special thanks to Zach Dennis for his ar-extensions gem which some of 
+this code is loosely based on.
+
+
+== Install
+
+Install the gem:
+
+	gem install ryanb-populator --source http://gems.github.com
+
+And then load it in your project:
+
+  require 'populator'
+
+
+== Usage
+
+This gem adds a "populate" method to all Active Record models. Pass the 
+number of records you want to create along with a block. In the block 
+you can set the column values for each record.
+
+  Person.populate(3000) do |person|
+    person.first_name = "John"
+    person.last_name = "Smith"
+  end
+
+This will do a mass insert into the database so it is very fast.
+The person object contains the "id" so you can set up associations.
+
+  Person.populate(3000) do |person|
+    person.first_name = "John"
+    person.last_name = "Smith"
+    Project.populate(30) do |project|
+      project.person_id = person.id
+    end
+  end
+
+That will create 30 projects for each person.
+
+Passing an range or array of values will randomly select one.
+
+  Person.populate(1000..5000) do |person|
+    person.gender = ['male', 'female']
+    person.annual_income = 10000..200000
+  end
+
+This will create 1000 to 5000 men or women with the annual income 
+between 10,000 and 200,000.
+
+You can pass a :per_query option to limit how many records are saved 
+per query. This defaults to 1000.
+
+  Person.populate(2000, :per_query => 100)
+
+If you need to generate fake data, there are a few methods to do this.
+
+  Populator.words(3) # generates 3 random words separated by spaces
+  Populator.words(10..20) # generates between 10 and 20 random words
+  Populator.sentences(5) # generates 5 sentences
+
+For fancier data generation, try the Faker gem.
+
+  http://faker.rubyforge.org
+
+
+== Important
+
+For performance reasons, this gem does not use actual instances of the 
+model. This means validations and callbacks are bypassed. It is up to 
+you to ensure you're adding valid data.
+
+
+== Development
+
+See spec/README for instructions on running specs.
+
+This project can be found on github at the following URL.
+
+http://github.com/ryanb/populator/
+
+If you would like to contribute to this project, please fork the 
+repository and send me a pull request.

data/Rakefile

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('populator', '0.2.1') do |p|
+  p.summary        = "Mass populate an Active Record database."
+  p.description    = "Mass populate an Active Record database."
+  p.url            = "http://github.com/ryanb/populator"
+  p.author         = 'Ryan Bates'
+  p.email          = "ryan (at) railscasts (dot) com"
+  p.ignore_pattern = ["script/*", "**/*.sqlite3"]
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }

data/TODO

@@ -0,0 +1,22 @@
+Features
+- get single table inheritance working.
+
+Possible
+- iterate through array instead of selecting at random to ensure all values are chosen
+- if hash is passed, apply given value that number of times: { 'foo' => 3, 'bar' => 2 }
+- randomly fill every column if no block is passed to populate
+- add random_foo method to record for randomly generating content
+
+Performance
+- ruby-prof to see where the bottlenecks are
+- benchmark to find faster solutions
+- ensure instantiating the model is really that much of a performance hit.
+
+Support Environments
+- sqlite 2
+- old rails
+- edge rails
+
+Tests
+- automatically detect schema changes and rebuild database
+- add db:reset, db:drop and db:create rake tasks

data/lib/populator.rb

@@ -0,0 +1,8 @@
+$:.unshift(File.dirname(__FILE__))
+require 'populator/model_additions'
+require 'populator/factory'
+require 'populator/record'
+require 'populator/random'
+
+require 'populator/adapters/abstract'
+require 'populator/adapters/sqlite'

data/lib/populator/adapters/abstract.rb

@@ -0,0 +1,18 @@
+module Populator
+  module Adapters
+    module Abstract
+      # Executes multiple SQL statements in one query when joined with ";"
+      def execute_batch(sql, name = nil)
+        raise NotImplementedError, "execute_batch is an abstract method"
+      end
+      
+      def populate(table, columns, rows, name = nil)
+        execute("INSERT INTO #{table} #{columns} VALUES #{rows.join(', ')}", name)
+      end
+    end
+  end
+end
+
+class ActiveRecord::ConnectionAdapters::AbstractAdapter
+  include Populator::Adapters::Abstract
+end

data/lib/populator/adapters/sqlite.rb

@@ -0,0 +1,26 @@
+module Populator
+  module Adapters
+    module Sqlite
+      # Executes multiple SQL statements in one query when joined with ";"
+      def execute_batch(sql, name = nil)
+        catch_schema_changes do
+          log(sql, name) do
+            @connection.transaction { |db| db.execute_batch(sql) }
+          end
+        end
+      end
+      
+      def populate(table, columns, rows, name = nil)
+        queries = []
+        rows.each do |row|
+          queries << "INSERT INTO #{table} #{columns} VALUES #{row}"
+        end
+        execute_batch(queries.join(';'), name)
+      end
+    end
+  end
+end
+
+class ActiveRecord::ConnectionAdapters::SQLiteAdapter < ActiveRecord::ConnectionAdapters::AbstractAdapter
+  include Populator::Adapters::Sqlite
+end

data/lib/populator/factory.rb

@@ -0,0 +1,77 @@
+module Populator
+  class Factory
+    DEFAULT_RECORDS_PER_QUERY = 1000
+    
+    @factories = {}
+    @depth = 0
+    
+    def self.for_model(model_class)
+      @factories[model_class] ||= new(model_class)
+    end
+    
+    def self.save_remaining_records
+      @factories.values.each do |factory|
+        factory.save_records
+      end
+      @factories = {}
+    end
+    
+    def self.remember_depth
+      @depth += 1
+      yield
+      @depth -= 1
+      save_remaining_records if @depth.zero?
+    end
+    
+    def initialize(model_class)
+      @model_class = model_class
+      @records = []
+    end
+    
+    def populate(amount, options = {}, &block)
+      self.class.remember_depth do
+        build_records(Populator.interpret_value(amount), options[:per_query] || DEFAULT_RECORDS_PER_QUERY, &block)
+      end
+    end
+    
+    def build_records(amount, per_query, &block)
+      amount.times do
+        record = Record.new(@model_class, last_id_in_database + @records.size + 1)
+        @records << record
+        block.call(record) if block
+        save_records if @records.size >= per_query
+      end
+    end
+    
+    def save_records
+      unless @records.empty?
+        @model_class.connection.populate(@model_class.quoted_table_name, columns_sql, rows_sql_arr, "#{@model_class.name} Populate")
+        @last_id_in_database = @records.last.id
+        @records.clear
+      end
+    end
+    
+    private
+    
+    def quoted_column_names
+      @model_class.column_names.map do |column_name|
+        @model_class.connection.quote_column_name(column_name)
+      end
+    end
+    
+    def last_id_in_database
+      @last_id_in_database ||= @model_class.connection.select_value("SELECT id FROM #{@model_class.quoted_table_name} ORDER BY id DESC", "#{@model_class.name} Last ID").to_i
+    end
+    
+    def columns_sql
+      "(#{quoted_column_names.join(', ')})"
+    end
+    
+    def rows_sql_arr
+      @records.map do |record|
+        quoted_attributes = record.attribute_values.map { |v| @model_class.sanitize(v) }
+        "(#{quoted_attributes.join(', ')})"
+      end
+    end
+  end
+end

data/lib/populator/model_additions.rb

@@ -0,0 +1,11 @@
+module Populator
+  module ModelAdditions
+    def populate(amount, options = {}, &block)
+      Factory.for_model(self).populate(amount, options, &block)
+    end
+  end
+end
+
+class ActiveRecord::Base
+  extend Populator::ModelAdditions
+end

data/lib/populator/random.rb

@@ -0,0 +1,52 @@
+module Populator
+  module Random
+    WORDS = %w(alias consequatur aut perferendis sit voluptatem accusantium doloremque aperiam eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo aspernatur aut odit aut fugit sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt neque dolorem ipsum quia dolor sit amet consectetur adipisci velit sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem ut enim ad minima veniam quis nostrum exercitationem ullam corporis nemo enim ipsam voluptatem quia voluptas sit suscipit laboriosam nisi ut aliquid ex ea commodi consequatur quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae et iusto odio dignissimos ducimus qui blanditiis praesentium laudantium totam rem voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident sed ut perspiciatis unde omnis iste natus error similique sunt in culpa qui officia deserunt mollitia animi id est laborum et dolorum fuga et harum quidem rerum facilis est et expedita distinctio nam libero tempore cum soluta nobis est eligendi optio cumque nihil impedit quo porro quisquam est qui minus id quod maxime placeat facere possimus omnis voluptas assumenda est omnis dolor repellendus temporibus autem quibusdam et aut consequatur vel illum qui dolorem eum fugiat quo voluptas nulla pariatur at vero eos et accusamus officiis debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non recusandae itaque earum rerum hic tenetur a sapiente delectus ut aut reiciendis voluptatibus maiores doloribus asperiores repellat)
+    
+    def value_in_range(range)
+      case range.first
+      when Integer then number_in_range(range)
+      when Time then time_in_range(range)
+      when Date then date_in_range(range)
+      else range.to_a.rand
+      end
+    end
+    
+    def words(total)
+      (1..interpret_value(total)).map { WORDS.rand }.join(' ')
+    end
+    
+    def sentences(total)
+      (1..interpret_value(total)).map do
+        words(5..20).capitalize
+      end.join('. ')
+    end
+    
+    def interpret_value(value)
+      case value
+      when Array then value.rand
+      when Range then value_in_range(value)
+      else value
+      end
+    end
+    
+    private
+    
+    def time_in_range(range)
+      Time.at number_in_range(Range.new(range.first.to_i, range.last.to_i, range.exclude_end?))
+    end
+    
+    def date_in_range(range)
+      Date.jd number_in_range(Range.new(range.first.jd, range.last.jd, range.exclude_end?))
+    end
+    
+    def number_in_range(range)
+      if range.exclude_end?
+        rand(range.last - range.first) + range.first
+      else
+        rand((range.last+1) - range.first) + range.first
+      end
+    end
+  end
+  
+  extend Random # load it into the populator module directly so we can call the methods
+end

data/lib/populator/record.rb

@@ -0,0 +1,33 @@
+module Populator
+  class Record
+    attr_accessor :attributes
+    
+    def initialize(model_class, id)
+      @attributes = { :id => id }
+      @columns = model_class.column_names
+      @columns.each do |column|
+        if column == 'created_at' || column == 'updated_at'
+          @attributes[column.to_sym] = Time.now
+        end
+        if column == 'created_on' || column == 'updated_on'
+          @attributes[column.to_sym] = Date.today
+        end
+        self.instance_eval <<-EOS
+          def #{column}=(value)
+            @attributes[:#{column}] = Populator.interpret_value(value)
+          end
+          
+          def #{column}
+            @attributes[:#{column}]
+          end
+        EOS
+      end
+    end
+    
+    def attribute_values
+      @columns.map do |column|
+        @attributes[column.to_sym]
+      end
+    end
+  end
+end

data/populator.gemspec

@@ -0,0 +1,106 @@
+
+# Gem::Specification for Populator-0.2.1
+# Originally generated by Echoe
+
+--- !ruby/object:Gem::Specification 
+name: populator
+version: !ruby/object:Gem::Version 
+  version: 0.2.1
+platform: ruby
+authors: 
+- Ryan Bates
+autorequire: 
+bindir: bin
+
+date: 2008-09-01 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: echoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Mass populate an Active Record database.
+email: ryan (at) railscasts (dot) com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- lib/populator/adapters/abstract.rb
+- lib/populator/adapters/sqlite.rb
+- lib/populator/factory.rb
+- lib/populator/model_additions.rb
+- lib/populator/random.rb
+- lib/populator/record.rb
+- lib/populator.rb
+- LICENSE
+- README
+- tasks/deployment.rake
+- tasks/spec.rake
+- TODO
+files: 
+- CHANGELOG
+- lib/populator/adapters/abstract.rb
+- lib/populator/adapters/sqlite.rb
+- lib/populator/factory.rb
+- lib/populator/model_additions.rb
+- lib/populator/random.rb
+- lib/populator/record.rb
+- lib/populator.rb
+- LICENSE
+- Manifest
+- populator.gemspec
+- README
+- spec/database.yml
+- spec/example_database.yml
+- spec/models/category.rb
+- spec/models/product.rb
+- spec/populator/factory_spec.rb
+- spec/populator/model_additions_spec.rb
+- spec/populator/random_spec.rb
+- spec/populator/record_spec.rb
+- spec/README
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/deployment.rake
+- tasks/spec.rake
+- TODO
+- Rakefile
+has_rdoc: true
+homepage: http://github.com/ryanb/populator
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Populator
+- --main
+- README
+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: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: populator
+rubygems_version: 1.2.0
+specification_version: 2
+summary: Mass populate an Active Record database.
+test_files: []

data/spec/README

@@ -0,0 +1,23 @@
+Running Specs
+-------------
+
+To prepare the specs, run this command.
+
+  script/setup
+  
+This will generate the spec/database.yml file. Configure this to work 
+with your databases. You can add and remove entries here as well to 
+test different databases. A rake task is available to run the specs for 
+each database.
+
+  rake spec             # Run specs under all databases
+  rake spec:mysql       # Run specs under mysql
+  rake spec:sqlite3     # Run specs under sqlite3
+  rake spec:postgresql  # Run specs under postgresql
+  ...
+
+Don't forget to create the user and database as necessary. You can do 
+so under MySQL with these commands.
+
+  CREATE DATABASE populator_test;
+  GRANT ALL ON populator_test.* TO populator@localhost;

data/spec/database.yml

@@ -0,0 +1,13 @@
+# you can add and remove entries to support different databases in tests.
+
+sqlite3:
+  adapter: sqlite3
+  database: spec/test.sqlite3
+  timeout: 5000
+
+mysql:
+  adapter: mysql
+  database: populator_test
+  username: populator
+  password: 
+  host: localhost

data/spec/example_database.yml

@@ -0,0 +1,20 @@
+# you can add and remove entries to support different databases in tests.
+
+sqlite3:
+  adapter: sqlite3
+  database: spec/test.sqlite3
+  timeout: 5000
+
+mysql:
+  adapter: mysql
+  database: populator_test
+  username: populator
+  password: 
+  host: localhost
+
+postgresql:
+  adapter: postgresql
+  database: populator_test
+  username: populator
+  password: populator
+  host: localhost

data/spec/models/category.rb

@@ -0,0 +1,15 @@
+class Category < ActiveRecord::Base
+  has_many :products
+end
+
+class CreateCategories < ActiveRecord::Migration
+  def self.up
+    create_table :categories do |t|
+      t.string :name
+    end
+  end
+  
+  def self.down
+    drop_table :categories
+  end
+end

data/spec/models/product.rb

@@ -0,0 +1,22 @@
+class Product < ActiveRecord::Base
+  belongs_to :category
+end
+
+class CreateProducts < ActiveRecord::Migration
+  def self.up
+    create_table :products do |t|
+      t.string       :name
+      t.text         :description
+      t.integer      :stock
+      t.float        :weight
+      t.decimal      :price
+      t.datetime     :released_at
+      t.boolean      :hidden
+      t.integer  :category_id
+    end
+  end
+  
+  def self.down
+    drop_table :products
+  end
+end

data/spec/populator/factory_spec.rb

@@ -0,0 +1,69 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+
+describe Populator::Factory do
+  describe "for products" do
+    before(:each) do
+      @factory = Populator::Factory.for_model(Product)
+    end
+  
+    it "should only use one query when inserting records" do
+      $queries_executed = []
+      @factory.populate(5)
+      $queries_executed.grep(/^insert/i).should have(1).record
+    end
+  
+    it "should start id at 1 and increment when table is empty" do
+      Product.delete_all
+      expected_id = 1
+      @factory.populate(5) do |product|
+        product.id.should == expected_id
+        expected_id += 1
+      end
+    end
+  
+    it "should start id at last id and increment" do
+      Product.delete_all
+      product = Product.create
+      expected_id = product.id+1
+      @factory.populate(5) do |product|
+        product.id.should == expected_id
+        expected_id += 1
+      end
+    end
+    
+    it "should generate within range" do
+      Product.delete_all
+      @factory.populate(2..4)
+      Product.count.should >= 2
+      Product.count.should <= 4
+    end
+  
+    it "should limit number of records per query" do
+      $queries_executed = []
+      @factory.populate(5, :per_query => 2)
+      $queries_executed.grep(/^insert/i).should have(3).records
+    end
+  end
+  
+  it "should only use two queries when nesting factories (one for each class)" do
+    $queries_executed = []
+    Populator::Factory.for_model(Category).populate(3) do |category|
+      Populator::Factory.for_model(Product).populate(3) do |product|
+        product.category_id = category.id
+      end
+    end
+    $queries_executed.grep(/^insert/i).should have(2).records
+  end
+  
+  it "should only use one query when nesting factories of the same type" do
+    $queries_executed = []
+    Populator::Factory.for_model(Product).populate(3) do |product|
+      Populator::Factory.for_model(Product).populate(3)
+    end
+    $queries_executed.grep(/^insert/i).should have(1).record
+  end
+  
+  it "should default to 1000 records per query" do
+    Populator::Factory::DEFAULT_RECORDS_PER_QUERY.should == 1000
+  end
+end

data/spec/populator/model_additions_spec.rb

@@ -0,0 +1,34 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+
+describe Populator::ModelAdditions do
+  it "should add populate method to active record class" do
+    Product.should respond_to(:populate)
+  end
+  
+  it "should add 10 records to database" do
+    Product.delete_all
+    Product.populate(10)
+    Product.count.should == 10
+  end
+  
+  it "should set attribute columns" do
+    Product.populate(1) do |product|
+      product.name = "foo"
+    end
+    Product.last.name.should == "foo"
+  end
+    
+  it "should not pass in an instance of Active Record for performance reasons" do
+    Product.populate(1) do |product|
+      product.should_not be_kind_of(ActiveRecord::Base)
+    end
+  end
+    
+  it "should not pass options hash" do
+    $queries_executed = []
+    Product.populate(5, :per_query => 2) do |product|
+      product.should_not be_kind_of(ActiveRecord::Base)
+    end
+    $queries_executed.grep(/^insert/i).should have(3).records
+  end
+end

data/spec/populator/random_spec.rb

@@ -0,0 +1,45 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+
+describe Populator::Random do
+  it "should pick a random number in range excluding last value" do
+    Populator.expects(:rand).with(5).returns(3)
+    Populator.value_in_range(10...15).should == 13
+  end
+  
+  it "should pick a random number in range including last value" do
+    Populator.expects(:rand).with(5).returns(3)
+    Populator.value_in_range(10..14).should == 13
+  end
+  
+  it "should pick a random time in range" do
+    start_time = 2.days.ago
+    end_time = Time.now
+    Populator.expects(:rand).with(end_time.to_i-start_time.to_i).returns(1)
+    Populator.value_in_range(start_time...end_time).should == Time.at(start_time.to_i + 1)
+  end
+  
+  it "should pick a random date in range" do
+    start_date = 2.years.ago.to_date
+    end_date = Date.today
+    Populator.expects(:rand).with(end_date.jd-start_date.jd).returns(1)
+    Populator.value_in_range(start_date...end_date).should == Date.jd(start_date.jd + 1)
+  end
+  
+  it "should pick a random string by converting to array" do
+    Kernel.expects(:rand).with(5).returns(2)
+    Populator.value_in_range('a'..'e').should == 'c'
+  end
+  
+  it "should pick 3 random words" do
+    Populator.words(3).split.should have(3).records
+  end
+  
+  it "should pick a random number of random words" do
+    Populator.expects(:rand).with(5).returns(3)
+    Populator.words(10...15).split.should have(13).records
+  end
+  
+  it "should generate 3 random sentences" do
+    Populator.sentences(3).split(/\. [A-Z]/).should have(3).records
+  end
+end

data/spec/populator/record_spec.rb

@@ -0,0 +1,44 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+
+describe Populator::Record do
+  it "should have a writer and reader methods for each column" do
+    record = Populator::Record.new(Product, 1)
+    Product.column_names.each do |column|
+      record.send("#{column}=", "foo")
+      record.send(column).should == "foo"
+    end
+  end
+  
+  it "should return attribute values in same order as columns" do
+    record = Populator::Record.new(Product, nil)
+    record.name = "foo"
+    expected = Product.column_names.map { |c| "foo" if c == 'name' }
+    record.attribute_values.should == expected
+  end
+  
+  it "should assign second parameter to id" do
+    Populator::Record.new(Product, 2).id.should == 2
+  end
+  
+  it "should pick random number from range" do
+    record = Populator::Record.new(Product, 1)
+    record.stock = 2..5
+    record.stock.should >= 2
+    record.stock.should <= 5
+  end
+  
+  it "should pick random value from array" do
+    record = Populator::Record.new(Product, 1)
+    record.name = %w[foo bar]
+    %w[foo bar].should include(record.name)
+  end
+  
+  it "should automatically set created/updated columns" do
+    Product.stubs(:column_names).returns(%w[id created_at updated_at created_on updated_on])
+    record = Populator::Record.new(Product, 1)
+    record.created_at.to_date.should == Date.today
+    record.updated_at.to_date.should == Date.today
+    record.created_on.should == Date.today
+    record.updated_on.should == Date.today
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,48 @@
+require 'rubygems'
+require 'spec'
+require 'active_support'
+require 'active_record'
+require File.dirname(__FILE__) + '/../lib/populator.rb'
+
+adapter = ENV['POPULATOR_ADAPTER'] || 'sqlite3'
+puts "Running specs on #{adapter}"
+
+# setup database adapter
+ActiveRecord::Base.establish_connection(
+  YAML.load(File.read(File.dirname(__FILE__) + "/database.yml"))[adapter]
+)
+
+# keep track of which queries have been executed
+unless ActiveRecord::Base.connection.respond_to? :record_query
+  ActiveRecord::Base.connection.class.class_eval do
+    IGNORED_SQL = [/^PRAGMA/, /^SELECT currval/, /^SELECT CAST/, /^SELECT @@IDENTITY/, /^SELECT @@ROWCOUNT/, /^begin /i, /^commit /i]
+    
+    def record_query(sql)
+      $queries_executed ||= []
+      $queries_executed << sql unless IGNORED_SQL.any? { |r| sql =~ r }
+    end
+    
+    def execute_with_query_record(*args, &block)
+      record_query(args.first)
+      execute_without_query_record(*args, &block)
+    end
+    alias_method_chain :execute, :query_record
+    
+    def execute_batch_with_query_record(*args, &block)
+      record_query(args.first)
+      execute_batch_without_query_record(*args, &block)
+    end
+    alias_method_chain :execute_batch, :query_record
+  end
+end
+
+# load models
+# there's probably a better way to handle this
+require File.dirname(__FILE__) + '/models/category.rb'
+require File.dirname(__FILE__) + '/models/product.rb'
+CreateCategories.migrate(:up) unless Category.table_exists?
+CreateProducts.migrate(:up) unless Product.table_exists?
+
+Spec::Runner.configure do |config|
+  config.mock_with :mocha
+end

data/tasks/deployment.rake

@@ -0,0 +1,2 @@
+desc "Build the manifest and gemspec files."
+task :build => [:build_manifest, :build_gemspec]

data/tasks/spec.rake

@@ -0,0 +1,22 @@
+require 'spec/rake/spectask'
+
+ADAPTERS = YAML.load(File.read(File.dirname(__FILE__) + "/../spec/database.yml")).keys
+
+desc "Run specs under all supported databases"
+task :spec => ADAPTERS.map { |a| "spec:#{a}" }
+
+namespace :spec do
+  ADAPTERS.each do |adapter|
+    namespace :prepare do
+      task adapter do
+        ENV["POPULATOR_ADAPTER"] = adapter
+      end
+    end
+    
+    desc "Run specs under #{adapter}"
+    Spec::Rake::SpecTask.new(adapter => "spec:prepare:#{adapter}") do |t|
+      t.spec_files = Rake::FileList["spec/**/*_spec.rb"]
+      t.spec_opts = ["-c"]
+    end
+  end
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification 
+name: populator
+version: !ruby/object:Gem::Version 
+  version: 0.2.1
+platform: ruby
+authors: 
+- Ryan Bates
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-09-01 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: echoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Mass populate an Active Record database.
+email: ryan (at) railscasts (dot) com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- lib/populator/adapters/abstract.rb
+- lib/populator/adapters/sqlite.rb
+- lib/populator/factory.rb
+- lib/populator/model_additions.rb
+- lib/populator/random.rb
+- lib/populator/record.rb
+- lib/populator.rb
+- LICENSE
+- README
+- tasks/deployment.rake
+- tasks/spec.rake
+- TODO
+files: 
+- CHANGELOG
+- lib/populator/adapters/abstract.rb
+- lib/populator/adapters/sqlite.rb
+- lib/populator/factory.rb
+- lib/populator/model_additions.rb
+- lib/populator/random.rb
+- lib/populator/record.rb
+- lib/populator.rb
+- LICENSE
+- Manifest
+- populator.gemspec
+- README
+- spec/database.yml
+- spec/example_database.yml
+- spec/models/category.rb
+- spec/models/product.rb
+- spec/populator/factory_spec.rb
+- spec/populator/model_additions_spec.rb
+- spec/populator/random_spec.rb
+- spec/populator/record_spec.rb
+- spec/README
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/deployment.rake
+- tasks/spec.rake
+- TODO
+- Rakefile
+has_rdoc: true
+homepage: http://github.com/ryanb/populator
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Populator
+- --main
+- README
+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: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: populator
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Mass populate an Active Record database.
+test_files: []
+