Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Speed up seeding your Rails application using multiple SQL inserts!
Ruby JavaScript CSS
branch: master
Failed to load latest commit information.
lib Bump to 0.1.0
spec
.gitignore Update gemspec
.rspec implement FastSeeder
.ruby-gemset Support Rails 4
.ruby-version
.travis.yml Bump to 0.1.0
Gemfile Update README
Gemfile.lock
LGPL-LICENSE initial commit
README.markdown
Rakefile Support Rails 4
fast_seeder.gemspec

README.markdown

FastSeeder Build Status

By Sergey Potapov

Speed up seeding database in Rails application using multiple SQL inserts!

Installation

Add to Gemfile:

gem "fast_seeder"

Usage

Seeding from CSV file

Lets say you have CSV file db/seeds/cities/ukraine.csv:

Kharkov,1654
Lviv,1240
Kiev,600

You can populate DB with it using FastSeeder:

# Seeding from CSV file:
FastSeeder.seed_csv!(City, "cities/ukraine.csv", :name, :founded_in, :country => "Ukraine")

Technically it equals to:

City.create(:name => "Kharkov", :founded_in => 1654, :country => "Ukraine")
City.create(:name => "Lviv"   , :founded_in => 1240, :country => "Ukraine")
City.create(:name => "Kiev"   , :founded_in => 600 , :country => "Ukraine")

But does the job faster using only one SQL query instead of three. As you also noticed it expects you to pass model class, path to CSV file(located in db/seeds), CSV columns, and default values.

Seeding in place

The next example is equivalent to showed above one, but uses inline data without CSV file:

# Seeding in place:
FastSeeder.seed!(City, :name, :founded_in, :country => "Ukraine") do
  record "Kharkov", 1654
  record "Lviv"   , 1240
  record "Kiev"   , 600
end

Supported database adapters

  • PostgreSQL
  • MySQL(mysql, mysql2)
  • SQLite3

Running specs

rake spec:all               # run specs with all supported adapters
rake spec:mysql             # run specs with mysql adapter
rake spec:mysql2            # run specs with mysql2 adapter
rake spec:postgresql        # run specs with postgresql adapter
rake spec:sqlite3           # run specs with sqlite3 adapter

Rails 3

Gemfile:

gem "fast_seeder", "0.0.2"

Credits

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this program. If not, see http://www.gnu.org/licenses/lgpl.txt

Something went wrong with that request. Please try again.