bootstrapper 0.3.0

data/README.markdown

@@ -0,0 +1,105 @@
+Bootstrapper
+============
+
+  A rather simple gem that executes a block to load seed/bootstrap data
+  into a database.
+
+
+Example
+=======
+
+    gem install bootstrapper
+
+  Run the bootstrapper generator:
+
+  Rails 3:
+
+    ./script/rails g bootstrapper
+
+  Rails 2:
+
+    ruby script/generate bootstrapper
+
+
+  This will place a bootstrap.rb file in the db directory within your project.
+
+  The file will have something like this in it:
+
+    Bootstrapper.for :development do |b|
+    end
+
+    Bootstrapper.for :production do |b|
+    end
+
+    Bootstrapper.for :test do |b|
+    end
+
+    Bootstrapper.for :staging do |b|
+    end
+
+  Using things like Factory Girl and Forgery you can quickly and easily
+  generate fake, random, and/or seed data.
+
+  An example using Factory Girl:
+
+    Bootstrapper.for :development do |b|
+      b.truncate_tables :addresses
+      b.run :users
+
+      Factory(:us_address, :state => "ME")
+      Factory(:us_address, :state => "IL")
+      Factory(:us_address, :state => "CA")
+    end
+
+    Bootstrapper.for :production do |b|
+    end
+
+    Bootstrapper.for :test do |b|
+    end
+
+    Bootstrapper.for :staging do |b|
+    end
+
+    Bootstrapper.for :users do |b|
+      3.times{ Factory(:user) }
+      Factory(:user, :login => "admin",
+                     :password => "sekret",
+                     :password_confirmation => "sekret")
+    end
+
+  With that file, you could run:
+
+    rake db:bootstrap
+
+  Which will run the development (default) bootstrap.  You can specify which
+  bootstrap task to run by specifying:
+
+    rake db:bootstrap BOOTSTRAP=users
+
+  You can also run bootstrap for another environment:
+
+    rake db:bootstrap RAILS_ENV=production
+
+  You can even run a specific bootstrap for another environment:
+
+    rake db:bootstrap BOOTSTRAP=users RAILS_ENV=production
+
+  The variable passed into a Bootstrapper block is actually Bootstrapper
+  itself, so you can use any methods it has.
+
+  You can delete all records from tables using 'truncate_tables':
+
+    b.truncate_tables :users
+    b.truncate_tables :users, :addresses
+
+  You can run other bootstrap tasks using 'run':
+
+    b.run :users
+    b.run :production
+
+FactoryGirl [http://github.com/thoughtbot/factory_girl/tree/master](http://github.com/thoughtbot/factory_girl/tree/master)
+
+Forgery [http://github.com/sevenwire/forgery/tree/master](http://github.com/sevenwire/forgery/tree/master)
+
+Copyright (c) 2008 Sevenwire, released under the MIT license
+Contributions from Jared Mehle (jrmehle), Joel Meador (janxious), Jan Schwenzien (jeanmartin), Ken Pratt (kenpratt)

data/lib/bootstrapper.rb

@@ -0,0 +1,3 @@
+if defined?(Rails) && Rails.version.to_f >= 3.0
+  require 'bootstrapper/railtie'
+end

data/lib/bootstrapper/bootstrapper.rb

@@ -0,0 +1,64 @@
+class Bootstrapper
+  class_inheritable_accessor :tasks
+  write_inheritable_attribute :tasks, ActiveSupport::HashWithIndifferentAccess.new
+
+  def self.for(key, &block)
+    tasks[key] = block
+  end
+
+  @depth = 0
+
+  def self.run_start(key)
+    print "\033[1;31;40mBootstrapping\e[0m >>" if @depth == 0
+    print " [\033[1;33;40m:#{key}\e[0m"
+    @depth += 1
+  end
+
+  def self.run_end(key)
+    @depth -= 1
+    print "]"
+    puts "\r\n\033[1;31;40mBootstrapping\e[0m >> \033[1;32;40mDone\e[0m" if @depth == 0
+  end
+
+  def self.run(key)
+    self.run_start(key)
+    tasks[key].call(self)
+    self.run_end(key)
+  end
+
+  def self.truncate_tables(*tables)
+    options = tables.last.is_a?(Hash) ? tables.pop : {}
+    if tables == [:all]
+      except = options[:except] || []
+      except = except.is_a?(Array) ? except.collect { |x| x.to_s } : [except.to_s]
+
+      tables = ActiveRecord::Base.connection.tables.select do |table|
+        table !~ /schema_(info|migrations)/ && !except.include?(table)
+      end
+    end
+
+    tables.each do |table|
+      self.truncate_table(table)
+    end
+  end
+
+  def self.truncate_table(table_name)
+    conn = ActiveRecord::Base.connection
+    sql = case conn.adapter_name.downcase
+          when /mysql/
+            "TRUNCATE TABLE #{conn.quote_table_name(table_name)};"
+          else
+            "DELETE FROM #{table_name}"
+          end
+    conn.execute(sql)
+  end
+
+  def self.fixtures(*fixtures)
+    Fixtures.create_fixtures(File.join(Rails.root, 'db', 'populate'), fixtures)
+
+  end
+
+  def self.sql(sql)
+    ActiveRecord::Base.connection.execute(sql)
+  end
+end

data/lib/bootstrapper/railtie.rb

@@ -0,0 +1,18 @@
+class Bootstrapper
+  class Railtie < Rails::Railtie
+    config.bootstrapper = ActiveSupport::OrderedOptions.new
+
+    # configure our plugin on boot. other extension points such
+    # as configuration, rake tasks, etc, are also available
+    initializer "bootstrapper.initialize" do |app|
+    end
+
+    ActiveSupport.on_load :active_record do
+      require 'bootstrapper/bootstrapper'
+    end
+
+    rake_tasks do
+      load "tasks/bootstrap.rake"
+    end
+  end
+end

data/lib/generators/bootstrapper_generator.rb

@@ -0,0 +1,11 @@
+require 'rails/generators'
+ 
+class BootstrapperGenerator < Rails::Generators::Base
+  def self.source_root
+    @source_root ||= File.join(File.dirname(__FILE__), 'templates')
+  end
+
+  def copy_files
+    template 'bootstrap.erb', 'db/bootstrap.rb'
+  end
+end

data/lib/generators/templates/bootstrap.erb

@@ -0,0 +1,5 @@
+<%- ActiveRecord::Base.configurations.keys.each do |env| -%>
+Bootstrapper.for :<%= env %> do |b|
+end
+
+<%- end -%>

data/lib/tasks/bootstrap.rake

@@ -0,0 +1,29 @@
+namespace :db do
+  desc "Bootstraps the database for the given environment. BOOTSTRAP option lets you run a specific bootstrap task in the given environment."
+  task :bootstrap => :environment do
+    require 'active_record/base'
+    require File.join(Rails.root, 'db', 'bootstrap')
+    Bootstrapper.run(ENV['BOOTSTRAP'] || Rails.env)
+  end
+
+  namespace :bootstrap do
+    desc "Resets the database and bootstraps it for the given environment. BOOTSTRAP option lets you run a specific bootstrap task in the given environment."
+    task :reset => ['db:migrate:reset', 'reset_environment'] do
+      Rake::Task['db:bootstrap'].invoke
+    end
+  end
+end
+
+desc "Resets the rails environment"
+task :reset_environment do
+  # Ripped directly out of railties/lib/console_app.rb in rails and
+  # only changed slightly.
+  puts "Reloading environment..."
+  if ActionController::Dispatcher.respond_to?(:cleanup_application)
+    dispatcher = ActionController::Dispatcher
+  else
+    dispatcher = ActionController::Dispatcher.new($stdout)
+  end
+  dispatcher.cleanup_application
+  dispatcher.reload_application
+end

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification 
+name: bootstrapper
+version: !ruby/object:Gem::Version 
+  hash: 19
+  prerelease: 
+  segments: 
+  - 0
+  - 3
+  - 0
+  version: 0.3.0
+platform: ruby
+authors: 
+- Jared Mehle
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-03 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 3
+        - 0
+        version: 2.3.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 3
+        - 0
+        version: 2.3.0
+  type: :runtime
+  version_requirements: *id002
+description: 
+email: jrmehle@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- lib/bootstrapper.rb
+- lib/bootstrapper/bootstrapper.rb
+- lib/bootstrapper/railtie.rb
+- lib/generators/bootstrapper_generator.rb
+- lib/generators/templates/bootstrap.erb
+- lib/tasks/bootstrap.rake
+- README.markdown
+homepage: http://github.com/jrmehle/bootstrapper
+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: 
+rubygems_version: 1.8.1
+signing_key: 
+specification_version: 3
+summary: The better way to load seed data (than seeds.rb)
+test_files: []
+