merb-action-args 0.9.2

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 YOUR NAME
+
+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

@@ -0,0 +1,49 @@
+merb-action-args
+================
+
+A plugin for the Merb framework that provides support for arguments to actions that 
+come in from the query.
+
+==== Basics
+
+{{[
+class Foo < Merb::Controller
+  def bar(baz)
+    bar
+  end
+end
+]}}
+
+Hitting "/foo/bar?baz=bat" will call foo("bat").
+
+Hitting "/foo/bar" will raise a BadRequest (Status 400) error.
+
+==== Defaults
+
+{{[
+class Foo < Merb::Controller
+  def bar(baz, bat = "hola")
+    "#{baz} #{bat}"
+  end
+end
+]}}
+
+Hitting "/foo/bar?baz=bat" will call foo("bat", "hola")
+
+Hitting "/foo/bar?baz=bat&bat=whaa" will call foo("bat", "whaa")
+
+Hitting "/foo/bar" will still raise a BadRequest.
+
+==== Out of order defaults
+
+{{[
+class Foo < Merb::Controller
+  def bar(one, two = "dos", three = "tres")
+    "#{one} #{two} #{three}"
+  end
+end
+]}}
+
+The interesting thing here is that hitting "/foo/bar?one=uno&three=three" will call
+foo("uno", "dos", "three"). In other words, the defaults can be in any order, and 
+merb-action-args will figure out where to fill in the holes.

data/Rakefile

@@ -0,0 +1,44 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+
+PLUGIN = "merb-action-args"
+NAME = "merb-action-args"
+VERSION = "0.9.2"
+AUTHOR = "Yehuda Katz"
+EMAIL = "ykatz@engineyard.com"
+HOMEPAGE = "http://merb-plugins.rubyforge.org/merb-haml/"
+SUMMARY = "Merb plugin that provides support for ActionArgs"
+
+spec = Gem::Specification.new do |s|
+  s.name = NAME
+  s.version = VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README", "LICENSE", 'TODO']
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.author = AUTHOR
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  s.add_dependency('merb-core', '>= 0.9.2')
+  s.require_path = 'lib'
+  s.autorequire = PLUGIN
+  s.files = %w(LICENSE README Rakefile TODO) + Dir.glob("{lib,specs}/**/*")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+task :install => [:package] do
+  sh %{sudo gem install pkg/#{NAME}-#{VERSION} --no-update-sources}
+end
+
+namespace :jruby do
+
+  desc "Run :package and install the resulting .gem with jruby"
+  task :install => :package do
+    sh %{#{SUDO} jruby -S gem install pkg/#{NAME}-#{Merb::VERSION}.gem --no-rdoc --no-ri}
+  end
+  
+end

data/TODO

@@ -0,0 +1,5 @@
+TODO:
+Fix LICENSE with your name
+Fix Rakefile with your name and contact info
+Add your code to lib/merb-haml.rb
+Add your Merb rake tasks to lib/merb-haml/merbtasks.rb

data/lib/merb-action-args.rb

@@ -0,0 +1,2 @@
+require "merb-action-args/get_args"
+require "merb-action-args/abstract_controller"

data/lib/merb-action-args/abstract_controller.rb

@@ -0,0 +1,36 @@
+class Merb::AbstractController
+  
+  class << self
+    attr_accessor :action_argument_list    
+    alias_method :old_inherited, :inherited
+
+    # Stores the argument lists for all methods for this class.
+    #
+    # ==== Parameters
+    # klass<Class>::
+    #   The controller that is being inherited from Merb::AbstractController.
+    def inherited(klass)
+      klass.action_argument_list = Hash.new do |h,k| 
+        h[k] = ParseTreeArray.translate(klass, k.to_sym).get_args
+      end      
+      old_inherited(klass)
+    end
+  end
+
+  # Calls an action and maps the params hash to the action parameters.
+  #
+  # ==== Parameters
+  # action<Symbol>:: The action to call
+  #
+  # ==== Raises
+  # BadRequest:: The params hash doesn't have a required parameter.
+  def _call_action(action)
+    args = self.class.action_argument_list[action].map do |arg, default|
+      arg = arg
+      p = params.key?(arg.to_sym)
+      raise BadRequest unless p || default
+      p ? params[arg.to_sym] : default
+    end
+    __send__(action, *args)
+  end
+end

data/lib/merb-action-args/get_args.rb

@@ -0,0 +1,84 @@
+require 'ruby2ruby'
+
+class ParseTreeArray < Array #:nodoc:
+  def self.translate(*args)
+    self.new(ParseTree.translate(*args))
+  end
+
+  def deep_array_node(type = nil)
+    each do |node|
+      return ParseTreeArray.new(node) if node.is_a?(Array) && (!type || node[0] == type)
+      next unless node.is_a?(Array)
+      return ParseTreeArray.new(node).deep_array_node(type)
+    end
+    nil
+  end
+
+  def arg_nodes
+    self[1..-1].inject([]) do |sum,item|
+      sum << [item] unless item.is_a?(Array)
+      sum
+    end
+  end
+  
+  def get_args
+    if arg_node = deep_array_node(:args)
+      # method defined with def keyword
+      args = arg_node.arg_nodes
+      default_node = arg_node.deep_array_node(:block)
+      return args unless default_node
+    else
+      # assuming method defined with Module#define_method
+      return []
+    end
+    
+    # if it was defined with def, and we found the default_node,
+    # that should bring us back to regularly scheduled programming..
+    
+    lasgns = default_node[1..-1]
+    lasgns.each do |asgn|
+      args.assoc(asgn[1]) << eval(RubyToRuby.new.process(asgn[2]))
+    end
+    args
+  end
+
+end
+
+# Used in mapping controller arguments to the params hash.
+# NOTE: You must have the 'ruby2ruby' gem installed for this to work.
+#
+# ==== Examples
+#   # In PostsController
+#   def show(id)  #=> id is the same as params[:id]
+module GetArgs
+  
+  # ==== Returns
+  # Array:: Method arguments and their default values.
+  #
+  # ==== Examples
+  #   class Example
+  #     def hello(one,two="two",three)
+  #     end
+  #
+  #     def goodbye
+  #     end
+  #   end
+  #
+  #   Example.instance_method(:hello).get_args
+  #     #=> [[:one], [:two, "two"], [:three, "three"]]
+  #   Example.instance_method(:goodbye).get_args  #=> nil
+  def get_args
+    klass, meth = self.to_s.split(/ /).to_a[1][0..-2].split("#")
+    # Remove stupidity for #<Method: Class(Object)#foo>
+    klass = $` if klass =~ /\(/
+    ParseTreeArray.translate(Object.const_get(klass), meth).get_args
+  end
+end
+
+class UnboundMethod #:nodoc:
+  include GetArgs
+end
+
+class Method  #:nodoc:
+  include GetArgs
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+name: merb-action-args
+version: !ruby/object:Gem::Version 
+  version: 0.9.2
+platform: ruby
+authors: 
+- Yehuda Katz
+autorequire: merb-action-args
+bindir: bin
+cert_chain: []
+
+date: 2008-03-24 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: merb-core
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.2
+    version: 
+description: Merb plugin that provides support for ActionArgs
+email: ykatz@engineyard.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- LICENSE
+- TODO
+files: 
+- LICENSE
+- README
+- Rakefile
+- TODO
+- lib/merb-action-args
+- lib/merb-action-args/abstract_controller.rb
+- lib/merb-action-args/get_args.rb
+- lib/merb-action-args.rb
+has_rdoc: true
+homepage: http://merb-plugins.rubyforge.org/merb-haml/
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Merb plugin that provides support for ActionArgs
+test_files: []
+