simple_form 2.1.3 → 3.0.0

data/lib/simple_form/form_builder.rb.orig

@@ -0,0 +1,486 @@
+<<<<<<< HEAD
+require 'simple_form/core_ext/hash'
+=======
+require 'active_support/core_ext/object/deep_dup'
+require 'simple_form/map_type'
+>>>>>>> beeac4d... These modules don't need to be autoloaded
+
+module SimpleForm
+  class FormBuilder < ActionView::Helpers::FormBuilder
+    attr_reader :template, :object_name, :object, :wrapper
+
+    # When action is create or update, we still should use new and edit
+    ACTIONS = {
+      :create => :new,
+      :update => :edit
+    }
+
+    extend MapType
+    include SimpleForm::Inputs
+
+    map_type :text,                                :to => SimpleForm::Inputs::TextInput
+    map_type :file,                                :to => SimpleForm::Inputs::FileInput
+    map_type :string, :email, :search, :tel, :url, :to => SimpleForm::Inputs::StringInput
+    map_type :password,                            :to => SimpleForm::Inputs::PasswordInput
+    map_type :integer, :decimal, :float,           :to => SimpleForm::Inputs::NumericInput
+    map_type :range,                               :to => SimpleForm::Inputs::RangeInput
+    map_type :check_boxes,                         :to => SimpleForm::Inputs::CollectionCheckBoxesInput
+    map_type :radio_buttons,                       :to => SimpleForm::Inputs::CollectionRadioButtonsInput
+    map_type :select,                              :to => SimpleForm::Inputs::CollectionSelectInput
+    map_type :grouped_select,                      :to => SimpleForm::Inputs::GroupedCollectionSelectInput
+    map_type :date, :time, :datetime,              :to => SimpleForm::Inputs::DateTimeInput
+    map_type :country, :time_zone,                 :to => SimpleForm::Inputs::PriorityInput
+    map_type :boolean,                             :to => SimpleForm::Inputs::BooleanInput
+
+    def self.discovery_cache
+      @discovery_cache ||= {}
+    end
+
+    def initialize(*) #:nodoc:
+      super
+      @defaults = options[:defaults]
+      @wrapper  = SimpleForm.wrapper(options[:wrapper] || SimpleForm.default_wrapper)
+    end
+
+    # Basic input helper, combines all components in the stack to generate
+    # input html based on options the user define and some guesses through
+    # database column information. By default a call to input will generate
+    # label + input + hint (when defined) + errors (when exists), and all can
+    # be configured inside a wrapper html.
+    #
+    # == Examples
+    #
+    #   # Imagine @user has error "can't be blank" on name
+    #   simple_form_for @user do |f|
+    #     f.input :name, :hint => 'My hint'
+    #   end
+    #
+    # This is the output html (only the input portion, not the form):
+    #
+    #     <label class="string required" for="user_name">
+    #       <abbr title="required">*</abbr> Super User Name!
+    #     </label>
+    #     <input class="string required" id="user_name" maxlength="100"
+    #        name="user[name]" size="100" type="text" value="Carlos" />
+    #     <span class="hint">My hint</span>
+    #     <span class="error">can't be blank</span>
+    #
+    # Each database type will render a default input, based on some mappings and
+    # heuristic to determine which is the best option.
+    #
+    # You have some options for the input to enable/disable some functions:
+    #
+    #   :as => allows you to define the input type you want, for instance you
+    #          can use it to generate a text field for a date column.
+    #
+    #   :required => defines whether this attribute is required or not. True
+    #               by default.
+    #
+    # The fact SimpleForm is built in components allow the interface to be unified.
+    # So, for instance, if you need to disable :hint for a given input, you can pass
+    # :hint => false. The same works for :error, :label and :wrapper.
+    #
+    # Besides the html for any component can be changed. So, if you want to change
+    # the label html you just need to give a hash to :label_html. To configure the
+    # input html, supply :input_html instead and so on.
+    #
+    # == Options
+    #
+    # Some inputs, as datetime, time and select allow you to give extra options, like
+    # prompt and/or include blank. Such options are given in plainly:
+    #
+    #    f.input :created_at, :include_blank => true
+    #
+    # == Collection
+    #
+    # When playing with collections (:radio_buttons, :check_boxes and :select
+    # inputs), you have three extra options:
+    #
+    #   :collection => use to determine the collection to generate the radio or select
+    #
+    #   :label_method => the method to apply on the array collection to get the label
+    #
+    #   :value_method => the method to apply on the array collection to get the value
+    #
+    # == Priority
+    #
+    # Some inputs, as :time_zone and :country accepts a :priority option. If none is
+    # given SimpleForm.time_zone_priority and SimpleForm.country_priority are used respectively.
+    #
+    def input(attribute_name, options={}, &block)
+      options = @defaults.deep_dup.deep_merge(options) if @defaults
+      input = find_input(attribute_name, options, &block)
+
+      chosen =
+        if name = options[:wrapper] || find_wrapper_mapping(input.input_type)
+          name.respond_to?(:render) ? name : SimpleForm.wrapper(name)
+        else
+          wrapper
+        end
+
+      chosen.render input
+    end
+    alias :attribute :input
+
+    # Creates a input tag for the given attribute. All the given options
+    # are sent as :input_html.
+    #
+    # == Examples
+    #
+    #   simple_form_for @user do |f|
+    #     f.input_field :name
+    #   end
+    #
+    # This is the output html (only the input portion, not the form):
+    #
+    #     <input class="string required" id="user_name" maxlength="100"
+    #        name="user[name]" size="100" type="text" value="Carlos" />
+    #
+    def input_field(attribute_name, options={})
+      options = options.dup
+      options[:input_html] = options.except(:as, :collection, :label_method, :value_method)
+      options = @defaults.deep_dup.deep_merge(options) if @defaults
+
+      SimpleForm::Wrappers::Root.new([:input], :wrapper => false).render find_input(attribute_name, options)
+    end
+
+    # Helper for dealing with association selects/radios, generating the
+    # collection automatically. It's just a wrapper to input, so all options
+    # supported in input are also supported by association. Some extra options
+    # can also be given:
+    #
+    # == Examples
+    #
+    #   simple_form_for @user do |f|
+    #     f.association :company          # Company.all
+    #   end
+    #
+    #   f.association :company, :collection => Company.all(:order => 'name')
+    #   # Same as using :order option, but overriding collection
+    #
+    # == Block
+    #
+    # When a block is given, association simple behaves as a proxy to
+    # simple_fields_for:
+    #
+    #   f.association :company do |c|
+    #     c.input :name
+    #     c.input :type
+    #   end
+    #
+    # From the options above, only :collection can also be supplied.
+    #
+    def association(association, options={}, &block)
+      options = options.dup
+
+      return simple_fields_for(*[association,
+        options.delete(:collection), options].compact, &block) if block_given?
+
+      raise ArgumentError, "Association cannot be used in forms not associated with an object" unless @object
+
+      reflection = find_association_reflection(association)
+      raise "Association #{association.inspect} not found" unless reflection
+
+      options[:as] ||= :select
+      options[:collection] ||= options.fetch(:collection) {
+        reflection.klass.all(reflection.options.slice(:conditions, :order))
+      }
+
+      attribute = case reflection.macro
+        when :belongs_to
+          (reflection.respond_to?(:options) && reflection.options[:foreign_key]) || :"#{reflection.name}_id"
+        when :has_one
+          raise ArgumentError, ":has_one associations are not supported by f.association"
+        else
+          if options[:as] == :select
+            html_options = options[:input_html] ||= {}
+            html_options[:size]   ||= 5
+            html_options[:multiple] = true unless html_options.key?(:multiple)
+          end
+
+          # Force the association to be preloaded for performance.
+          if options[:preload] != false && object.respond_to?(association)
+            target = object.send(association)
+            target.to_a if target.respond_to?(:to_a)
+          end
+
+          :"#{reflection.name.to_s.singularize}_ids"
+      end
+
+      input(attribute, options.merge(:reflection => reflection))
+    end
+
+    # Creates a button:
+    #
+    #   form_for @user do |f|
+    #     f.button :submit
+    #   end
+    #
+    # It just acts as a proxy to method name given. We also alias original Rails
+    # button implementation (3.2 forward (to delegate to the original when
+    # calling `f.button :button`.
+    #
+    # TODO: remove if condition when supporting only Rails 3.2 forward.
+    alias_method :button_button, :button if method_defined?(:button)
+    def button(type, *args, &block)
+      options = args.extract_options!.dup
+      options[:class] = [SimpleForm.button_class, options[:class]].compact
+      args << options
+      if respond_to?("#{type}_button")
+        send("#{type}_button", *args, &block)
+      else
+        send(type, *args, &block)
+      end
+    end
+
+    # Creates an error tag based on the given attribute, only when the attribute
+    # contains errors. All the given options are sent as :error_html.
+    #
+    # == Examples
+    #
+    #    f.error :name
+    #    f.error :name, :id => "cool_error"
+    #
+    def error(attribute_name, options={})
+      options = options.dup
+
+      options[:error_html] = options.except(:error_tag, :error_prefix, :error_method)
+      column      = find_attribute_column(attribute_name)
+      input_type  = default_input_type(attribute_name, column, options)
+      wrapper.find(:error).
+        render(SimpleForm::Inputs::Base.new(self, attribute_name, column, input_type, options))
+    end
+
+    # Return the error but also considering its name. This is used
+    # when errors for a hidden field need to be shown.
+    #
+    # == Examples
+    #
+    #    f.full_error :token #=> <span class="error">Token is invalid</span>
+    #
+    def full_error(attribute_name, options={})
+      options = options.dup
+
+      options[:error_prefix] ||= if object.class.respond_to?(:human_attribute_name)
+        object.class.human_attribute_name(attribute_name.to_s)
+      else
+        attribute_name.to_s.humanize
+      end
+
+      error(attribute_name, options)
+    end
+
+    # Creates a hint tag for the given attribute. Accepts a symbol indicating
+    # an attribute for I18n lookup or a string. All the given options are sent
+    # as :hint_html.
+    #
+    # == Examples
+    #
+    #    f.hint :name # Do I18n lookup
+    #    f.hint :name, :id => "cool_hint"
+    #    f.hint "Don't forget to accept this"
+    #
+    def hint(attribute_name, options={})
+      options = options.dup
+
+      options[:hint_html] = options.except(:hint_tag, :hint)
+      if attribute_name.is_a?(String)
+        options[:hint] = attribute_name
+        attribute_name, column, input_type = nil, nil, nil
+      else
+        column      = find_attribute_column(attribute_name)
+        input_type  = default_input_type(attribute_name, column, options)
+      end
+
+      wrapper.find(:hint).
+        render(SimpleForm::Inputs::Base.new(self, attribute_name, column, input_type, options))
+    end
+
+    # Creates a default label tag for the given attribute. You can give a label
+    # through the :label option or using i18n. All the given options are sent
+    # as :label_html.
+    #
+    # == Examples
+    #
+    #    f.label :name                     # Do I18n lookup
+    #    f.label :name, "Name"             # Same behavior as Rails, do not add required tag
+    #    f.label :name, :label => "Name"   # Same as above, but adds required tag
+    #
+    #    f.label :name, :required => false
+    #    f.label :name, :id => "cool_label"
+    #
+    def label(attribute_name, *args)
+      return super if args.first.is_a?(String) || block_given?
+
+      options = args.extract_options!.dup
+      options[:label_html] = options.except(:label, :required, :as)
+
+      column      = find_attribute_column(attribute_name)
+      input_type  = default_input_type(attribute_name, column, options)
+      SimpleForm::Inputs::Base.new(self, attribute_name, column, input_type, options).label
+    end
+
+    # Creates an error notification message that only appears when the form object
+    # has some error. You can give a specific message with the :message option,
+    # otherwise it will look for a message using I18n. All other options given are
+    # passed straight as html options to the html tag.
+    #
+    # == Examples
+    #
+    #    f.error_notification
+    #    f.error_notification :message => 'Something went wrong'
+    #    f.error_notification :id => 'user_error_message', :class => 'form_error'
+    #
+    def error_notification(options={})
+      SimpleForm::ErrorNotification.new(self, options).render
+    end
+
+    # Extract the model names from the object_name mess, ignoring numeric and
+    # explicit child indexes.
+    #
+    # Example:
+    #
+    # route[blocks_attributes][0][blocks_learning_object_attributes][1][foo_attributes]
+    # ["route", "blocks", "blocks_learning_object", "foo"]
+    #
+    def lookup_model_names
+      @lookup_model_names ||= begin
+        child_index = options[:child_index]
+        names = object_name.to_s.scan(/([a-zA-Z_]+)/).flatten
+        names.delete(child_index) if child_index
+        names.each { |name| name.gsub!('_attributes', '') }
+        names.freeze
+      end
+    end
+
+    # The action to be used in lookup.
+    def lookup_action
+      @lookup_action ||= begin
+        action = template.controller.action_name
+        return unless action
+        action = action.to_sym
+        ACTIONS[action] || action
+      end
+    end
+
+    private
+
+    # Find an input based on the attribute name.
+    def find_input(attribute_name, options={}, &block) #:nodoc:
+      column     = find_attribute_column(attribute_name)
+      input_type = default_input_type(attribute_name, column, options)
+
+      if input_type == :radio
+        SimpleForm.deprecation_warn "Using `:as => :radio` as input type is " \
+          "deprecated, please change it to `:as => :radio_buttons`."
+        input_type = :radio_buttons
+      end
+
+      if block_given?
+        SimpleForm::Inputs::BlockInput.new(self, attribute_name, column, input_type, options, &block)
+      else
+        find_mapping(input_type).new(self, attribute_name, column, input_type, options)
+      end
+    end
+
+    # Attempt to guess the better input type given the defined options. By
+    # default alwayls fallback to the user :as option, or to a :select when a
+    # collection is given.
+    def default_input_type(attribute_name, column, options) #:nodoc:
+      return options[:as].to_sym if options[:as]
+      return :select             if options[:collection]
+      custom_type = find_custom_type(attribute_name.to_s) and return custom_type
+
+      input_type = column.try(:type)
+      case input_type
+      when :timestamp
+        :datetime
+      when :string, nil
+        case attribute_name.to_s
+        when /password/  then :password
+        when /time_zone/ then :time_zone
+        when /country/   then :country
+        when /email/     then :email
+        when /phone/     then :tel
+        when /url/       then :url
+        else
+          file_method?(attribute_name) ? :file : (input_type || :string)
+        end
+      else
+        input_type
+      end
+    end
+
+    def find_custom_type(attribute_name) #:nodoc:
+      SimpleForm.input_mappings.find { |match, type|
+        attribute_name =~ match
+      }.try(:last) if SimpleForm.input_mappings
+    end
+
+    def file_method?(attribute_name) #:nodoc:
+      file = @object.send(attribute_name) if @object.respond_to?(attribute_name)
+      file && SimpleForm.file_methods.any? { |m| file.respond_to?(m) }
+    end
+
+    def find_attribute_column(attribute_name) #:nodoc:
+      if @object.respond_to?(:column_for_attribute)
+        @object.column_for_attribute(attribute_name)
+      end
+    end
+
+    def find_association_reflection(association) #:nodoc:
+      if @object.class.respond_to?(:reflect_on_association)
+        @object.class.reflect_on_association(association)
+      end
+    end
+
+    # Attempts to find a mapping. It follows the following rules:
+    #
+    # 1) It tries to find a registered mapping, if succeeds:
+    #    a) Try to find an alternative with the same name in the Object scope
+    #    b) Or use the found mapping
+    # 2) If not, fallbacks to #{input_type}Input
+    # 3) If not, fallbacks to SimpleForm::Inputs::#{input_type}Input
+    def find_mapping(input_type) #:nodoc:
+      discovery_cache[input_type] ||=
+        if mapping = self.class.mappings[input_type]
+          mapping_override(mapping) || mapping
+        else
+          camelized = "#{input_type.to_s.camelize}Input"
+          attempt_mapping(camelized, Object) || attempt_mapping(camelized, self.class) ||
+            raise("No input found for #{input_type}")
+        end
+    end
+
+    def find_wrapper_mapping(input_type) #:nodoc:
+      SimpleForm.wrapper_mappings && SimpleForm.wrapper_mappings[input_type]
+    end
+
+    # If cache_discovery is enabled, use the class level cache that persists
+    # between requests, otherwise use the instance one.
+    def discovery_cache #:nodoc:
+      if SimpleForm.cache_discovery
+        self.class.discovery_cache
+      else
+        @discovery_cache ||= {}
+      end
+    end
+
+    def mapping_override(klass) #:nodoc:
+      name = klass.name
+      if name =~ /^SimpleForm::Inputs/
+        attempt_mapping name.split("::").last, Object
+      end
+    end
+
+    def attempt_mapping(mapping, at) #:nodoc:
+      return if SimpleForm.inputs_discovery == false && at == Object
+
+      begin
+        at.const_get(mapping)
+      rescue NameError => e
+        raise if e.message !~ /#{mapping}$/
+      end
+    end
+  end
+end

data/lib/simple_form/helpers.rb

@@ -1,7 +1,7 @@
 module SimpleForm
   # Helpers are made of several helpers that cannot be turned on automatically.
   # For instance, disabled cannot be turned on automatically, it requires the
-  # user to explicitly pass the option :disabled => true so it may work.
+  # user to explicitly pass the option disabled: true so it may work.
   module Helpers
     autoload :Autofocus,    'simple_form/helpers/autofocus'
     autoload :Disabled,     'simple_form/helpers/disabled'

data/lib/simple_form/inputs/base.rb

@@ -1,11 +1,8 @@
 require 'simple_form/i18n_cache'
-require 'active_support/core_ext/string/output_safety'
 
 module SimpleForm
   module Inputs
     class Base
-      include ERB::Util
-
       extend I18nCache
 
       include SimpleForm::Helpers::Autofocus
@@ -27,7 +24,7 @@ module SimpleForm
       attr_reader :attribute_name, :column, :input_type, :reflection,
                   :options, :input_html_options, :input_html_classes, :html_classes
 
-      delegate :template, :object, :object_name, :lookup_model_names, :lookup_action, :to => :@builder
+      delegate :template, :object, :object_name, :lookup_model_names, :lookup_action, to: :@builder
 
       class_attribute :default_options
       self.default_options = {}
@@ -45,7 +42,7 @@ module SimpleForm
       end
 
       # Always enabled.
-      enable :hint, :error
+      enable :hint
 
       # Usually disabled, needs to be enabled explicitly passing true as option.
       disable :maxlength, :placeholder, :pattern, :min_max
@@ -68,6 +65,10 @@ module SimpleForm
         @html_classes = SimpleForm.additional_classes_for(:input) { additional_classes }
 
         @input_html_classes = @html_classes.dup
+        if SimpleForm.input_class && !input_html_classes.empty?
+          input_html_classes << SimpleForm.input_class
+        end
+
         @input_html_options = html_options_for(:input, input_html_classes).tap do |o|
           o[:readonly]  = true if has_readonly?
           o[:disabled]  = true if has_disabled?
@@ -93,10 +94,6 @@ module SimpleForm
 
       private
 
-      def add_size!
-        input_html_options[:size] ||= [limit, SimpleForm.default_input_size].compact.min
-      end
-
       def limit
         if column
           decimal_or_float? ? decimal_limit : column_limit
@@ -182,7 +179,7 @@ module SimpleForm
         lookups << :"defaults.#{reflection_or_attribute_name}"
         lookups << default
 
-        I18n.t(lookups.shift, :scope => :"simple_form.#{namespace}", :default => lookups).presence
+        I18n.t(lookups.shift, scope: :"simple_form.#{namespace}", default: lookups).presence
       end
     end
   end

data/lib/simple_form/inputs/block_input.rb

@@ -11,4 +11,4 @@ module SimpleForm
       end
     end
   end
-end
+end

data/lib/simple_form/inputs/boolean_input.rb

@@ -4,7 +4,7 @@ module SimpleForm
       def input
         if nested_boolean_style?
           build_hidden_field_for_checkbox +
-            template.label_tag(nil, :class => "checkbox") {
+            template.label_tag(nil, class: "checkbox") {
               build_check_box_without_hidden_field + inline_label
             }
         else
@@ -35,7 +35,7 @@ module SimpleForm
       # reuse the method for nested boolean style, but with no unchecked value,
       # which won't generate the hidden checkbox. This is the default functionality
       # in Rails > 3.2.1, and is backported in SimpleForm AV helpers.
-      def build_check_box(unchecked_value = unchecked_value())
+      def build_check_box(unchecked_value = unchecked_value)
         @builder.check_box(attribute_name, input_html_options, checked_value, unchecked_value)
       end
 
@@ -50,9 +50,10 @@ module SimpleForm
       # we need the hidden field to be *outside* the label (otherwise it
       # generates invalid html - html5 only).
       def build_hidden_field_for_checkbox
-        @builder.hidden_field(attribute_name, :value => unchecked_value, :id => nil,
-                              :disabled => input_html_options[:disabled],
-                              :name => input_html_options[:name])
+        options = { value: unchecked_value, id: nil, disabled: input_html_options[:disabled] }
+        options[:name] = input_html_options[:name] if input_html_options.has_key?(:name)
+
+        @builder.hidden_field(attribute_name, options)
       end
 
       def inline_label

data/lib/simple_form/inputs/collection_input.rb

@@ -7,8 +7,8 @@ module SimpleForm
       # "simple_form.no" keys. See the example locale file.
       def self.boolean_collection
         i18n_cache :boolean_collection do
-          [ [I18n.t(:"simple_form.yes", :default => 'Yes'), true],
-            [I18n.t(:"simple_form.no", :default => 'No'), false] ]
+          [ [I18n.t(:"simple_form.yes", default: 'Yes'), true],
+            [I18n.t(:"simple_form.no", default: 'No'), false] ]
         end
       end
 
@@ -33,7 +33,7 @@ module SimpleForm
       end
 
       def has_required?
-        super && (input_options[:include_blank] || input_options[:prompt] || multiple?)
+        super && (input_options[:include_blank] || multiple?)
       end
 
       # Check if :include_blank must be included by default.
@@ -66,14 +66,14 @@ module SimpleForm
         collection_translated = translate_collection if collection_classes == [Symbol]
 
         if collection_translated || collection_classes.include?(Array)
-          { :label => :first, :value => :last }
+          { label: :first, value: :second }
         elsif collection_includes_basic_objects?(collection_classes)
-          { :label => :to_s, :value => :to_s }
+          { label: :to_s, value: :to_s }
         else
           sample = collection.first || collection.last
 
-          { :label => SimpleForm.collection_label_methods.find { |m| sample.respond_to?(m) },
-            :value => SimpleForm.collection_value_methods.find { |m| sample.respond_to?(m) } }
+          { label: SimpleForm.collection_label_methods.find { |m| sample.respond_to?(m) },
+            value: SimpleForm.collection_value_methods.find { |m| sample.respond_to?(m) } }
         end
       end
 

data/lib/simple_form/inputs/date_time_input.rb

@@ -11,7 +11,7 @@ module SimpleForm
         position = case input_type
         when :date, :datetime
           date_order = input_options[:order] || I18n.t('date.order')
-          date_order.first
+          date_order.first.to_sym
         else
           :hour
         end

data/lib/simple_form/inputs/numeric_input.rb

@@ -4,7 +4,6 @@ module SimpleForm
       enable :placeholder, :min_max
 
       def input
-        add_size!
         input_html_classes.unshift("numeric")
         if html5?
           input_html_options[:type] ||= "number"
@@ -14,11 +13,6 @@ module SimpleForm
       end
 
       private
-
-      # Rails adds the size attr by default, if the :size key does not exist.
-      def add_size!
-        input_html_options[:size] ||= nil
-      end
     end
   end
 end

data/lib/simple_form/inputs/password_input.rb

@@ -4,7 +4,6 @@ module SimpleForm
       enable :placeholder, :maxlength
 
       def input
-        add_size!
         @builder.password_field(attribute_name, input_html_options)
       end
     end

data/lib/simple_form/inputs/string_input.rb

@@ -9,7 +9,6 @@ module SimpleForm
           input_html_options[:type] ||= input_type if html5?
         end
 
-        add_size!
         @builder.text_field(attribute_name, input_html_options)
       end
 

data/lib/simple_form/railtie.rb

@@ -0,0 +1,7 @@
+require 'rails/railtie'
+
+module SimpleForm
+  class Railtie < Rails::Railtie
+    config.eager_load_namespaces << SimpleForm
+  end
+end