resource_controller 0.4.9

data/lib/resource_controller/helpers/urls.rb

@@ -0,0 +1,124 @@
+# Thanks to Urligence, you get some free url helpers.
+# 
+# No matter what your controller looks like...
+# 
+#   [edit_|new_]object_url # is the equivalent of saying [edit_|new_]post_url(@post)
+#   [edit_|new_]object_url(some_other_object) # allows you to specify an object, but still maintain any paths or namespaces that are present
+# 
+#   collection_url # is like saying posts_url
+# 
+# Url helpers are especially useful when working with polymorphic controllers.
+# 
+#   # /posts/1/comments
+#   object_url #=> /posts/1/comments/#{@comment.to_param}
+#   object_url(comment) #=> /posts/1/comments/#{comment.to_param}
+#   edit_object_url #=> /posts/1/comments/#{@comment.to_param}/edit
+#   collection_url #=> /posts/1/comments
+# 
+#   # /products/1/comments
+#   object_url #=> /products/1/comments/#{@comment.to_param}
+#   object_url(comment) #=> /products/1/comments/#{comment.to_param}
+#   edit_object_url #=> /products/1/comments/#{@comment.to_param}/edit
+#   collection_url #=> /products/1/comments
+# 
+#   # /comments
+#   object_url #=> /comments/#{@comment.to_param}
+#   object_url(comment) #=> /comments/#{comment.to_param}
+#   edit_object_url #=> /comments/#{@comment.to_param}/edit
+#   collection_url #=> /comments
+# 
+# Or with namespaced, nested controllers...
+# 
+#   # /admin/products/1/options
+#   object_url #=> /admin/products/1/options/#{@option.to_param}
+#   object_url(option) #=> /admin/products/1/options/#{option.to_param}
+#   edit_object_url #=> /admin/products/1/options/#{@option.to_param}/edit
+#   collection_url #=> /admin/products/1/options
+# 
+# You get the idea.  Everything is automagical!  All parameters are inferred.
+#
+module ResourceController::Helpers::Urls
+  protected
+    ['', 'edit_'].each do |type|
+      symbol = type.blank? ? nil : type.gsub(/_/, '').to_sym
+      
+      define_method("#{type}object_url") do |*alternate_object|
+        smart_url *object_url_options(symbol, alternate_object.first)
+      end
+      
+      define_method("#{type}object_path") do |*alternate_object|
+        smart_path *object_url_options(symbol, alternate_object.first)
+      end
+      
+      define_method("hash_for_#{type}object_url") do |*alternate_object|
+        hash_for_smart_url *object_url_options(symbol, alternate_object.first)
+      end
+      
+      define_method("hash_for_#{type}object_path") do |*alternate_object|
+        hash_for_smart_path *object_url_options(symbol, alternate_object.first)
+      end
+    end
+    
+    def new_object_url
+      smart_url *new_object_url_options
+    end
+    
+    def new_object_path
+      smart_path *new_object_url_options
+    end
+    
+    def hash_for_new_object_url
+      hash_for_smart_url *new_object_url_options
+    end
+    
+    def hash_for_new_object_path
+      hash_for_smart_path *new_object_url_options
+    end
+    
+    def collection_url
+      smart_url *collection_url_options
+    end
+    
+    def collection_path
+      smart_path *collection_url_options
+    end
+    
+    def hash_for_collection_url
+      hash_for_smart_url *collection_url_options
+    end
+    
+    def hash_for_collection_path
+      hash_for_smart_path *collection_url_options
+    end
+    
+    # Used internally to provide the options to smart_url from Urligence.
+    #
+    def collection_url_options
+      namespaces + [parent_url_options, route_name.to_s.pluralize.to_sym]
+    end
+    
+    # Used internally to provide the options to smart_url from Urligence.
+    #
+    def object_url_options(action_prefix = nil, alternate_object = nil)
+      [action_prefix] + namespaces + [parent_url_options, [route_name.to_sym, alternate_object || object]]
+    end
+    
+    # Used internally to provide the options to smart_url from Urligence.
+    #
+    def new_object_url_options
+      [:new] + namespaces + [parent_url_options, route_name.to_sym]
+    end
+    
+    def parent_url_options
+      parent? ? [parent_type.to_sym, parent_object] : nil
+    end
+    
+    # Returns all of the current namespaces of the current controller, symbolized, in array form.
+    #
+    def namespaces
+      names = self.class.name.split("::")
+      names.pop
+      
+      names.map(&:underscore).map(&:to_sym)
+    end
+end

data/lib/resource_controller/response_collector.rb

@@ -0,0 +1,27 @@
+module ResourceController
+  class ResponseCollector
+    
+    attr_reader :responses
+    
+    delegate :clear, :to => :responses
+    
+    def initialize
+      @responses = []
+    end
+    
+    def method_missing(method_name, &block)
+      @responses.delete self[method_name]
+      @responses << [method_name, block || nil]
+    end
+    
+    def [](symbol)
+      @responses.find { |method, block| method == symbol }
+    end
+    
+    def dup
+      returning ResponseCollector.new do |duplicate|
+        duplicate.instance_variable_set(:@responses, responses.dup)
+      end
+    end
+  end
+end

data/lib/resource_controller/version.rb

@@ -0,0 +1,9 @@
+module ResourceController
+  module VERSION
+    MAJOR    = 0
+    MINOR    = 4
+    TINY     = 9
+    
+    STRING   = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/lib/tasks/gem.rake

@@ -0,0 +1,67 @@
+require 'rake/gempackagetask'
+require 'yaml'
+
+task :clean => :clobber_package
+
+spec = Gem::Specification.new do |s|
+  s.name                  = 'resource_controller'
+  s.version               = ResourceController::VERSION::STRING
+  s.summary               = "resource_controller makes RESTful controllers easier, more maintainable, and super readable. With the RESTful controller pattern hidden away, you can focus on what makes your controller special."
+  s.rubyforge_project     = "giraffesoft"
+  s.description           = "Rails RESTful controller abstraction plugin."
+  s.author                = "James Golick"
+  s.email                 = "james@giraffesoft.ca"
+  s.homepage              = "http://jamesgolick.com/resource_controller"
+  s.has_rdoc              = true
+
+  s.required_ruby_version = '>= 1.8.5'
+
+  s.files                 = %w(README.rdoc README LICENSE init.rb Rakefile) +
+                            Dir.glob("{lib,test,generators,rails}/**/*")
+  
+  s.require_path          = "lib"
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+end
+
+task :tag_warn do
+  puts "*" * 40
+  puts "Don't forget to tag the release:"
+  puts
+  puts "  git tag -a v#{ResourceController::VERSION::STRING}"
+  puts
+  puts "or run rake tag"
+  puts "*" * 40
+end
+
+task :tag do
+  sh "git tag -a v#{ResourceController::VERSION::STRING}"
+end
+task :gem => :tag_warn
+
+namespace :gem do
+  desc 'Upload gems to rubyforge.org'
+  task :rubyforge => :gem do
+    sh 'rubyforge login'
+    sh "rubyforge add_release giraffesoft resource_controller #{ResourceController::VERSION::STRING} pkg/#{spec.full_name}.gem"
+    sh "rubyforge add_file    giraffesoft resource_controller #{ResourceController::VERSION::STRING} pkg/#{spec.full_name}.gem"
+  end
+  
+  desc "Update the gemspec for GitHub's gem server"
+  task :github do
+    File.open("resource_controller.gemspec", 'w'){|f| f.puts YAML::dump(spec) }
+    puts "gemspec generated here: resource_controller.gemspec"
+  end
+  
+  desc "Build and install the gem locally."
+  task :install => [:clobber, :package] do
+    sh "sudo gem install pkg/#{spec.full_name}.gem"
+  end
+  
+  desc "Remove the gem."
+  task :uninstall => :clean do
+    sh "sudo gem uninstall -v #{ResourceController::VERSION::STRING} -x #{ResourceController::NAME}"
+  end
+end

data/lib/urligence.rb

@@ -0,0 +1,50 @@
+module Urligence
+  def smart_url(*objects)
+    urligence(*objects.push(:url))
+  end
+  
+  def smart_path(*objects)
+    urligence(*objects.push(:path))
+  end
+  
+  def hash_for_smart_url(*objects)
+    urligence(*objects.unshift(:hash_for).push(:url).push({:type => :hash}))
+  end
+  
+  def hash_for_smart_path(*objects)
+    urligence(*objects.unshift(:hash_for).push(:path).push({:type => :hash}))
+  end
+  
+  def urligence(*objects)
+    config = {}
+    config.merge!(objects.pop) if objects.last.is_a?(Hash)
+    
+    objects.reject! { |object| object.nil? }
+    
+    url_fragments = objects.collect do |obj|
+      if obj.is_a? Symbol
+        obj
+      elsif obj.is_a? Array
+        obj.first
+      else
+        obj.class.name.underscore.to_sym
+      end
+    end
+    
+    unless config[:type] == :hash
+      send url_fragments.join("_"), *objects.flatten.select { |obj| !obj.is_a? Symbol }
+    else
+      params = {}
+      unparsed_params = objects.select { |obj| !obj.is_a? Symbol }
+      unparsed_params.each_with_index do |obj, i|
+        unless i == (unparsed_params.length-1)
+          params.merge!((obj.is_a? Array) ? {"#{obj.first}_id".to_sym => obj[1].to_param} : {"#{obj.class.name.underscore}_id".to_sym => obj.to_param})
+        else
+          params.merge!((obj.is_a? Array) ? {:id => obj[1].to_param} : {:id => obj.to_param})
+        end
+      end
+      
+      send url_fragments.join("_"), params
+    end
+  end
+end

data/rails/init.rb

@@ -0,0 +1,6 @@
+ActionController::Base.class_eval do
+  include Urligence
+  helper_method :smart_url
+  
+  extend ResourceController::ActionControllerExtension
+end

data/test/Rakefile

@@ -0,0 +1,10 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require(File.join(File.dirname(__FILE__), 'config', 'boot'))
+
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+require 'tasks/rails'

data/test/app/controllers/application.rb

@@ -0,0 +1,7 @@
+# Filters added to this controller apply to all controllers in the application.
+# Likewise, all the methods added will be available for all controllers.
+
+class ApplicationController < ActionController::Base
+  # Pick a unique cookie name to distinguish our session data from others'
+  session :session_key => '_myapp_session'
+end

data/test/app/controllers/cms/options_controller.rb

@@ -0,0 +1,3 @@
+class Cms::OptionsController < ResourceController::Base
+  belongs_to :product
+end

data/test/app/controllers/cms/products_controller.rb

@@ -0,0 +1,3 @@
+class Cms::ProductsController < ResourceController::Base
+  create.flash_now 'something'
+end

data/test/app/controllers/comments_controller.rb

@@ -0,0 +1,3 @@
+class CommentsController < ResourceController::Base
+  belongs_to :post
+end

data/test/app/controllers/people_controller.rb

@@ -0,0 +1,9 @@
+class PeopleController < ResourceController::Base
+  create.before :name_person
+  model_name    :account
+  
+  private
+    def name_person
+      @person.name = "Bob Loblaw"
+    end
+end

data/test/app/controllers/photos_controller.rb

@@ -0,0 +1,11 @@
+class PhotosController < ResourceController::Base
+  actions :all, :except => :update
+  
+  belongs_to :user
+  create.flash { "#{@photo.title} was created!" }
+  
+  private
+    def parent_model
+      Account
+    end
+end

data/test/app/controllers/posts_controller.rb

@@ -0,0 +1,10 @@
+class PostsController < ResourceController::Base
+  actions :all
+  
+  create.before(:name_post) { @post.body = '...' }
+  
+  private
+    def name_post
+      @post.title = 'a great post'
+    end
+end

data/test/app/controllers/projects_controller.rb

@@ -0,0 +1,3 @@
+class ProjectsController < ApplicationController
+  resource_controller
+end

data/test/app/controllers/somethings_controller.rb

@@ -0,0 +1,3 @@
+class SomethingsController < ResourceController::Base
+  actions :index, :show
+end

data/test/app/controllers/tags_controller.rb

@@ -0,0 +1,13 @@
+class TagsController < ResourceController::Base
+  belongs_to :photo
+  
+  index.wants.js
+  
+  index do
+    before { @products = Product.find :all }
+  end
+  
+  create.after do
+    @photo.tags << @tag if parent_type == :photo
+  end
+end

data/test/app/controllers/users_controller.rb

@@ -0,0 +1,12 @@
+class UsersController < ResourceController::Base
+  object_name :dude
+  route_name :dude
+  private    
+    def route_name
+      'dude'
+    end
+    
+    def model_name
+      'account'
+    end
+end

data/test/app/helpers/application_helper.rb

@@ -0,0 +1,3 @@
+# Methods added to this helper will be available to all templates in the application.
+module ApplicationHelper
+end

data/test/app/helpers/cms/products_helper.rb

@@ -0,0 +1,2 @@
+module Cms::ProductsHelper
+end

data/test/app/helpers/comments_helper.rb

@@ -0,0 +1,2 @@
+module CommentsHelper
+end

data/test/app/helpers/options_helper.rb

@@ -0,0 +1,2 @@
+module OptionsHelper
+end

data/test/app/helpers/people_helper.rb

@@ -0,0 +1,2 @@
+module PeopleHelper
+end

data/test/app/helpers/photos_helper.rb

@@ -0,0 +1,2 @@
+module PhotosHelper
+end

data/test/app/helpers/posts_helper.rb

@@ -0,0 +1,2 @@
+module PostsHelper
+end

data/test/app/helpers/projects_helper.rb

@@ -0,0 +1,2 @@
+module ProjectsHelper
+end

data/test/app/helpers/somethings_helper.rb

@@ -0,0 +1,2 @@
+module SomethingsHelper
+end