radiant-templates-extension 1.0.0

data/vendor/plugins/make_resourceful/DEFAULTS

@@ -0,0 +1,148 @@
+There's a rough equivalence between a basic @make_resourceful@ call
+and a hand-made controller.
+This:
+
+  class PostsController < ApplicationController
+    make_resourceful { actions :all }
+  end
+
+Creates a controller that works more or less like the one that follows.
+Note that the real code generated by make_resourceful
+is more extensible in various ways.
+Thus whenever possible, there are comments in the following controller
+indicating how to customize various bits of the controller.
+
+  class PostsController < ApplicationController
+    def index
+      # Override #current_objects to change this
+      @posts = Post.find(:all)
+
+      # Use before :index to add something here
+
+      # Use response_for :index to change this
+      respond_to { |f| f.html; f.js }
+    end
+
+    def show
+      # Override #current_object to change this
+      @post = Post.find(params[:id])
+
+      # Use before :show to add something here
+
+      # Use response_for :show to change this
+      respond_to { |f| f.html; f.js }
+    end
+
+    def create
+      # Override #build_object to change this
+      @post = Post.new(params[:post])
+
+      # Use before :create to add something here
+
+      if @post.save
+        # Use after :create to add something here
+
+        # Use response_for :create to change this
+        respond_to do |f|
+          f.html do
+            flash[:notice] = "Create successful!"
+            redirect_to post_path(@post)
+          end
+          f.js
+        end
+      else
+        # Use after :create_fails to add something here
+
+        # Use response_for :create_fails to change this
+        respond_to do |f|
+          format.html
+            flash[:error] = "There was a problem!"
+            render :action => :new, :status => 422
+          end
+          format.js
+        end
+      end
+    end
+
+    def update
+      # Override #current_object to change this
+      @post = Post.find(params[:id])
+
+      # Use before :update to do something here
+
+      if @post.update_attributes params[:post]
+        # Use after :update to add something here
+
+        # Use response_for :update to change this
+        respond_to do |f|
+          f.html do
+            flash[:notice] = "Save successful!"
+            redirect_to post_path(@post)
+          end
+          f.js
+        end
+      else
+        # Use after :update_fails to add something here
+
+        # Use response_for :update_fails to change this
+        respond_to do |f|
+          format.html
+            flash[:error] = "There was a problem saving!"
+            render :action => :edit, :status => 422
+          end
+          format.js
+        end
+      end
+    end
+
+    def new
+      # Override #build_object to change this
+      @post = Post.new(params[:post])
+
+      # Use before :new to add something here
+
+      # Use response_for :new to change this
+      respond_to { |f| f.html; f.js }
+    end
+
+    def edit
+      # Override #current_object to change this
+      @post = Post.find(params[:id])
+
+      # Use before :edit to add something here
+
+      # Use response_for :edit to change this
+      respond_to { |f| f.html; f.js }
+    end
+
+    def destroy
+      # Override #current_object to change this
+      @post = Post.find(params[:id])
+
+      # Use before :destroy to do something here
+
+      if @post.destroy
+        # Use after :destroy to add something here
+
+        # Use response_for :destroy to change this
+        respond_to do |f|
+          f.html do
+            flash[:notice] = "Record deleted!"
+            redirect_to posts_path(@post)
+          end
+          f.js
+        end
+      else
+        # Use after :destroy_fails to add something here
+
+        # Use response_for :destroy_fails to change this
+        respond_to do |f|
+          format.html
+            flash[:error] = "There was a problem deleting!"
+            render :back
+          end
+          format.js
+        end
+      end
+    end
+  end

data/vendor/plugins/make_resourceful/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2007 Hampton Catlin
+
+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/make_resourceful/README

@@ -0,0 +1,239 @@
+= make_resourceful
+===== Take back control of your Controllers. Make them awesome. Make them sleek. Make them resourceful.
+
+REST is a fine pattern for designing controllers,
+but it can be pretty repetitive.
+Who wants to write out the same actions and copy the same model lookup logic
+all over their application?
+
+make_resourceful handles all that for you.
+It sets up all your RESTful actions and responses with next to no code.
+Everything has full, sensible default functionality.
+
+Of course, no controller _only_ uses the defaults.
+So make_resourceful can be massively customized,
+while still keeping your controllers trim and readable.
+
+== Get it!
+ 
+Rails
+
+  $ ruby script/plugin install http://svn.hamptoncatlin.com/make_resourceful/trunk
+  $ mv vendor/plugins/trunk vendor/plugins/make_resourceful
+
+Subversion
+
+  $ svn co http://svn.hamptoncatlin.com/make_resourceful/trunk make_resourceful
+
+== Use it!
+
+The easiest way to start with make_resourceful
+is to run the resource_scaffold generator.
+It uses the same syntax as the Rails scaffold_resource generator:
+
+  $ script/generate resource_scaffold post title:string body:text
+
+It does, however, require Haml[http://haml.hamptoncatlin.com].
+You _are_ using Haml, right? No?
+I'll wait here while you go fall in love with it.
+
+If you want to try make_resourceful on one of your current controllers,
+just replace the mess of repetition with this:
+
+  class FooController < ApplicationController
+    make_resourceful do
+      actions :all
+    end
+  end
+
+Those three lines will replace the entire default controller
+that comes out of the scaffold_resource generator.
+
+=== Really?
+
+Yes.
+
+=== Can I do nested resources?
+
+  make_resourceful do
+    actions :all
+    belongs_to :post
+  end
+
+=== What if I want to use fancy permalinks?
+
+  def current_object
+    @current_object ||= current_model.find_by_permalink(params[:id])
+  end
+
+=== What about paging?
+
+  def current_objects
+    @current_object ||= current_model.find(:all,
+      :order => "created_at DESC", :page => {:current => params[:page], :size => 10 } )
+  end
+
+=== What if I want to do something in the middle of an action?
+
+  before :show, :index do
+    @page_title = "Awesome!"
+  end
+
+  after :create_fails do
+    @page_title = "Not So Awesome!"
+  end
+
+=== What about all of my awesome respond_to blocks for my XML APIs and RJS responses?
+
+  response_for :show do |format|
+    format.html
+    format.js
+    format.xml
+  end
+
+  response_for :update_fails do |format|
+    format.html { render :action => 'edit' }
+    format.json { render :json => false.to_json, :status => 422 }
+  end
+
+=== So I guess I have to write responses for all my actions?
+
+Nope! make_resourceful makes them do the right thing by default.
+You only need to customize them if you want to do something special.
+
+=== Seriously?!
+
+Yes!
+
+== Grok it!
+
+=== +make_resourceful+ the Method
+
+The +make_resourceful+ block is where most of the action happens.
+Here you specify which actions you want to auto-generate,
+what code you want to run for given callbacks,
+and so forth.
+
+You also use the block to declare various bits of information about your controller.
+For instance, if the controller is nested, you'd call +belongs_to+.
+If you wanted to expose your models as some sort of text format,
+you'd call +publish+.
+
+Check out the documentation of Resourceful::Builder
+for more information on the methods you can call here.
+
+=== Helper Methods
+
+make_resourceful provides lots of useful methods
+that can be used in your callbacks and in your views.
+They range from accessing the records you're looking up
+to easily generating URLs for a record
+to getting information about the action itself.
+
+Two of the most useful methods are +current_object+ and +current_objects+
+(note the subtle plurality difference).
++current_objects+ only works for +index+,
+and returns all the records in the current model.
++current_object+ works for all actions other than +index+,
+and returns the record that's currently being dealt with.
+
+The full documentation of the helper methods
+is in Resourceful::Default::Accessors and Resourceful::Default::URLs.
+
+=== Nested Resources
+
+make_resourceful supports easy management of nested resources.
+This is set up with the Resourceful::Builder#belongs_to declaration.
+Pass in the name of the parent model,
+
+  belongs_to :user
+
+and everything will be taken care of.
+When +index+ is run for GET /users/12/albums,
+parent_object[link:classes/Resourceful/Accessors.html#M000024]
+will get <tt>User.find(params[:user_id])</tt>,
+and current_objects[link:classes/Resourceful/Default/Accessors.html#M000010]
+will get <tt>parent_object.albums</tt>.
+When +create+ is run for POST /users/12/albums,
+the newly created Album will automatically belong to the user
+with id 12.
+
+The normal non-scoped actions still work, too.
+GET /albums/15 runs just fine.
+make_resourceful knows that since there's no <tt>params[:user_id]</tt>,
+you just want to deal with the album.
+
+You can even have a single resource nested under several different resources.
+Just pass multiple parent names to the Resourceful::Builder#belongs_to, like
+
+  belongs_to :user, :artist
+
+Then /users/15/albums and /artists/7/albums will both work.
+
+This does, however, mean that make_resourceful only supports one level of nesting.
+There's no automatic handling of /users/15/collections/437/albums.
+However, this is really the best way to organize most resources anyway;
+see this article[http://weblog.jamisbuck.org/2007/2/5/nesting-resources].
+
+If you really need a deeply nested controller,
+it should be easy enough to set up on your own.
+Just override current_model[link:classes/Resourceful/Default/Accessors.html#M000018].
+See the next section for more details.
+
+=== Overriding Methods
+
+Not only are helper methods useful to the developer to use,
+they're used internally by the actions created by make_resourceful.
+Thus one of the main ways make_resourceful can be customized
+is by overriding accessors.
+
+For instance, if you want to only look up the 10 most recent records for +index+,
+you're override +current_objects+.
+If you wanted to use a different model than that suggested by the name of the controller,
+you'd override +current_model+.
+
+When you're overriding methods that do SQL lookups, though, be a little cautious.
+By default, these methods cache their values in instance variables
+so that multiple SQL queries aren't run on multiple calls.
+When overriding them, it's wise for you to do the same.
+For instance,
+
+  def current_object
+    @current_object ||= current_model.find_by_name(params[:name])
+  end
+
+=== For More Information...
+
+Haven't found all the information you need in the RDoc?
+Still a little confused about something?
+Don't despair, there are still more resources available!
+
+* Nathan Weizenbaum periodically makes blog posts about new features and versions of make_resourceful.
+  They may be a little outdated, but they should still be useful and explanatory.
+  * On nesting and associations: here[http://nex-3.com/posts/55-nesting-and-make_resourceful].
+  * An overview of make_resourceful 0.2.0 and 0.2.2: here[http://localhost:3000/posts/54-make_resourceful-0-2-0].
+  * On Resourceful::Builder#publish[link:classes/Resourceful/Builder.html#M000061]
+    and Resourceful::Serialize:
+    here[http://nex-3.com/posts/35-make_resourceful-the-basics-of-publish] and
+    here[http://nex-3.com/posts/36-make_resourceful-publish-extras].
+* There's an excellent, active Google Group (link[http://groups.google.com/group/make_resourceful])
+  where people will be happy to answer your questions.
+* Read the source code!
+  It's very straightforward,
+  and make_resourceful is built to encourage overriding methods
+  and hacking the source.
+
+---
+
+Copyright 2007 Hampton Catlin, Nathan Weizenbaum, and Jeff Hardy.
+
+Contributions by:
+
+* Russell Norris
+* Jonathan Linowes
+* Cristi Balan
+* Mike Ferrier
+* James Golick
+* Don Petersen
+* Alex Ross
+* Tom Stuart

data/vendor/plugins/make_resourceful/Rakefile

@@ -0,0 +1,42 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'spec/rake/spectask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+spec_files = Rake::FileList["spec/**/*_spec.rb"]
+
+desc "Run specs"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = spec_files
+  t.spec_opts = ["-c"]
+end
+
+desc "Generate code coverage"
+Spec::Rake::SpecTask.new(:coverage) do |t|
+  t.spec_files = spec_files
+  t.rcov = true
+  t.rcov_opts = ['--exclude', 'spec,/var/lib/gems']
+end
+
+desc 'Test the make_resourceful plugin.'
+task :test do
+  Dir.chdir(File.dirname(__FILE__) + '/test')
+  tests = IO.popen('rake test')
+
+  while byte = tests.read(1)
+    print byte
+  end
+end
+
+desc 'Generate documentation for the make_resourceful plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'make_resourceful'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.main = 'README'
+  rdoc.rdoc_files.include(FileList.new('*').exclude(/[^A-Z0-9]/))
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/vendor/plugins/make_resourceful/VERSION

@@ -0,0 +1 @@
+0.2.3.0

data/vendor/plugins/make_resourceful/generators/resourceful_scaffold/resourceful_scaffold_generator.rb

@@ -0,0 +1,87 @@
+class ResourcefulScaffoldGenerator < Rails::Generator::NamedBase
+  attr_reader   :controller_class_path,
+                :controller_file_path,
+                :controller_class_nesting,
+                :controller_class_nesting_depth,
+                :controller_class_name,
+                :controller_underscore_name,
+                :controller_plural_name
+  alias_method  :controller_file_name,  :controller_underscore_name
+  alias_method  :controller_table_name, :controller_plural_name
+
+  def initialize(runtime_args, runtime_options = {})
+    super
+
+    base_name, @controller_class_path, @controller_file_path, @controller_class_nesting, @controller_class_nesting_depth = extract_modules(@name.pluralize)
+    @controller_class_name_without_nesting, @controller_underscore_name, @controller_plural_name = inflect_names(base_name)
+
+    if @controller_class_nesting.empty?
+      @controller_class_name = @controller_class_name_without_nesting
+    else
+      @controller_class_name = "#{@controller_class_nesting}::#{@controller_class_name_without_nesting}"
+    end
+  end
+  
+  def manifest
+    record do |m|
+      # Check for class naming collisions.
+      m.class_collisions(controller_class_path, "#{controller_class_name}Controller", "#{controller_class_name}Helper")
+      m.class_collisions(class_path, "#{class_name}")
+
+      # Controller, helper, views, and test directories.
+      m.directory(File.join('app/models', class_path))
+      m.directory(File.join('app/controllers', controller_class_path))
+      m.directory(File.join('app/helpers', controller_class_path))
+      m.directory(File.join('app/views', controller_class_path, controller_file_name))
+      m.directory(File.join('test/functional', controller_class_path))
+      m.directory(File.join('test/unit', class_path))
+      m.directory(File.join('test/fixtures', class_path))
+
+      # Views
+      for action in scaffold_views
+        m.template("view_#{action}.haml", File.join('app/views', controller_class_path, controller_file_name, "#{action}.html.haml"))
+      end
+      m.template('view_partial.haml', File.join('app/views', controller_class_path, controller_file_name, "_#{singular_name}.html.haml"))
+
+      # Helper
+      m.template('helper.rb', File.join('app/helpers', controller_class_path, "#{controller_file_name}_helper.rb"))
+
+      # Model
+      m.template('model.rb', File.join('app/models', class_path, "#{file_name}.rb"))
+
+      unless options[:skip_migration]
+        m.migration_template('migration.rb', 'db/migrate', 
+          :assigns => {
+            :migration_name => "Create#{class_name.pluralize.gsub(/::/, '')}",
+            :attributes     => attributes
+          },
+          :migration_file_name => "create_#{file_path.gsub(/\//, '_').pluralize}")
+      end
+
+      # Controller
+      m.template('controller.rb', File.join('app/controllers', controller_class_path, "#{controller_file_name}_controller.rb"))      
+
+      # Tests
+      m.template('functional_test.rb', File.join('test/functional', controller_class_path, "#{controller_file_name}_controller_test.rb"))
+      m.template('unit_test.rb',       File.join('test/unit', class_path, "#{file_name}_test.rb"))
+      m.template('fixtures.yml',       File.join('test/fixtures', "#{table_name}.yml"))
+
+      # Route
+      m.route_resources controller_file_name
+    end
+  end
+
+  protected
+  
+  def banner
+    "Usage: #{$0} resourcefulscaffold ModelName [field:type, field:type]"
+  end
+
+  def scaffold_views
+    %w[ index show new edit _form ]
+  end
+
+  def model_name 
+    class_name.demodulize
+  end
+end