rails3_plugin_toolbox 0.1.0 → 0.2.0

data/README.markdown

@@ -2,9 +2,12 @@
 
 A toolbox to facilitate creating Plugins for Rails 3 without having to necessarily know a lot about the Rails 3 internals and Plugin architecture.   
 
-## Status
+## RSpec test suite
 
-This gem needs to be tested. I 'hope' it works as is... I will soon make sure of it and add an RSpec 2 test suite ;)
+I have now discovered how to test he validity of Rails extensions in RSpec without having to have a full Rails 3 host app.
+RSpec 2 test suite will soon be added :)
+
+http://gist.github.com/542441
 
 ## Inspiration
 
@@ -19,47 +22,58 @@ This project was inspired by the Yehuda Katz article at http://www.railsdispatch
 <pre>
 # my_plugin/lib/load.rb
 module MyPlugin
-  include Rails::Plugin::Toolbox::Extender
-
-  # do some actions after Application has been initialized using registered initializers
-  after(:initialize) do
-    include MyViewModule
-  end
-
-  # extend action_view with methods from some modules
-  extend_rails(:view) do
-    with UltraFix
-    with PowerTools    
-  end  
+  Rails3::PluginExtender.new do
+  
+    extend_from_module Ultra::View, :stuff, :in => :view 
+    extend_with Ultra::Controller, :in => :controller
+  
+    extend_rails :i18n do
+      with MyAddition
+      extend_from_module Ultra::Power, :util, :logging, :monitor
+
+      before :initialize do
+        MyOtherAddition.say 'before localized!'
+      end      
+
+      before :configuration do
+        MyOtherAddition.configured = 'was configured!'      
+      end
+
+      before :eager_load do
+        puts "before eager load!"
+      end
+
+      after :initialize do
+        MyAddition.say 'localized!'
+      end      
+    end
 
-  extend_rails(:controller) do
-    extend_from_module Ultra::Power, :util, :logging, :monitor
-    extend_from_module Ultra::Power::More, :extra, :stuff
-  end  
-end  
-</pre>
+    extend_rails :view do
+      with MyViewAddition
+    end
 
-The following are some general tips for adding custom rake tasks and generators to your Rails 3 plugin.
+    extend_rails :controller do
+      with MyViewAddition
+    end
 
-## Custom rake tasks
+    extend_rails :mailer do
+      with MyMailAddition, 'MyOtherMailAddition'
+    end
 
-<pre>
-# my_plugin/lib/railtie.rb
-module MyPlugin
-  class Railtie < ::Rails::Railtie
-    rake_tasks do
-      load "my_plugin/railties/tasks.rake"    
+    extend_rails :AR do
+      with MyActiveRecordAddition
     end
-  end    
-end
-</pre>
 
-<pre>
-# my_plugin/lib/railties/tasks.rake
-desc "Talk about being in my_gem"
-task :my_gem do
-  puts "You're in my_gem"
-end     
+    extend_rails(:controller) do
+      extend_from_module Ultra::Power, :util, :logging, :monitor
+      extend_from_module Ultra::Power::More, :extra, :stuff
+    end  
+    
+    after(:initialize) do
+      include MyCoreModule
+    end    
+  end
+end  
 </pre>
 
 

data/Rakefile

@@ -16,30 +16,3 @@ begin
 rescue LoadError
   puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
 end
-
-# require 'spec/rake/spectask'
-# Spec::Rake::SpecTask.new(:spec) do |spec|
-#   spec.libs << 'lib' << 'spec'
-#   spec.spec_files = FileList['spec/**/*_spec.rb']
-# end
-#
-# Spec::Rake::SpecTask.new(:rcov) do |spec|
-#   spec.libs << 'lib' << 'spec'
-#   spec.pattern = 'spec/**/*_spec.rb'
-#   spec.rcov = true
-# end
-#
-# task :spec => :check_dependencies
-#
-# task :default => :spec
-#
-# require 'rake/rdoctask'
-# Rake::RDocTask.new do |rdoc|
-#   version = File.exist?('VERSION') ? File.read('VERSION') : ""
-#
-#   rdoc.rdoc_dir = 'rdoc'
-#   rdoc.title = "rails3_plugin_toolbox #{version}"
-#   rdoc.rdoc_files.include('README*')
-#   rdoc.rdoc_files.include('lib/**/*.rb')
-# end
-

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.2.0

data/config/database.yml

@@ -0,0 +1,22 @@
+# SQLite version 3.x
+#   gem install sqlite3-ruby (not necessary on OS X Leopard)
+development:
+  adapter: sqlite3
+  database: db/development.sqlite3
+  pool: 5
+  timeout: 5000
+
+# Warning: The database defined as "test" will be erased and
+# re-generated from your development database when you run "rake".
+# Do not set this db to the same as development or production.
+test:
+  adapter: sqlite3
+  database: db/test.sqlite3
+  pool: 5
+  timeout: 5000
+
+production:
+  adapter: sqlite3
+  database: db/production.sqlite3
+  pool: 5
+  timeout: 5000

data/lib/plugin_toolbox/extender.rb

@@ -1,45 +1,65 @@
 require 'plugin_toolbox/util'
 
-module Rails::PluginToolbox
-  class Extender
-    include Rails::PluginToolbox::Util
-    
-    attr_reader :loader
-    
-    def initialize
-      @loader = Loader.new
+module Rails3
+  class PluginExtender
+    include LoadHandler
+     
+    def initialize &block
+      if block
+        block.arity < 1 ? self.instance_eval(&block) : block.call(self)  
+      end      
     end
-    
+
+    # load after: [:initialize, :configuration, :eager_load]
     def extend_rails(type, &block)
-      loader.load_after(type, &block)
-    end
-    
-    def extend! module_name, type
-      do_extend! get_module(module_name), get_type(type.to_sym)
+      on_load(type, &block)
     end
-    
-    def extend_with module_name
-      type = options[:in] || options        
-      extend! module_name, type
-    end
-    alias_method :with, :extend_with
 
+    
     # convenience method to extend with multiple modules all within the same base module
-    def extend_from_module base_name, *module_names
+    def extend_from_module base_name, *module_names, options
+      raise ArgumentError, "You must specify an options Hash as the last argument for #extend_from_module" if !options.kind_of? Hash      
       module_names.each do |name|
-        extend_with "#{base_name.camelize}::#{name.to_s.camelize}".constantize
+        extend_with "#{base_name.camelize}::#{name.to_s.camelize}".constantize, options
+      end
+    end
+
+    def extend_with *module_names, options
+      raise ArgumentError, "You must specify an options Hash as the last argument for #extend_with" if !options.kind_of? Hash      
+      type = options[:in]
+      raise ArgumentError, "You must specify an :in option to indicate which Rails 3 component base class to extend with #{module_names}" if !type
+      module_names.each do |name|      
+        extend! name, type
       end
-      type = options[:in] || options        
-      extend! module_name, type
-    end       
+    end
     
+    module DSL         
+      include Rails3::PluginExtender::LoadHandler      
+      
+      def extend_from_module base_name, *module_names
+        module_names.each do |name|
+          include "#{base_name.camelize}::#{name.to_s.camelize}".constantize
+        end
+      end
+
+      def extend_with *module_names
+        module_names.each do |name|         
+          include name
+        end
+      end
+      alias_method :with, :extend_with
+    end
+
     protected
-    
+
+    def extend! module_name, type
+      do_extend! get_module(module_name), get_load_type(type.to_sym)
+    end
+
     def do_extend! module_name, type
       ActiveSupport.on_load(type) do
         include module_name
       end        
-    end    
-    
+    end
   end
 end

data/lib/plugin_toolbox/loader.rb

@@ -1,31 +1,32 @@
-require_all File.dirname(__FILE__) + '/validator'
+module Rails3
+  class PluginExtender
+    module LoadHandler
+      include Rails3::PluginExtender::Util
 
-module Rails::PluginToolbox
-  class Loader
-    include Rails::PluginToolbox::HookValidator
-        
-    def load_before type, &block
-      raise ArgumentError "#{type} is not a valid before hook" if !valid_before_hook?
-      ActiveSupport.on_load(:"before_#{type}") do |loader|
-        do_loader loader, &block
+      def before type, &block
+        type = type.to_sym
+        raise ArgumentError, "#{type} is not a valid before hook" if !valid_before_hook? type
+        load_handling :"before_#{type}", &block
       end
-    end
 
-    def load_after type, &block
-      type = valid_after_hook? ? type : :"action_#{type}"
-      raise ArgumentError "#{type} is not a valid after hook" if !valid_after_hook? type          
-      ActiveSupport.on_load(type) do |loader|
-        do_loader loader, &block
+      def after type, &block
+        type = type.to_sym
+        raise ArgumentError, "#{type} is not a valid after hook" if !valid_after_hook? type
+        load_handling :"after_#{type}", &block
       end
-    end
-
-    protected
 
-    def do_loader loader, &block
-      loader.extend(Loader)
-      if block
-        block.arity < 1 ? loader.instance_eval(&block) : block.call(loader)  
+      def on_load type, &block    
+        type = get_load_type type
+        raise ArgumentError, "#{type} is not a valid load hook" if !valid_load_hook? type
+        load_handling type, &block
       end
-    end           
+      
+      def load_handling type, &block
+        ActiveSupport.on_load type do
+          extend Rails3::PluginExtender::DSL
+          instance_eval(&block)        
+        end
+      end
+    end
   end
 end

data/lib/plugin_toolbox/util.rb

@@ -1,24 +1,41 @@
-require_all File.dirname(__FILE__) + '/validator'
+module Rails3
+  class PluginExtender
+    module Util    
+      INIT = :initialize    
+      ACTIVE_MODULES = {:AR => :active_record, :view => :action_view, :controller => :action_controller, :mailer => :action_mailer}    
+    
+      def get_load_type type
+         return ACTIVE_MODULES[type] if ACTIVE_MODULES[type]
+         return type if ACTIVE_MODULES.values.include? type                
+         return type if type == :i18n
+         logger.warn "WARNING: The Rails 3 load handler for the component #{type} is not part of the default load process."
+      end
+
+      def get_module module_name
+        case module_name
+        when Constant        
+          module_name
+        when String
+          module_name.to_s.constantize
+        else          
+          raise ArgumentError, "#{module_name} could not be converted into a module constant"        
+        end
+      end
 
-module Rails::PluginToolbox
-  module Util    
-    include Rails::PluginToolbox::TypeValidator
+      protected
     
-    def get_type category
-       return :"action_#{type}" if action_type?(type)
-       return type if valid_type?(type)
-       raise ArgumentError, "The type #{type} was not recognized"
-    end
+      def valid_before_hook? type
+        [INIT, :configuration, :eager_load].include?(type)          
+      end
 
-    def get_module module_name
-      case module_name
-      when Constant        
-        module_name
-      when String
-        module_name.to_s.constantize
-      else          
-        raise ArgumentError, "#{module_name} could not be converted into a loaded module"        
+      def valid_after_hook? type
+        INIT == type
       end
+
+      def valid_load_hook? type
+        @valid_load_hooks ||= [ACTIVE_MODULES.keys, ACTIVE_MODULES.values, :i18n].flatten
+        @valid_load_hooks.include?(type)          
+      end    
     end
   end
 end

data/lib/rails3_plugin_toolbox.rb

@@ -1,6 +1,5 @@
-module Rails
-  module PluginToolbox
-  end
+module Rails3
 end
 
+require 'require_all'
 require_all File.dirname(__FILE__) + '/plugin_toolbox'

data/rails3_plugin_toolbox.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{rails3_plugin_toolbox}
-  s.version = "0.1.0"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Kristian Mandrup"]
-  s.date = %q{2010-08-21}
+  s.date = %q{2010-08-22}
   s.description = %q{Toolbox to facilitate Rails 3 plugin development}
   s.email = %q{kmandrup@gmail.com}
   s.extra_rdoc_files = [
@@ -24,17 +24,20 @@ Gem::Specification.new do |s|
      "README.markdown",
      "Rakefile",
      "VERSION",
+     "config/database.yml",
      "lib/plugin_toolbox/extender.rb",
      "lib/plugin_toolbox/loader.rb",
      "lib/plugin_toolbox/util.rb",
-     "lib/plugin_toolbox/validator/hook_validator.rb",
-     "lib/plugin_toolbox/validator/type_validator.rb",
      "lib/rails3_plugin_toolbox.rb",
+     "log/development.log",
      "rails3_plugin_toolbox.gemspec",
+     "spec/plugin_toolbox/extender_action_spec.rb",
+     "spec/plugin_toolbox/extender_i18n_spec.rb",
      "spec/plugin_toolbox/extender_spec.rb",
-     "spec/plugin_toolbox/loader_spec.rb",
-     "spec/plugin_toolbox/util_spec.rb",
-     "spec/spec_helper.rb"
+     "spec/spec_helper.rb",
+     "wiki/add_rake_tasks.markdown",
+     "wiki/engine.markdown",
+     "wiki/how_to_guide.markdown"
   ]
   s.homepage = %q{http://github.com/kristianmandrup/rails3_plugin_toolbox}
   s.rdoc_options = ["--charset=UTF-8"]
@@ -42,9 +45,9 @@ Gem::Specification.new do |s|
   s.rubygems_version = %q{1.3.7}
   s.summary = %q{Toolbox to facilitate Rails 3 plugin development}
   s.test_files = [
-    "spec/plugin_toolbox/extender_spec.rb",
-     "spec/plugin_toolbox/loader_spec.rb",
-     "spec/plugin_toolbox/util_spec.rb",
+    "spec/plugin_toolbox/extender_action_spec.rb",
+     "spec/plugin_toolbox/extender_i18n_spec.rb",
+     "spec/plugin_toolbox/extender_spec.rb",
      "spec/spec_helper.rb"
   ]
 

data/spec/plugin_toolbox/extender_action_spec.rb

@@ -0,0 +1,61 @@
+require 'spec_helper'
+
+describe Rails3::PluginExtender do
+  describe '#extend_rails' do
+    it "should extend Action View" do
+      extender = Rails3::PluginExtender.new
+      extender.extend_rails :view do
+        with MyAddition
+      
+        after :initialize do
+          MyAddition.say 'view it!'
+        end      
+      end
+    
+      # Initialize the rails application
+      Minimal::Application.initialize!    
+    
+      ActionView::Base.instance_methods.grep(/zzz/).should_not be_empty
+    
+      MyAddition.heard.should == 'view it!'
+    end    
+    
+    it "should extend Action Controller" do
+      Rails3::PluginExtender.new do
+        extend_rails :controller do
+          with MyAddition
+      
+          after :initialize do
+            MyAddition.say 'control it!'
+          end      
+        end
+      end
+    
+      # Initialize the rails application
+      Minimal::Application.initialize!    
+    
+      ActionController::Base.instance_methods.grep(/zzz/).should_not be_empty
+    
+      MyAddition.heard.should == 'control it!'
+    end    
+    
+    it "should extend Action Mailer" do
+      Rails3::PluginExtender.new do
+        extend_rails :mailer do
+          with MyAddition
+      
+          after :initialize do
+            MyAddition.say 'mail me!'
+          end      
+        end
+      end
+    
+      # Initialize the rails application
+      Minimal::Application.initialize!    
+    
+      ActionMailer::Base.instance_methods.grep(/zzz/).should_not be_empty
+    
+      MyAddition.heard.should == 'mail me!'
+    end  
+  end
+end

data/spec/plugin_toolbox/extender_i18n_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+describe Rails3::PluginExtender do
+  describe '#extend_rails' do
+    it "should extend i18n" do
+      Rails3::PluginExtender.new do
+        extend_rails :i18n do
+          with MyAddition
+
+          before :initialize do
+            MyOtherAddition.say 'before localized!'
+          end      
+
+          before :configuration do
+            MyOtherAddition.configured = 'was configured!'      
+          end
+
+          before :eager_load do
+            puts "before eager load!"
+          end
+      
+          after :initialize do
+            MyAddition.say 'localized!'
+          end      
+        end
+      end
+    
+      # Initialize the rails application
+      Minimal::Application.initialize!        
+      I18n.methods.grep(/zzz/).should_not be_empty
+
+      MyAddition.heard.should == 'localized!'
+      MyOtherAddition.heard.should == 'before localized!'
+      MyOtherAddition.configured.should == 'was configured!'      
+    end    
+  end
+end

data/spec/plugin_toolbox/extender_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe Rails3::PluginExtender do
+  describe '#extend_rails' do
+    it "should NOT extend Unknown" do
+      lambda do
+        Rails3::PluginExtender.new
+          extend_rails :unknown do
+            with MyAddition
+          end
+        end     
+      end.should raise_error
+    
+      # Initialize the rails application
+      Minimal::Application.initialize!    
+        
+      MyAddition.heard.should == null
+    end
+    
+    it "should extend Active Record" do
+      Rails3::PluginExtender.new do
+        extend_rails :AR do
+          with MyAddition
+      
+          after :initialize do
+            MyAddition.say 'record me!'
+          end      
+        end
+      end
+    
+      # Initialize the rails application
+      Minimal::Application.initialize!    
+    
+      ActiveRecord::Base.instance_methods.grep(/zzz/).should_not be_empty
+    
+      MyAddition.heard.should == 'record me!'
+    end     
+  end
+end

data/spec/spec_helper.rb

@@ -1,7 +1,51 @@
 require 'rspec'
 require 'rspec/autorun'
+require 'active_support'
+require 'active_record'
+require 'action_controller'
+require 'action_view'
 require 'rails3_plugin_toolbox'
 
+# See http://www.igvita.com/2010/08/04/rails-3-internals-railtie-creating-plugins/
+
+# require 'active_support/railtie'
+require 'rails/all'
+
+module Minimal
+  class Application < Rails::Application
+    config.active_support.deprecation = :log
+  end
+end
+
+module MyAddition
+  def zzz
+    'zzz'
+  end
+
+  class << self
+    attr_accessor :heard
+    
+    def say message
+      @heard = message
+    end
+  end
+end
+
+module MyOtherAddition
+  def yyy
+    'yyy'
+  end
+
+  class << self
+    attr_accessor :heard
+    attr_accessor :configured
+    
+    def say message
+      @heard = message
+    end
+  end
+end
+
+
 RSpec.configure do |config|
-  
 end

data/wiki/add_rake_tasks.markdown

@@ -0,0 +1,22 @@
+The following are some general tips for adding custom rake tasks and generators to your Rails 3 plugin.
+
+## Custom rake tasks
+
+<pre>
+# my_plugin/lib/railtie.rb
+module MyPlugin
+  class Railtie < ::Rails::Railtie
+    rake_tasks do
+      load "my_plugin/railties/tasks.rake"    
+    end
+  end    
+end
+</pre>
+
+<pre>
+# my_plugin/lib/railties/tasks.rake
+desc "Talk about being in my_gem"
+task :my_gem do
+  puts "You're in my_gem"
+end     
+</pre>

data/wiki/engine.markdown

@@ -0,0 +1,52 @@
+Any Rails::Engine is also a Rails::Railtie, so the same methods (like rake_tasks and generators) and configuration available in the latter can also be used in the former. 
+
+<pre>
+  class MyEngine < Rails::Engine
+    # Add a load path for this specific Engine
+    config.autoload_paths << File.expand_path("../lib/some/path", __FILE__)
+
+    initializer "my_engine.add_middleware" do |app|
+      app.middleware.use MyEngine::Middleware
+    end
+  end  
+</pre>
+            
+h2.Paths
+
+Since Rails 3.0, both your Application and Engines do not have hardcoded paths. This means that you are not required to place your controllers at “app/controllers“, but in any place which you find convenient.
+
+For example, let’s suppose you want to lay your controllers at lib/controllers, all you need to do is:
+
+<pre>
+  class MyEngine < Rails::Engine
+    paths.app.controllers = "lib/controllers"
+  end
+  
+</pre>
+
+You can also have your controllers being loaded from both “app/controllers“ and “lib/controllers“:
+
+<pre>
+  class MyEngine < Rails::Engine
+    paths.app.controllers << "lib/controllers"
+  end  
+</pre>  
+
+The available paths in an Engine are:
+
+<pre>
+  class MyEngine < Rails::Engine
+    paths.app                 = "app"
+    paths.app.controllers     = "app/controllers"
+    paths.app.helpers         = "app/helpers"
+    paths.app.models          = "app/models"
+    paths.app.views           = "app/views"
+    paths.lib                 = "lib"
+    paths.lib.tasks           = "lib/tasks"
+    paths.config              = "config"
+    paths.config.initializers = "config/initializers"
+    paths.config.locales      = "config/locales"
+    paths.config.routes       = "config/routes.rb"
+  end
+  
+</pre>

data/wiki/how_to_guide.markdown

@@ -0,0 +1,153 @@
+http://www.igvita.com/2010/08/04/rails-3-internals-railtie-creating-plugins/
+
+The documentation for Railtie  is a great place to get started, but the interesting observation is that each of the major Rails components (Action Mailer/Controller/View/Record) is itself a Railtie, and Rails as you know it is simply pieced together  by requiring all of the independent components. Even better, if your plugin or gem needs to hook into the Rails initialization process, all you need to do is inherit from Railtie and you are ready to go!
+
+So how does Railtie know to call your classes and initializers? Railtie defines a self.inherited method, which is called anytime a subclass of Railtie is created, and stashes a reference to this class in a @subclasses variable. From there, the framework can simply call Railtie.subclasses and perform all the initialization as usual - a clever use of the Ruby object model.
+
+module NewPlugin
+  # namespace our plugin and inherit from Rails::Railtie
+  # to get our plugin into the initialization process
+  class Railtie < Rails::Railtie
+ 
+    # configure our plugin on boot. other extension points such
+    # as configuration, rake tasks, etc, are also available
+    initializer "newplugin.initialize" do |app|
+ 
+      # subscribe to all rails notifications: controllers, AR, etc.
+      ActiveSupport::Notifications.subscribe do |*args|
+        event = ActiveSupport::Notifications::Event.new(*args)
+        puts "Got notification: #{event.inspect}"
+      end
+ 
+    end
+  end
+end
+                             
+---
+
+Railtie is the core of the Rails Framework and provides several hooks to extend Rails and/or modify the initialization process.
+
+Every major component of Rails (Action Mailer, Action Controller, Action View, Active Record and Active Resource) are all Railties, so each of them is responsible to set their own initialization. This makes, for example, Rails absent of any Active Record hook, allowing any other ORM framework to hook in.
+
+Developing a Rails extension does not require any implementation of Railtie, but if you need to interact with the Rails framework during or after boot, then Railtie is what you need to do that interaction.
+
+For example, the following would need you to implement Railtie in your plugin:
+
+* creating initializers
+* configuring a Rails framework or the Application, like setting a generator
+* adding Rails config.* keys to the environment
+* setting up a subscriber to the Rails +ActiveSupport::Notifications+
+* adding rake tasks into rails
+
+h2. Creating your Railtie
+
+Implementing Railtie in your Rails extension is done by creating a class Railtie that has your extension name and making sure that this gets loaded during boot time of the Rails stack.
+
+You can do this however you wish, but here is an example if you want to provide it for a gem that can be used with or without Rails:
+
+* Create a file (say, lib/my_gem/railtie.rb) which contains class Railtie inheriting from Rails::Railtie and is namespaced to your gem:
+                                                                                                                                       
+<pre>
+  # lib/my_gem/railtie.rb
+  module MyGem
+    class Railtie < Rails::Railtie
+    end
+  end  
+</pre>
+
+* Require your own gem as well as rails in this file:
+
+<pre>
+  # lib/my_gem/railtie.rb
+  require 'my_gem'
+  require 'rails'
+
+  module MyGem
+    class Railtie < Rails::Railtie
+    end
+  end  
+</pre>
+
+h2. Initializers
+
+To add an initialization step from your Railtie to Rails boot process, you just need to create an initializer block:
+
+<pre>
+  class MyRailtie < Rails::Railtie
+    initializer "my_railtie.configure_rails_initialization" do
+      # some initialization behavior
+    end
+  end  
+</pre>
+
+If specified, the block can also receive the application object, in case you need to access some application specific configuration, like middleware:
+
+<pre>
+  class MyRailtie < Rails::Railtie
+    initializer "my_railtie.configure_rails_initialization" do |app|
+      app.middleware.use MyRailtie::Middleware
+    end
+  end  
+</pre>
+
+Finally, you can also pass :before and :after as option to initializer, in case you want to couple it with a specific step in the initialization process.
+Configuration
+
+Inside the Railtie class, you can access a config object which contains configuration shared by all railties and the application:
+
+<pre>
+  class MyRailtie < Rails::Railtie
+    # Customize the ORM
+    config.generators.orm :my_railtie_orm
+
+    # Add a to_prepare block which is executed once in production
+    # and before each request in development
+    config.to_prepare do
+      MyRailtie.setup!
+    end
+  end  
+</pre>
+
+Loading rake tasks and generators
+
+If your railtie has rake tasks, you can tell Rails to load them through the method rake tasks:
+
+<pre>
+  class MyRailtie < Railtie
+    rake_tasks do
+      load "path/to/my_railtie.tasks"
+    end
+  end  
+</pre>
+
+By default, Rails load generators from your load path. However, if you want to place your generators at a different location, you can specify in your Railtie a block which will load them during normal generators lookup:
+
+<pre>
+  class MyRailtie < Railtie
+    generators do
+      require "path/to/my_railtie_generator"
+    end
+  end  
+</pre>
+
+Application, Plugin and Engine
+
+A Rails::Engine is nothing more than a Railtie with some initializers already set. And since Rails::Application and Rails::Plugin are engines, the same configuration described here can be used in all three.
+
+Be sure to look at the documentation of those specific classes for more information.
+
+Methods:
+
+    * abstract_railtie?
+    * console
+    * eager_load!
+    * generators
+    * inherited
+    * load_console
+    * load_generators
+    * load_tasks
+    * log_subscriber
+    * railtie_name
+    * rake_tasks
+    * subclasses
+

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 1
+  - 2
   - 0
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Kristian Mandrup
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-08-21 00:00:00 +02:00
+date: 2010-08-22 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -82,17 +82,20 @@ files:
 - README.markdown
 - Rakefile
 - VERSION
+- config/database.yml
 - lib/plugin_toolbox/extender.rb
 - lib/plugin_toolbox/loader.rb
 - lib/plugin_toolbox/util.rb
-- lib/plugin_toolbox/validator/hook_validator.rb
-- lib/plugin_toolbox/validator/type_validator.rb
 - lib/rails3_plugin_toolbox.rb
+- log/development.log
 - rails3_plugin_toolbox.gemspec
+- spec/plugin_toolbox/extender_action_spec.rb
+- spec/plugin_toolbox/extender_i18n_spec.rb
 - spec/plugin_toolbox/extender_spec.rb
-- spec/plugin_toolbox/loader_spec.rb
-- spec/plugin_toolbox/util_spec.rb
 - spec/spec_helper.rb
+- wiki/add_rake_tasks.markdown
+- wiki/engine.markdown
+- wiki/how_to_guide.markdown
 has_rdoc: true
 homepage: http://github.com/kristianmandrup/rails3_plugin_toolbox
 licenses: []
@@ -126,7 +129,7 @@ signing_key:
 specification_version: 3
 summary: Toolbox to facilitate Rails 3 plugin development
 test_files: 
+- spec/plugin_toolbox/extender_action_spec.rb
+- spec/plugin_toolbox/extender_i18n_spec.rb
 - spec/plugin_toolbox/extender_spec.rb
-- spec/plugin_toolbox/loader_spec.rb
-- spec/plugin_toolbox/util_spec.rb
 - spec/spec_helper.rb

data/lib/plugin_toolbox/validator/hook_validator.rb

@@ -1,11 +0,0 @@
-module Rails::PluginToolbox
-  module HookValidator
-    def valid_before_hook?
-      [:initialize, :configuration, :eager_load].include?(type)          
-    end
-
-    def valid_after_hook?
-      [:initialize, :i18n, :active_record, :action_view, :action_controller, :action_mailer].include?(type)          
-    end
-  end
-end

data/lib/plugin_toolbox/validator/type_validator.rb

@@ -1,11 +0,0 @@
-module Rails::PluginToolbox
-  module TypeValidator
-    def valid_type?
-      [:i18n, :active_record].include?(type)       
-    end
-
-    def action_type? type
-      [:controller, :view, :mailer].include?(type)
-    end
-  end
-end