parlement 0.3 → 0.4

data/vendor/plugins/engines/generators/engine/engine_generator.rb

@@ -0,0 +1,199 @@
+#  Copyright (c) 2005 Jonathan Lim <snowblink@gmail.com>
+#  
+#  The MIT License
+#  
+#  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.
+
+
+module Rails
+  module Generator
+    module Commands
+
+      class Create < Base
+        def complex_template(relative_source, relative_destination, template_options = {})
+          options = template_options.dup
+          options[:assigns] ||= {}
+          options[:assigns]['template_for_inclusion'] = render_template_part(template_options) if template_options[:mark_id]
+          options[:assigns]['license'] = render_license(template_options)
+          template(relative_source, relative_destination, options)
+        end
+
+        def render_license(template_options)
+          # Getting Sandbox to evaluate part template in it
+          part_binding = template_options[:sandbox].call.sandbox_binding
+          part_rel_path = template_options[:insert]
+          part_path = source_path(part_rel_path)
+
+          # Render inner template within Sandbox binding
+          template_file = File.readlines(part_path)
+          case template_options[:comment_style]
+          when :rb
+            template_file.map! {|x| x.sub(/^/, '#  ')}
+          end
+          rendered_part = ERB.new(template_file.join, nil, '-').result(part_binding)
+        end
+
+      end
+    end
+  end
+end
+
+
+class LicensingSandbox
+  include ActionView::Helpers::ActiveRecordHelper
+  attr_accessor :author
+
+  def sandbox_binding
+    binding
+  end
+
+end
+
+class Author
+  def initialize
+    set_name
+    set_email
+  end
+
+  def set_name
+    print "Please enter the author's name: "
+    @name = gets.chomp
+  end
+
+  def set_email
+    print "Please enter the author's email: "
+    @email = gets.chomp
+  end
+
+  def to_s
+    "#{@name} <#{@email}>"
+  end
+end
+
+class License
+  def initialize(source_root)
+    @source_root = source_root
+    select_license
+  end
+
+  def select_license
+    # list all the licenses in the licenses directory
+    licenses = Dir.entries(File.join(@source_root, 'licenses')).select { |name| name !~ /^\./ }
+    puts "We can generate the following licenses automatically for you:"
+    licenses.sort.each_with_index do |license, index|
+      puts "#{index}) #{licenses[index]}"
+    end
+    print "Please select a license: "
+    while choice = gets.chomp
+      if (choice !~ /^[0-9]+$/)
+        print "Hint - you want to be typing a number.\nPlease select a license: "
+        next
+      end
+      break if choice.to_i >=0 && choice.to_i <= licenses.length
+    end
+      
+    @license = licenses[choice.to_i]
+    puts "'#{@license}' selected"
+  end
+
+  def to_s
+    File.join('licenses', @license)
+  end
+
+end
+
+class EngineGenerator < Rails::Generator::NamedBase
+
+  attr_reader :engine_class_name, :engine_underscored_name, :engine_start_name, :author
+
+
+  def initialize(runtime_args, runtime_options = {})
+    super
+    @engine_class_name = runtime_args.shift
+    
+    # ensure that they've given us a valid class name
+    if @engine_class_name =~ /^[a-z]/
+      raise "'#{@engine_class_name}' should be a valid Ruby constant, e.g. 'MyEngine'; aborting generation..." 
+    end
+    
+    @engine_underscored_name = @engine_class_name.underscore
+    @engine_start_name = @engine_underscored_name.sub(/_engine$/, '')
+    @author = Author.new
+    @license = License.new(source_root)
+  end
+
+  def manifest
+    record do |m|
+      m.directory File.join('vendor', 'plugins')
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name)
+      m.complex_template 'README',
+        File.join('vendor', 'plugins', @engine_underscored_name, 'README'),
+        :sandbox => lambda {create_sandbox},
+        :insert => @license.to_s
+
+      m.file 'install.erb', File.join('vendor', 'plugins', @engine_underscored_name, 'install.rb')
+      
+      m.complex_template 'init_engine.erb',
+        File.join('vendor', 'plugins', @engine_underscored_name, 'init_engine.rb'),
+        :sandbox => lambda {create_sandbox},
+        :insert => @license.to_s,
+        :comment_style => :rb
+
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'app')
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'app', 'models')
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'app', 'controllers')
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'app', 'helpers')
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'app', 'views')
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'db')
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'db', 'migrate')
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'lib')
+      m.complex_template File.join('lib', 'engine.erb'),
+        File.join('vendor', 'plugins', @engine_underscored_name, 'lib', "#{@engine_underscored_name}.rb"),
+        :sandbox => lambda {create_sandbox},
+        :insert => @license.to_s,
+        :comment_style => :rb
+
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'lib', @engine_underscored_name)
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'public')
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'public', 'javascripts')
+      m.template File.join('public', 'javascripts', 'engine.js'), File.join('vendor', 'plugins', @engine_underscored_name, 'public', 'javascripts', "#{@engine_underscored_name}.js")
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'public', 'stylesheets')
+      m.template File.join('public', 'stylesheets', 'engine.css'), File.join('vendor', 'plugins', @engine_underscored_name, 'public', 'stylesheets', "#{@engine_underscored_name}.css")
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'tasks')
+      m.template File.join('tasks', 'engine.rake'), File.join('vendor', 'plugins', @engine_underscored_name, 'tasks', "#{@engine_underscored_name}.rake")
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'test')
+      m.template File.join('test', 'test_helper.erb'), File.join('vendor', 'plugins', @engine_underscored_name, 'test', 'test_helper.rb')
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'test', 'fixtures')
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'test', 'functional')
+      m.directory File.join('vendor', 'plugins', @engine_underscored_name, 'test', 'unit')      
+    end
+  end
+
+protected
+  def banner
+    "Usage: #{$0} #{spec.name} MyEngine [general options]"
+  end
+
+  def create_sandbox
+    sandbox = LicensingSandbox.new
+    sandbox.author = @author
+    sandbox
+  end
+
+end

data/vendor/plugins/engines/generators/engine/templates/README

@@ -0,0 +1,85 @@
+------------------[ once you've read this, delete it ]---------------------
+
+ENGINE DEVELOPERS - HEED THIS!
+
+This is a sample README file to guide your users when they are installing what is undoubtedly going to be the finest piece of code they ever got their hands on. Lucky them, but alas they are often foolish, and so this is where you can guide them with the metaphorical beating of twigs. Or just a numbered series of instructions.
+
+ANYWAY - you will almost certainly need to tailor this to your specific engine. For instance, your users will probably only need to include modules into the ApplicationController and ApplicationHelper if your engine defines methods to be usable by controllers and views external to your engine.
+
+If you engine does not rely on any database tables, you will probably not need migrations either.
+
+You are also under no obligation to use the 'config' method for setting options within your modules. Documentation which explains the purpose of the 'config' method is available as part of the Engines plugin itself.
+
+Please check the engine development information on the Rails Engines wiki for more information about what to do now:
+  
+  http://rails-engines.rubyforge.org/wiki/wiki.pl?DevelopingAnEngine
+
+-----------------------[ remember to delete me! ]--------------------------
+
+= <%= engine_class_name %>
+
+<%= engine_class_name %> is a ...
+
+This software package is developed using the Engines plugin. To find out more about how to use engines in general, go to http://rails-engines.rubyforge.org for general documentation about the Engines mechanism.
+
+== Installation
+
+1. Create your Rails application, set up your databases, grab the Engines plugin and the <%= engine_class_name %>, and install them.
+
+2. Install the <%= engine_class_name %> into your vendor/plugins directory
+
+3. Modify your Engines.start call in config/environment.rb
+
+    Engines.start :<%= engine_start_name %> # or :<%= engine_underscored_name %>
+
+4. Edit your application.rb file so it looks something like the following:
+
+    class ApplicationController < ActionController::Base
+      include <%= engine_class_name %>
+    end
+
+5. Edit your application_helper.rb file:
+
+    module ApplicationHelper
+      include <%= engine_class_name %>
+    end
+
+6. Perform any configuration you might need. You'll probably want to set these values in environment.rb (before the call to Engines.start):
+
+    module <%= engine_class_name %>
+      config :some_option, "some_value"
+    end
+
+7. Initialize the database tables. You can either use the engine migrations by calling:
+
+    rake engine_migrate
+
+  to move all engines to their latest versions, or
+
+    rake engine_migrate ENGINE=<%= engine_start_name %>
+
+  to migrate only this engine.
+
+8. The <%= engine_class_name %> provides a default stylesheet and a small javascript helper file, so you'll probably want to include the former and almost certainly the latter in your application's layout. Add the following lines:
+
+      <%%= engine_stylesheet "<%=engine_start_name%>_engine" %>
+      <%%= engine_javascript "<%=engine_start_name%>_engine" %>
+
+== Configuration
+
+A number of configuration parameters are available to allow to you control
+how the data is stored, should you be unhappy with the defaults. These are
+outlined below. 
+
+  module <%= engine_class_name %>
+    config :some_option, "some_value"
+  end
+
+=== Configuration Options
++some_option+:: This option will set some_value 
+
+== Usage
+How to use this engine
+
+== License
+<%= license %>

data/vendor/plugins/engines/generators/engine/templates/init_engine.erb

@@ -0,0 +1,13 @@
+<%= license %>
+
+module <%= engine_class_name %>::VERSION
+  Major = 0 # change implies compatibility breaking with previous versions
+  Minor = 1 # change implies backwards-compatible change to API
+  Release = 0 # incremented with bug-fixes, updates, etc.
+end
+
+Engines.current.version = <%= engine_class_name %>::VERSION
+
+# load up all the required files we need...
+require '<%= engine_underscored_name %>'
+

data/vendor/plugins/engines/generators/engine/templates/install.erb

@@ -0,0 +1,4 @@
+# Install the engines plugin if it has been already
+unless File.exist?(File.dirname(__FILE__) + "/../engines")
+  Commands::Plugin.parse!(['install', 'http://svn.rails-engines.org/plugins/engines']) 
+end

data/vendor/plugins/engines/generators/engine/templates/lib/engine.erb

@@ -0,0 +1,6 @@
+<%= license %>
+
+#require '<%= engine_underscored_name %>/additional_files'
+
+module <%= engine_class_name %>
+end

data/vendor/plugins/engines/generators/engine/templates/licenses/GPL

@@ -0,0 +1,18 @@
+Copyright (c) <%= Time.now.strftime("%Y") %> <%= author %>
+
+The GNU General Public License (GPL)
+Version 2, June 1991
+
+This program is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 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 General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

data/vendor/plugins/engines/generators/engine/templates/licenses/LGPL

@@ -0,0 +1,19 @@
+Copyright (c) <%= Time.now.strftime("%Y") %> <%= author %>
+
+GNU Lesser General Public License
+Version 2.1, February 1999
+
+This library 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 2.1 of the License, or (at your option) any later version.
+
+This library 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 library; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
+

data/vendor/plugins/engines/generators/engine/templates/licenses/MIT

@@ -0,0 +1,22 @@
+Copyright (c) <%= Time.now.strftime("%Y") %> <%= author %>
+
+The MIT License
+
+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/vendor/plugins/engines/generators/engine/templates/licenses/None

@@ -0,0 +1 @@
+Copyright (c) <%= Time.now.strftime("%Y") %> <%= author %>

data/vendor/plugins/engines/generators/engine/templates/test/test_helper.erb

@@ -0,0 +1,13 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../../../test/test_helper') # the default rails helper
+
+# ensure that the Engines testing enhancements are loaded.
+require File.join(Engines.config(:root), "engines", "lib", "engines", "testing_extensions")
+
+# force these config values
+module <%= engine_class_name %>
+#  config :some_option, "some_value"
+end
+
+# set up the fixtures location
+Test::Unit::TestCase.fixture_path = File.dirname(__FILE__)  + "/fixtures/"
+$LOAD_PATH.unshift(Test::Unit::TestCase.fixture_path)

data/vendor/plugins/engines/init.rb

@@ -1,5 +1,5 @@
 #--
-# Copyright (c) 2005 James Adam
+# Copyright (c) 2006 James Adam
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the
@@ -19,15 +19,30 @@
 # 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.
+#
+#
+#
+# = IN OTHER WORDS:
+#
+# You are free to use this software as you please, but if it breaks you'd
+# come a'cryin...
 #++
 
 
 require 'engines'
+require 'bundles'
+
+module ::Engines::Version
+  Major = 1 # change implies compatibility breaking with previous versions
+  Minor = 1 # change implies backwards-compatible change to API
+  Release = 1 # incremented with bug-fixes, updates, etc.
+end
 
 #--
 # Create the Engines directory if it isn't present
 #++
 if !File.exist?(Engines.config(:root))
-  RAILS_DEFAULT_LOGGER.debug "Creating engines directory in /vendor"
+  Engines.log.debug "Creating engines directory in /vendor"
   FileUtils.mkdir_p(Engines.config(:root))
-end
+end
+

data/vendor/plugins/engines/lib/bundles/require_resource.rb

@@ -0,0 +1,124 @@
+# RequireResource v.1.4 by Duane Johnson
+#
+# Makes inclusion of javascript and stylesheet resources easier via automatic or explicit
+# calls.  e.g. require_javascript 'popup' is an explicit call.
+#
+# The simplest way to make use of this functionality is to add
+#   <%= resource_tags %>
+# to your layout (usually in the <head></head> section).  This will automatically add
+# bundle support to your application, as well as enable simple javascript and stylesheet
+# dependencies for your views.
+#
+# Note that this can easily be turned in to a helper on its own.
+module RequireResource
+  mattr_accessor :path_prefix
+
+  # Write out all javascripts & stylesheets, including default javascripts (unless :defaults => false)
+  def resource_tags(options = {})
+    options = {:auto => true, :defaults => true}.update(options)
+    require_defaults if options[:defaults]
+    stylesheet_auto_link_tags(:auto => options[:auto]) +
+    javascript_auto_include_tags(:auto => options[:auto])
+  end
+  
+  # Write out the <link> tags themselves based on the array of stylesheets to be included
+  def stylesheet_auto_link_tags(options = {})
+    options = {:auto => true}.update(options)
+    ensure_resource_is_initialized(:stylesheet)
+    autorequire(:stylesheet) if options[:auto]
+    @stylesheets.uniq.inject("") do |buffer, css|
+      buffer << stylesheet_link_tag(css) + "\n    "
+    end
+  end
+
+  # Write out the <script> tags themselves based on the array of javascripts to be included
+  def javascript_auto_include_tags(options = {})
+    options = {:auto => true}.update(options)
+    ensure_resource_is_initialized(:javascript)
+    autorequire(:javascript) if options[:auto]
+    @javascripts.uniq.inject("") do |buffer, js|
+      buffer << javascript_include_tag(js) + "\n    "
+    end
+  end
+
+  # Bundle the defaults together for easy inclusion
+  def require_defaults
+    require_javascript(:prototype)
+    require_javascript(:controls)
+    require_javascript(:effects)
+    require_javascript(:dragdrop)
+  end
+  
+  # Adds a javascript to the array of javascripts that will be included in the layout by
+  # either your call to 'javascript_auto_include_tags' or 'resource_tags'.
+  def require_javascript(*scripts)
+    scripts.each do |script|
+      require_resource(:javascript, RequireResource.path_prefix.to_s + script.to_s)
+    end
+  end
+
+  # Adds a stylesheet to the array of stylesheets that will be included in the layout by
+  # either your call to 'stylesheet_auto_link_tags' or 'resource_tags'.
+  def require_stylesheet(*sheets)
+    sheets.each do |sheet|
+      require_resource(:stylesheet, RequireResource.path_prefix.to_s + sheet.to_s)
+    end
+  end
+  
+  # Changes the RequireResource.path_prefix within the scope of a block.  This is
+  # particularly useful when requiring several resources within a directory.  For example,
+  # bundles can take advantage of this by calling
+  #   require_relative_to Engines.current.public_dir do
+  #     require_javascript '...'
+  #     require_stylesheet '...'
+  #     # ...
+  #   end
+  def require_relative_to(path)
+    former_prefix = RequireResource.path_prefix
+    RequireResource.path_prefix = path
+    yield
+    RequireResource.path_prefix = former_prefix
+  end
+  
+  protected
+    # Adds resources such as stylesheet or javascript files to the corresponding array of
+    # resources that will be 'required' by the layout. The +resource_type+ is either
+    # :javascript or :stylesheet. The +extension+ is optional, and should normally correspond
+    # with the resource type, e.g. 'css' for :stylesheet and 'js' for :javascript.
+    def autorequire(resource_type, extension = nil)
+      extensions = {:stylesheet => 'css', :javascript => 'js'}
+      extension ||= extensions[resource_type]
+      candidates = []
+      class_iterator = controller.class
+      resource_path = "#{RAILS_ROOT}/public/#{resource_type.to_s.pluralize}/" 
+
+      while ![ActionController::Base].include? class_iterator
+        controller_path = class_iterator.to_s.underscore.sub('controllers/', '').sub('_controller', '')
+        candidates |= [ "#{controller_path}", "#{controller_path}/#{controller.action_name}" ]
+        class_iterator = class_iterator.superclass
+      end
+      
+      for candidate in candidates
+        if FileTest.exist?("#{resource_path}/#{candidate}.#{extension}")
+          require_resource(resource_type, candidate)
+        end
+      end
+    end
+
+    # Adds a resource (e.g. a javascript) to the appropriate array (e.g. @javascripts)
+    # ONLY if the resource is not already included.
+    def require_resource(type, name)
+      variable = type.to_s.pluralize
+      new_resource_array = (instance_variable_get("@#{variable}") || []) | [name.to_s]
+      instance_variable_set("@#{variable}", new_resource_array)
+    end
+
+    # Ensures that a resource array (e.g. @javascripts) is not nil--uses [] if so
+    def ensure_resource_is_initialized(type)
+      variable = type.to_s.pluralize
+      new_resource_array = (instance_variable_get("@#{variable}") || [])
+      instance_variable_set("@#{variable}", new_resource_array)      
+    end
+end
+
+ActionView::Base.send(:include, RequireResource)

data/vendor/plugins/engines/lib/bundles.rb

@@ -0,0 +1,77 @@
+require 'bundles/require_resource'
+
+# The 'require_bundle' method is used in views to declare that certain stylesheets and javascripts should
+# be included by the 'resource_tags' (used in the layout) for the view to function properly.
+module Bundles
+  def require_bundle(name, *args)
+    method = "bundle_#{name}"
+    send(method, *args)
+  end
+  
+  def require_bundles(*names)
+    names.each { |name| require_bundle(name) }
+  end
+end
+
+ActionView::Base.send(:include, Bundles)
+
+# Registers a module within the Bundles module by renaming the module's 'bundle' method (so it doesn't
+# clash with other methods named 'bundle') and by including any Controller or Helper modules within
+# their respective Rails base classes.
+#
+# For example, if you have a module such as
+#   module Bundles::Calendar; end
+#
+# then within that Calendar module there *must* be a method named "bundle" which groups the
+# bundle's resources together.  Example:
+#   module Bundles::Calendar
+#     def bundle
+#       require_relative_to Engines.current.public_dir do
+#         require_stylesheet "/stylesheets/calendar.css"
+#         require_javascript "/javascripts/calendar.js"
+#       end
+#     end
+#   end
+#
+# You may optionally define a Controller or Helper sub-module if you need any methods available to
+# the applications controllers or views.  Example:
+#
+#   module Bundles::Calendar
+#     module Helper
+#       def calendar_date_select(*args
+#         # ... output some HTML
+#       end
+#     end
+#   end
+#
+# The calendar_date_select method will now be available within the scope of the app's views because the
+# register_bundle method will inject the Helper module's methods in to ActionView::Base for you.
+#
+# Similarly, you can make methods available to controllers by adding a Controller module.
+def register_bundle(name)
+  require "bundles/#{name}"
+  
+  # Rename the generic 'bundle' method in to something that doesn't conflict with
+  # the other module method names.
+  bundle_module = Bundles.const_get(name.to_s.camelize)
+  bundle_module.module_eval "alias bundle_#{name} bundle"
+  bundle_module.send :undef_method, :bundle
+
+  # Then include the bundle module in to the base module, so that the methods will
+  # be available inside ActionView::Base
+  ActionView::Base.send(:include, bundle_module)
+
+  # Check for optional Controller module
+  if bundle_module.const_defined? 'Controller'
+    controller_addon = bundle_module.const_get('Controller')
+    RAILS_DEFAULT_LOGGER.debug "Including #{name} bundle's Controller module"
+    ActionController::Base.send(:include, controller_addon)
+  end
+
+  # Check for optional Helper module
+  if bundle_module.const_defined? 'Helper'
+    helper_addon = bundle_module.const_get('Helper')
+    RAILS_DEFAULT_LOGGER.debug "Including #{name} bundle's Helper module"
+    ActionView::Base.send(:include, helper_addon)
+  end
+end