Contents

# Versioned Seeds [![Build Status](https://secure.travis-ci.org/[YOUR_GITHUB_USERNAME]/[YOUR_PROJECT_NAME].png)](http://travis-ci.org/[YOUR_GITHUB_USERNAME]/[YOUR_PROJECT_NAME])

Versioned Seeds is an alternative to Rails seeds. It allows to store your seeds in several files and prevent from re-seeding.

Rails seeds are great when you create a project but what about new ones when the project is already running ? When you have to import some data from a CSV file ?

Versioned Seeds provides a simple, conventions based, way to do that.

## Installation

Add this line to your `Gemfile` :

    gem 'versioned_seeds', :require => false

If you're using Git, as you should, be sure to call this in your shell :

    $ echo ".versionned_seeds" >> .gitignore

## Usage

### Get current version

You can get the last imported seeds version :

    $ rake vs:status
    Last seeds: 0

### Generate a seeding script

The generator will simply generate a timestamped file where you can put anything you want :

    $ rails g versioned_seeds:seed_file some_seeding_script
          create  db/seeds/20111205155806_some_seeding_script.rb

### Loading the scripts

Given two seeds files :

``` ruby
# db/seeds/20111205155801_create_users.rb
User.create!(:username => 'admin', :password => 'password', :admin => true)
User.create!(:username => 'user1', :password => 'password')

# db/seeds/20111205155802_import_articles.rb
require 'csv'

CSV.foreach('/some/file.csv') do |line|
  # ...
end
```

You can import only the first one by using the `vs:next` task :

    $ rake vs:next
    Loading: 20111205155801_create_users.rb

    $ rake vs:status
    Last seeds: 20111205155801

Or load all files using the `vs:all` task :

    $ rake vs:all
    Loading: 20111205155801_create_users.rb
    Loading: 20111205155802_import_articles.rb
    
    $ rake vs:status
    Last seeds: 20111205155802

Every script imported once will never be loaded again.

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
versioned_seeds-0.2.0	README.mdown