merb_helpers_monkey 0.1.0

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright(c) 2008 kuwata-lab.com all rights reserverd.
+
+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.txt

@@ -0,0 +1,108 @@
+======
+README
+======
+
+
+About
+=====
+
+merb_helpers_monkey is a Merb plug-in to extend the following helper methods.
+
+* radio_button() to take boolean value as :checked options.
+* fields_for(), form_for(), and fieldset_for() to take :index_by option.
+
+
+Install
+=======
+
+  ### install gem
+  $ sudo gem install merb_helpers_monkey
+  ## add 'dependency "merb_helpers_monkey"
+  $ vi config/dependencies.rb
+
+
+Usage
+=====
+
+
+radio_button()
+--------------
+
+In Merb, 'radio_button :checked=>true' and 'radio_button :checked=>false'
+will genereate:
+
+    <input type="radio" checked="true" />
+    <input type="radio" checked="false" />
+
+But the following output should be generated:
+
+    <input type="radio" checked="checked" />
+    <input type="radio" />
+
+Merb_helpers_monkey extends radio_button() to generate the above <input> tag.
+So you can write such as 'radio_button :checked=>(params[:foo]="y")'.
+
+
+fields_for(), form_for(), fieldsset_for()
+----------------------------------------- 
+
+These methods are extended to accept new ':index_by' option.
+
+For example:
+
+    <% @users.each do |user| %>
+    <%=  fields_for user, :index_by => :id do %>
+    <p>
+      <%= text_field :name, :label => 'Name' %>
+      <%= text_field :mail, :label => 'Mail' %>
+    </p>
+    <%   end =%>
+    <% end %>
+
+will generate:
+
+    <p>
+      <label for="user_name_101">Name</label>
+      <input type="text" name="user[101][name]" id="user_name_101" value="Foo" />
+      <label for="user_mail_101">Mail</label>
+      <input type="text" name="user[101][mail]" id="user_mail_101" value="foo@mail.com" />
+    </p>
+    <p>
+      <label for="user_name_102">Name</label>
+      <input type="text" name="user[102][name]" id="user_name_102" value="Bar" />
+      <label for="user_mail_102">Mail</label>
+      <input type="text" name="user[102][mail]" id="user_mail_102" value="bar@mail.com" />
+    </p>
+
+and the following parameters will be sent:
+
+    params = {
+      :user => {
+        "101" => { :name => "Foo", :mail => "foo@mail.com" },
+        "102" => { :name => "Bar", :mail => "bar@mail.com" },
+      }
+    }
+
+So you can define controller action like the following:
+
+    def update
+      params[:user].each do |user_id, values|
+        user = User.get(ur_id)  or raise NotFound
+        user.update_attribute(values)
+        ...
+      end
+    end
+
+
+Author
+------
+
+makoto kuwata <kwa(at)kuwata-lab.com>
+copyright(c) 2008 kuwata-lab.com all rights reserved.
+
+
+License
+-------
+
+MIT License
+

data/lib/merb_helpers_monkey.rb

@@ -0,0 +1,189 @@
+##
+## enhances some helper methods in merb_helpers.
+## see:
+##   http://merb.lighthouseapp.com/projects/7435/tickets/10
+##
+## this monkey patch is based on merb-helpers 1.0.0.
+##
+
+
+require 'merb-helpers'
+
+
+##
+## enhances radio_button() to take boolean value as :checked option.
+##
+
+module Merb::Helpers::Form
+
+  alias _radio_button_orig radio_button
+
+  def radio_button(*args)
+    if (opts = args.last).is_a?(Hash)
+      opts[:checked] = "checked" if opts.delete(:checked)
+    end
+    _radio_button_orig(*args)
+  end
+
+end
+
+
+##
+## enhances form_for(), fields_for(), and fieldset_for() to support :index_by option.
+## see:
+##   http://merb.lighthouseapp.com/projects/7435/tickets/10
+##
+
+## --
+## merb-helpers-1.0/lib/merb-helpers/builder.rb
+## ++
+module Merb::Helpers::Form::Builder
+
+
+  class Base
+
+    ##--
+    ##def bound_text_area(method, attrs = {})
+    ##  name = "#{@name}[#{method}]"
+    ##  update_bound_controls(method, attrs, "text_area")
+    ##  unbound_text_area(control_value(method), {:name => name}.merge(attrs))
+    ##end
+    ##++
+    def bound_text_area(method, attrs = {})
+      name = control_name(method)
+      update_bound_controls(method, attrs, "text_area")
+      unbound_text_area(control_value(method), {:name => name}.merge(attrs))
+    end
+
+    private
+
+    ##--
+    ##def control_name(method)
+    ##  @obj ? "#{@name}[#{method}]" : method
+    ##end
+    ##++
+    def control_name(method)
+      #!@obj ? method : !@index_by ? "#{@name}[#{method}]" : "#{@name}[#{@obj.__send__(@index_by)}][#{method}]"
+      !@obj ? method : !@index ? "#{@name}[#{method}]" : "#{@name}[#{@index}][#{method}]"
+    end
+
+  end
+
+
+  class Form
+
+    private
+
+    ##--
+    ##def update_bound_controls(method, attrs, type)
+    ## attrs.merge!(:id => "#{@name}_#{method}") unless attrs[:id]
+    ##end
+    ##++
+    def update_bound_controls(method, attrs, type)
+      #attrs.merge!(:id => "#{@name}_#{method}") unless attrs[:id]
+      unless attrs[:id]
+        id_attr = "#{@name}_#{method}"
+        #id_attr << "_#{@obj.__send__(@index_by)}" if @index_by
+        id_attr << "_#{@index}" if @index
+        attrs.merge!(:id => id_attr)
+      end
+      super
+    end
+
+    ##--
+    ##def radio_group_item(method, attrs)
+    ##  unless attrs[:id]
+    ##    attrs.merge!(:id => "#{@name}_#{method}_#{attrs[:value]}")
+    ##  end
+    ##
+    ##  attrs.merge!(:label => attrs[:label] || attrs[:value])
+    ##  super
+    ##end
+    ##++
+    def radio_group_item(method, attrs)
+      unless attrs[:id]
+        #attrs.merge!(:id => "#{@name}_#{method}_#{attrs[:value]}")
+        id_attr = "#{@name}_#{method}_#{attrs[:value]}"
+        #id_attr << "_#{@obj.__send__(@index_by)}" if @index_by
+        id_attr << "_#{@index}" if @index
+        attrs.merge!(:id => id_attr)
+      end
+
+      attrs.merge!(:label => attrs[:label] || attrs[:value])
+      super
+    end
+
+  end
+
+
+end
+
+
+## --
+## merb-helpers-1.0/lib/merb-helpers/helper.rb
+## ++
+module Merb::Helpers::Form
+
+  ##--
+  ##def with_form_context(name, builder)
+  ##  form_contexts.push(_new_form_context(name, builder))
+  ##  ret = yield
+  ##  form_contexts.pop
+  ##  ret
+  ##end
+  ##++
+  def with_form_context(name, builder, index_by=nil)
+    form_contexts.push(c = _new_form_context(name, builder))
+    if index_by
+      c.instance_variable_set("@index_by", index_by) if index_by
+      index = c.instance_variable_get("@obj").__send__(index_by)
+      c.instance_variable_set("@index", index)
+    end
+    ret = yield
+    form_contexts.pop
+    ret
+  end
+
+  ##--
+  ##def form_for(name, attrs = {}, &blk)
+  ##  with_form_context(name, attrs.delete(:builder)) do
+  ##    current_form_context.form(attrs, &blk)
+  ##  end
+  ##end
+  ##++
+  def form_for(name, attrs = {}, &blk)
+    with_form_context(name, attrs.delete(:builder), attrs.delete(:index_by)) do
+      current_form_context.form(attrs, &blk)
+    end
+  end
+
+  ##--
+  ##def fields_for(name, attrs = {}, &blk)
+  ##  attrs ||= {}
+  ##  with_form_context(name, attrs.delete(:builder)) do
+  ##    capture(&blk)
+  ##  end
+  ##end
+  ##++
+  def fields_for(name, attrs = {}, &blk)
+    attrs ||= {}
+    with_form_context(name, attrs.delete(:builder), attrs.delete(:index_by)) do
+      capture(&blk)
+    end
+  end
+
+  ##--
+  ##def fieldset_for(name, attrs = {}, &blk)
+  ##  with_form_context(name, attrs.delete(:builder), attrs.delete(:index_by)) do
+  ##    current_form_context.fieldset(attrs, &blk)
+  ##  end
+  ##end
+  ##++
+  def fieldset_for(name, attrs = {}, &blk)
+    with_form_context(name, attrs.delete(:builder)) do
+      current_form_context.fieldset(attrs, &blk)
+    end
+  end
+
+
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification 
+name: merb_helpers_monkey
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- makoto kuwata
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-12-21 00:00:00 +09:00
+default_executable: 
+dependencies: []
+
+description: "Merb_helpers_monkey is a Merb plug-in to extend the followng helper methods defined in merb-helpers: * radio_button() - to take boolean value as :checked option. * field_for(), form_for(), fieldset_for() - to take new :index_by option."
+email: kwa(at)kuwata-lab.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.txt
+- MIT-LICENSE
+- lib/merb_helpers_monkey.rb
+has_rdoc: false
+homepage: http://github.com/kwatch/merb_helpers_monkey
+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: merb_helpers_monkey
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: extends some helper methods defined in merb-helpers.
+test_files: []
+