action_args 0.0.2

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in action_args.gemspec
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2004-2011 David Heinemeier Hansson
+
+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/README.rdoc

@@ -0,0 +1,149 @@
+= ActionArgs
+
+Controller action arguments parameterizer for Rails 3 + Ruby 1.9
+
+
+== What is this?
+
+ActionArgs is a Rails 3 plugin that extends your controller action methods to look and act like simple general Ruby methods with meaningful parameters, or in short, Merbish.
+
+
+== The Controllers
+
+Having the following controller code:
+
+  class HogeController < ApplicationController
+    def fuga(piyo)
+      render :text => piyo
+    end
+  end
+
+Hitting "/hoge/fuga?piyo=foo" will call fuga('foo') and output 'foo'.
+So, you do never need to touch the ugly +params+ Hash to get the request parameters.
+
+
+== The Scaffold Generator
+
+To tell you the truth, Rails 3 is originally designed to be able to very easily add this functionality (because Carlhuda did the work on this), so perhaps the most characteristic feature of this plugin is the generator.
+ActionArgs provides a custom scaffold controller generator that overwrites the default scaffold generator.
+Thus, by hitting the following command:
+
+  % rails g scaffold user name:string
+
+The following beautiful controller code will be generated:
+
+  # coding: utf-8
+
+  class UsersController < ApplicationController
+    # GET /users
+    def index
+      @users = User.all
+    end
+
+    # GET /users/1
+    def show(id)
+      @user = User.find(id)
+    end
+
+    # GET /users/new
+    def new
+      @user = User.new
+    end
+
+    # GET /users/1/edit
+    def edit(id)
+      @user = User.find(id)
+    end
+
+    # POST /users
+    def create(user)
+      @user = User.new(user)
+
+      if @user.save
+        redirect_to @user, :notice => 'User was successfully created.'
+      else
+        render :action => 'new'
+      end
+    end
+
+    # PUT /users/1
+    def update(id, user)
+      @user = User.find(id)
+
+      if @user.update_attributes(user)
+        redirect_to @user, :notice => 'User was successfully updated.'
+      else
+        render :action => 'edit'
+      end
+    end
+
+    # DELETE /users/1
+    def destroy(id)
+      @user = User.find(id)
+      @user.destroy
+
+      redirect_to users_url
+    end
+  end
+
+You may notice that
+* There are no globalish +params+ referrence
+* It's quite easy to comprehend what's the actual input value for each action
+* You may write the unit test code as if the actions are just normal Ruby methods
+
+
+== Supported versions
+
+* Ruby 1.9.2, 1.9.3 (trunk)
+
+* Rails 3.0.x, 3.1 (edge)
+
+
+== Installation
+
+Put this line in your Gemfile:
+  gem 'action_args'
+
+Then bundle:
+  % bundle
+
+
+== Notes
+
+=== Plain Old Action Methods
+
+Of courese you still can use both Merbish style and plain old Rails style action methods even if this plugin is loaded. +params+ parameter is still alive as well. That means, this plugin won't break any existing controller API.
+
+=== Argument Naming Convention
+
+Each action method parameter name corresponds to +params+ key name. For example, the following beautifully written nested show action works perfectly (this might not be a very good example of effective querying, but that's another story).
+
+  Rails.application.routes.draw do
+    resources :authors do
+      resources :books
+    end
+  end
+
+  class BooksController < ApplicationController
+    # GET /authors/:author_id/books/:id
+    def show(author_id, id)
+      @book = Author.find(author_id).books.find(id)
+    end
+    ...
+  end
+
+
+== Todo
+
+* specs
+* other Ruby implementations
+
+
+== Conclusion
+
+Ruby 1.9 on Rails 3 FTW!
+
+
+== Copyright
+
+Copyright (c) 2011 Asakusa.rb. See MIT-LICENSE for further details.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/action_args.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require 'action_args/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'action_args'
+  s.version     = ActionArgs::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Akira Matsuda']
+  s.email       = ['ronnie@dio.jp']
+  s.homepage    = 'http://asakusa.rubyist.net/'
+  s.summary     = 'Controller action arguments parameterizer for Rails 3 + Ruby 1.9'
+  s.description = 'Rails 3 plugin gem that supports Merbish style controller action arguments.'
+
+  s.rubyforge_project = 'action_args'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/action_args/abstract_controller.rb

@@ -0,0 +1,10 @@
+module AbstractController
+  class Base
+    def send_action(method_name, *args)
+      return send method_name, *args unless args.blank?
+
+      values = method(method_name).parameters.map(&:last).map {|k| params[k]}
+      send method_name, *values
+    end
+  end
+end

data/lib/action_args/version.rb

@@ -0,0 +1,3 @@
+module ActionArgs
+  VERSION = '0.0.2'
+end

data/lib/action_args.rb

@@ -0,0 +1,11 @@
+require File.join(File.dirname(__FILE__), 'action_args/abstract_controller')
+
+module ActionArgs
+  class Railtie < ::Rails::Railtie
+    if config.respond_to? :app_generators
+      config.app_generators.scaffold_controller = :action_args_scaffold_controller
+    else
+      config.generators.scaffold_controller = :action_args_scaffold_controller
+    end
+  end
+end

data/lib/generators/rails/action_args_scaffold_controller_generator.rb

@@ -0,0 +1,9 @@
+require 'rails/generators/rails/scaffold_controller/scaffold_controller_generator'
+
+module Rails
+  module Generators
+    class ActionArgsScaffoldControllerGenerator < ::Rails::Generators::ScaffoldControllerGenerator
+      source_root File.expand_path('../templates', __FILE__)
+    end
+  end
+end

data/lib/generators/rails/templates/controller.rb

@@ -0,0 +1,53 @@
+# coding: utf-8
+
+class <%= controller_class_name %>Controller < ApplicationController
+  # GET <%= route_url %>
+  def index
+    @<%= plural_table_name %> = <%= orm_class.all(class_name) %>
+  end
+
+  # GET <%= route_url %>/1
+  def show(id)
+    @<%= singular_table_name %> = <%= orm_class.find(class_name, 'id') %>
+  end
+
+  # GET <%= route_url %>/new
+  def new
+    @<%= singular_table_name %> = <%= orm_class.build(class_name) %>
+  end
+
+  # GET <%= route_url %>/1/edit
+  def edit(id)
+    @<%= singular_table_name %> = <%= orm_class.find(class_name, 'id') %>
+  end
+
+  # POST <%= route_url %>
+  def create(<%= singular_table_name %>)
+    @<%= singular_table_name %> = <%= orm_class.build(class_name, singular_table_name) %>
+
+    if @<%= orm_instance.save %>
+      redirect_to @<%= singular_table_name %>, notice: '<%= human_name %> was successfully created.'
+    else
+      render action: 'new'
+    end
+  end
+
+  # PUT <%= route_url %>/1
+  def update(id, <%= singular_table_name %>)
+    @<%= singular_table_name %> = <%= orm_class.find(class_name, 'id') %>
+
+    if @<%= orm_instance.update_attributes(singular_table_name) %>
+      redirect_to @<%= singular_table_name %>, notice: '<%= human_name %> was successfully updated.'
+    else
+      render action: 'edit'
+    end
+  end
+
+  # DELETE <%= route_url %>/1
+  def destroy(id)
+    @<%= singular_table_name %> = <%= orm_class.find(class_name, 'id') %>
+    @<%= orm_instance.destroy %>
+
+    redirect_to <%= index_helper %>_url
+  end
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: action_args
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Akira Matsuda
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-17 00:00:00 Z
+dependencies: []
+
+description: Rails 3 plugin gem that supports Merbish style controller action arguments.
+email: 
+- ronnie@dio.jp
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- MIT-LICENSE
+- README.rdoc
+- Rakefile
+- action_args.gemspec
+- lib/action_args.rb
+- lib/action_args/abstract_controller.rb
+- lib/action_args/version.rb
+- lib/generators/rails/action_args_scaffold_controller_generator.rb
+- lib/generators/rails/templates/controller.rb
+homepage: http://asakusa.rubyist.net/
+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: action_args
+rubygems_version: 1.8.2
+signing_key: 
+specification_version: 3
+summary: Controller action arguments parameterizer for Rails 3 + Ruby 1.9
+test_files: []
+