formtastic 3.1.3 → 5.0.0

data/RELEASE_PROCESS

@@ -1,4 +1,6 @@
-# edit version.rb
+# review and edit CHANGELOG
+# review & edit README
+# edit lib/formtastic/version.rb
 git ci -am "version bump"                  # commit changes
 git tag X.X.X                              # tag the new version in the code base too
 gem build formtastic.gemspec               # build the gem

data/Rakefile

@@ -1,6 +1,5 @@
 # encoding: utf-8
 require 'bundler/setup'
-require 'appraisal'
 require 'yard'
 require 'rspec/core/rake_task'
 
@@ -13,6 +12,26 @@ else
   task :default => :spec
 end
 
+desc 'Run the default task over all gemfiles.'
+task :appraisal do
+  for_all_gemfiles("exec", "rake")
+end
+
+namespace :appraisal do
+  desc 'Run `bundle install` over all gemfiles.'
+  task :install do
+    for_all_gemfiles("install")
+  end
+end
+
+def for_all_gemfiles(*args)
+  Dir.glob("gemfiles/*/Gemfile").sort.each do |gemfile|
+    Bundler.with_original_env do
+      sh({ "APPRAISAL_INITIALIZED" => "true", "BUNDLE_GEMFILE" => gemfile }, "bundle", *args)
+    end
+  end
+end
+
 desc 'Generate documentation for the formtastic plugin.'
 YARD::Rake::YardocTask.new(:yard) do |t|
 

data/app/assets/stylesheets/formtastic.css

@@ -223,7 +223,7 @@ This stylesheet forms part of the Formtastic Rails Plugin
 /* BOOLEAN LABELS
 --------------------------------------------------------------------------------------------------*/
 .formtastic .boolean label {
-  padding-left:25%;
+  margin-left:25%;
   display:block;
 }
 

data/bin/appraisal

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+if [ "$1" = "" ]
+then
+  bundle exec rake appraisal
+else
+  bundle exec rake "appraisal:$1"
+fi

data/formtastic.gemspec

@@ -8,35 +8,31 @@ Gem::Specification.new do |s|
   s.platform    = Gem::Platform::RUBY
   s.authors     = [%q{Justin French}]
   s.email       = [%q{justin@indent.com.au}]
-  s.homepage    = %q{http://github.com/justinfrench/formtastic}
+  s.homepage    = %q{http://github.com/formtastic/formtastic}
   s.summary     = %q{A Rails form builder plugin/gem with semantically rich and accessible markup}
   s.description = %q{A Rails form builder plugin/gem with semantically rich and accessible markup}
   s.license     = 'MIT'
 
   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.executables   = []
   s.require_paths = ["lib"]
 
   s.rdoc_options = ["--charset=UTF-8"]
-  s.extra_rdoc_files = ["README.textile"]
+  s.extra_rdoc_files = ["README.md"]
 
-  s.required_ruby_version = '>= 1.9.3'
+  s.required_ruby_version = '>= 2.6.0'
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.rubygems_version = %q{1.3.6}
 
-  s.add_dependency(%q<actionpack>, [">= 3.2.13"])
+  s.add_dependency(%q<actionpack>, [">= 6.0.0"])
 
-  s.add_development_dependency(%q<nokogiri>)
-  s.add_development_dependency(%q<rspec-rails>, ["~> 2.14"])
-  s.add_development_dependency(%q<rspec_tag_matchers>, ["~> 1.0"])
-  s.add_development_dependency(%q<hpricot>, ["~> 0.8.3"])
-  s.add_development_dependency(%q<RedCloth>, ["~> 4.2"]) # for YARD Textile formatting
-  s.add_development_dependency(%q<yard>, ["~> 0.8"])
-  s.add_development_dependency(%q<colored>, ["~> 1.2"])
-  s.add_development_dependency(%q<tzinfo>)
-  s.add_development_dependency(%q<ammeter>, ["1.1.1"])
-  s.add_development_dependency(%q<appraisal>, ["~> 1.0"])
+  s.add_development_dependency(%q<rspec-rails>, [">= 4.0"])
+  s.add_development_dependency(%q<rspec-dom-testing>, [">= 0.1.0"])
+  s.add_development_dependency(%q<rspec-mocks>, ["~> 3.12.2"])
+
+  s.add_development_dependency(%q<yard>, ["~> 0.9.20"])
+  s.add_development_dependency(%q<ammeter>, ["~> 1.1.3"])
   s.add_development_dependency(%q<rake>)
-  s.add_development_dependency(%q<activemodel>, [">= 3.2.13"])
+  s.add_development_dependency(%q<sqlite3>, ["~> 1.4"])
 end

data/gemfiles/rails_6.0/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "rails", "~> 6.0.2"
+
+gemspec path: "../.."

data/gemfiles/rails_6.1/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "rails", "~> 6.1.0"
+
+gemspec path: "../.."

data/gemfiles/rails_7.0/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "rails", "~> 7.0.0"
+
+gemspec path: "../.."

data/gemfiles/rails_7.1/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "rails", "~> 7.1.0"
+
+gemspec path: "../.."

data/gemfiles/rails_edge/Gemfile

@@ -0,0 +1,13 @@
+source "https://rubygems.org"
+
+gem "rails", git: "https://github.com/rails/rails.git", branch: "main"
+gem "rack", git: "https://github.com/rack/rack.git"
+gem "i18n", git: "https://github.com/svenfuchs/i18n.git"
+gem "arel", git: "https://github.com/rails/arel.git"
+gem "rspec-rails", git: "https://github.com/rspec/rspec-rails.git"
+gem "rspec-mocks", git: "https://github.com/rspec/rspec-mocks.git"
+gem "rspec-support", git: "https://github.com/rspec/rspec-support.git"
+gem "rspec-core", git: "https://github.com/rspec/rspec-core.git"
+gem "rspec-expectations", git: "https://github.com/rspec/rspec-expectations.git"
+
+gemspec path: "../.."

data/lib/formtastic/action_class_finder.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
 
   # Uses the {NamespacedClassFinder} to look up action class names.

data/lib/formtastic/actions/base.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
   module Actions
     module Base

data/lib/formtastic/actions/button_action.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
   module Actions
 

data/lib/formtastic/actions/buttonish.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
   module Actions
     module Buttonish

data/lib/formtastic/actions/input_action.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
   module Actions
 

data/lib/formtastic/actions/link_action.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
   module Actions
   # Outputs a link wrapped in the standard `<li>` wrapper. This the default for `:cancel` actions.

data/lib/formtastic/actions.rb

@@ -1,11 +1,15 @@
+# frozen_string_literal: true
 module Formtastic
   module Actions
     extend ActiveSupport::Autoload
 
     autoload :Base
     autoload :Buttonish
-    autoload :InputAction
-    autoload :LinkAction
-    autoload :ButtonAction
+
+    eager_autoload do
+      autoload :InputAction
+      autoload :LinkAction
+      autoload :ButtonAction
+    end
   end
 end

data/lib/formtastic/deprecation.rb

@@ -1,42 +1,6 @@
+# frozen_string_literal: true
 require 'active_support/deprecation'
 
 module Formtastic
-  if ActiveSupport::Deprecation.respond_to?(:new)
-    Deprecation = ActiveSupport::Deprecation
-  else
-    require 'forwardable'
-
-    # @private
-    # @todo remove this branch and file when support for rails 3.2 is dropped
-    class Deprecation
-      mattr_accessor :deprecation
-      self.deprecation = ActiveSupport::Deprecation.dup
-
-      extend Forwardable
-      methods = deprecation.methods - deprecation.class.methods
-      def_delegators :deprecation, *methods
-
-      def initialize(version, _library)
-        deprecation.silenced = false
-        deprecation.deprecation_horizon = version
-      end
-
-      def deprecation_warning(deprecated_method_name, message = nil, caller_backtrace = nil)
-        caller_backtrace ||= caller(2)
-
-        deprecated_method_warning(deprecated_method_name, message).tap do |msg|
-          warn(msg, caller_backtrace)
-        end
-      end
-
-      def deprecated_method_warning(method_name, message = nil)
-        warning = "#{method_name} is deprecated and will be removed from Formtastic #{deprecation_horizon}"
-        case message
-          when Symbol then "#{warning} (use #{message} instead)"
-          when String then "#{warning} (#{message})"
-          else warning
-        end
-      end
-    end
-  end
+  Deprecation = ActiveSupport::Deprecation.new("5.0.0", "Formtastic")
 end

data/lib/formtastic/engine.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
   # Required for formtastic.css to be discoverable in the asset pipeline
   # @private
@@ -7,5 +8,7 @@ module Formtastic
         include Formtastic::Helpers::FormHelper
       end
     end
+
+    config.eager_load_namespaces << Formtastic
   end
-end
+end

data/lib/formtastic/form_builder.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
   class FormBuilder < ActionView::Helpers::FormBuilder
 
@@ -21,7 +22,7 @@ module Formtastic
     configure :default_text_area_width
     configure :all_fields_required_by_default, true
     configure :include_blank_for_select_by_default, true
-    configure :required_string, proc { Formtastic::Util.html_safe(%{<abbr title="#{Formtastic::I18n.t(:required)}">*</abbr>}) }
+    configure :required_string, proc { %{<abbr title="#{Formtastic::I18n.t(:required)}">*</abbr>}.html_safe }
     configure :optional_string, ''
     configure :inline_errors, :sentence
     configure :label_str_method, :humanize
@@ -42,14 +43,13 @@ module Formtastic
     configure :perform_browser_validations, false
     # Check {Formtastic::InputClassFinder} to see how are inputs resolved.
     configure :input_namespaces, [::Object, ::Formtastic::Inputs]
-    # @todo enable this as default in 4.0 and remove it from configuration generator template
-    # Will be {Formtastic::InputClassFinder} by default in 4.0.
-    configure :input_class_finder #, Formtastic::InputClassFinder
+    configure :input_class_finder, Formtastic::InputClassFinder
     # Check {Formtastic::ActionClassFinder} to see how are inputs resolved.
     configure :action_namespaces, [::Object, ::Formtastic::Actions]
-    # @todo enable this as default in 4.0 and remove it from configuration generator template
-    # Will be {Formtastic::ActionClassFinder} by default in 4.0.
-    configure :action_class_finder#, Formtastic::ActionClassFinder
+    configure :action_class_finder, Formtastic::ActionClassFinder
+
+    configure :skipped_columns, [:created_at, :updated_at, :created_on, :updated_on, :lock_version, :version]
+    configure :priority_time_zones, []
 
     attr_reader :template
 
@@ -65,8 +65,8 @@ module Formtastic
 
     # This is a wrapper around Rails' `ActionView::Helpers::FormBuilder#fields_for`, originally
     # provided to ensure that the `:builder` from `semantic_form_for` was passed down into
-    # the nested `fields_for`. Rails 3 no longer requires us to do this, so this method is
-    # provided purely for backwards compatibility and DSL consistency.
+    # the nested `fields_for`. Our supported versions of Rails no longer require us to do this,
+    # so this method is provided purely for backwards compatibility and DSL consistency.
     #
     # When constructing a `fields_for` form fragment *outside* of `semantic_form_for`, please use
     # `Formtastic::Helpers::FormHelper#semantic_fields_for`.
@@ -92,23 +92,11 @@ module Formtastic
     #
     # @todo is there a way to test the params structure of the Rails helper we wrap to ensure forward compatibility?
     def semantic_fields_for(record_or_name_or_array, *args, &block)
-      # Add a :parent_builder to the args so that nested translations can be possible in Rails 3
-      options = args.extract_options!
-      options[:parent_builder] ||= self
-
-      # Wrap the Rails helper
-      fields_for(record_or_name_or_array, *(args << options), &block)
+      fields_for(record_or_name_or_array, *args, &block)
     end
 
-    def initialize(object_name, object, template, options, block=nil)
-      # rails 3 supported passing in the block parameter to FormBuilder
-      # rails 4.0 deprecated the block parameter and does nothing with it
-      # rails 4.1 removes the parameter completely
-      if Util.rails3? || Util.rails4_0?
-        super
-      else # Must be rails4_1 or greater
-        super object_name, object, template, options
-      end
+    def initialize(object_name, object, template, options)
+      super
 
       if respond_to?('multipart=') && options.is_a?(Hash) && options[:html]
         self.multipart = options[:html][:multipart]

data/lib/formtastic/helpers/action_helper.rb

@@ -1,10 +1,8 @@
 # -*- coding: utf-8 -*-
+# frozen_string_literal: true
 module Formtastic
   module Helpers
     module ActionHelper
-      ACTION_CLASS_DEPRECATION = 'configure Formtastic::FormBuilder.action_class_finder instead (upgrade guide on wiki: http://bit.ly/1F9QtKc )'.freeze
-      private_constant(:ACTION_CLASS_DEPRECATION)
-
       # Renders an action for the form (such as a subit/reset button, or a cancel link).
       #
       # Each action is wrapped in an `<li class="action">` tag with other classes added based on the
@@ -82,7 +80,7 @@ module Formtastic
         options = options.dup # Allow options to be shared without being tainted by Formtastic
         options[:as] ||= default_action_type(method, options)
 
-        klass = action_class(options[:as])
+        klass = namespaced_action_class(options[:as])
 
         klass.new(self, template, @object, @object_name, method, options).to_html
       end
@@ -113,50 +111,6 @@ module Formtastic
       rescue Formtastic::ActionClassFinder::NotFoundError => e
         raise Formtastic::UnknownActionError, "Unable to find action #{e.message}"
       end
-
-      # @api private
-      # @deprecated Use {#namespaced_action_class} instead.
-      def action_class(as)
-        return namespaced_action_class(as) if action_class_finder
-
-        action_class_deprecation_warning(__method__)
-
-        @input_classes_cache ||= {}
-        @input_classes_cache[as] ||= begin
-          begin
-            begin
-              custom_action_class_name(as).constantize
-            rescue NameError
-              standard_action_class_name(as).constantize
-            end
-          rescue NameError
-            raise Formtastic::UnknownActionError, "Unable to find action #{as}"
-          end
-        end
-      end
-
-      # @api private
-      # @deprecated Use {Formtastic::ActionClassFinder#class_name} instead.
-      # :as => :button # => ButtonAction
-      def custom_action_class_name(as)
-        action_class_deprecation_warning(__method__)
-        "#{as.to_s.camelize}Action"
-      end
-
-      # @api private
-      # @deprecated Use {Formtastic::ActionClassFinder#class_name} instead.
-      # :as => :button # => Formtastic::Actions::ButtonAction
-      def standard_action_class_name(as)
-        action_class_deprecation_warning(__method__)
-        "Formtastic::Actions::#{as.to_s.camelize}Action"
-      end
-
-      private
-
-      def action_class_deprecation_warning(method)
-        @action_class_deprecation_warned ||=
-            Formtastic.deprecation.deprecation_warning(method, ACTION_CLASS_DEPRECATION, caller(2))
-      end
     end
   end
 end

data/lib/formtastic/helpers/actions_helper.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
   module Helpers
     # ActionsHelper encapsulates the responsibilties of the {#actions} DSL for acting on 

data/lib/formtastic/helpers/enum.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+module Formtastic
+  module Helpers
+    # @private
+    module Enum
+      # Returns the enum (if defined) for the given method
+      def enum_for(method) # @private
+        if @object.respond_to?(:defined_enums)
+          @object.defined_enums[method.to_s]
+        end
+      end
+    end
+  end
+end

data/lib/formtastic/helpers/errors_helper.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
   module Helpers
     module ErrorsHelper
@@ -52,7 +53,7 @@ module Formtastic
         return nil if full_errors.blank?
         html_options[:class] ||= "errors"
         template.content_tag(:ul, html_options) do
-          Formtastic::Util.html_safe(full_errors.map { |error| template.content_tag(:li, Formtastic::Util.html_safe(error)) }.join)
+          full_errors.map { |error| template.content_tag(:li, error) }.join.html_safe
         end
       end
       
@@ -78,4 +79,4 @@ module Formtastic
       end
     end
   end
-end
+end

data/lib/formtastic/helpers/fieldset_wrapper.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
   module Helpers
     # @private
@@ -22,7 +23,7 @@ module Formtastic
       #   f.inputs :my_little_legend, :title, :body, :author    # Localized (118n) legend with I18n key => I18n.t(:my_little_legend, ...)
       #   f.inputs :title, :body, :author                       # First argument is a column => (no legend)
       def field_set_and_list_wrapping(*args, &block) # @private
-        contents = args.last.is_a?(::Hash) ? '' : args.pop.flatten
+        contents = args[-1].is_a?(::Hash) ? '' : args.pop.flatten
         html_options = args.extract_options!
 
         if block_given?
@@ -33,12 +34,15 @@ module Formtastic
           end
         end
 
+        # Work-around for empty contents block
+        contents ||= ""
+
         # Ruby 1.9: String#to_s behavior changed, need to make an explicit join.
         contents = contents.join if contents.respond_to?(:join)
 
         legend = field_set_legend(html_options)
         fieldset = template.content_tag(:fieldset,
-          Formtastic::Util.html_safe(legend) << template.content_tag(:ol, Formtastic::Util.html_safe(contents)),
+          legend.html_safe << template.content_tag(:ol, contents.html_safe),
           html_options.except(:builder, :parent, :name)
         )
 
@@ -47,8 +51,9 @@ module Formtastic
 
       def field_set_legend(html_options)
         legend  = (html_options[:name] || '').to_s
-        legend %= parent_child_index(html_options[:parent]) if html_options[:parent]
-        legend  = template.content_tag(:legend, template.content_tag(:span, Formtastic::Util.html_safe(legend))) unless legend.blank?
+       	# only applying if String includes '%i' avoids argument error when $DEBUG is true
+        legend %= parent_child_index(html_options[:parent]) if html_options[:parent] && legend.include?('%i')
+        legend  = template.content_tag(:legend, template.content_tag(:span, legend.html_safe)) unless legend.blank?
         legend
       end
 
@@ -57,20 +62,20 @@ module Formtastic
       def parent_child_index(parent) # @private
         # Could be {"post[authors_attributes]"=>0} or { :authors => 0 }
         duck = parent[:builder].instance_variable_get('@nested_child_index')
-        
+
         # Could be symbol for the association, or a model (or an array of either, I think? TODO)
         child = parent[:for]
         # Pull a sybol or model out of Array (TODO: check if there's an Array)
         child = child.first if child.respond_to?(:first)
         # If it's an object, get a symbol from the class name
         child = child.class.name.underscore.to_sym unless child.is_a?(Symbol)
-        
+
         key = "#{parent[:builder].object_name}[#{child}_attributes]"
 
-        # TODO: One of the tests produces a scenario where duck is "0" and the test looks for a "1" 
+        # TODO: One of the tests produces a scenario where duck is "0" and the test looks for a "1"
         # in the legend, so if we have a number, return it with a +1 until we can verify this scenario.
-        return duck + 1 if duck.is_a?(Fixnum)
-        
+        return duck + 1 if duck.is_a?(Integer)
+
         # First try to extract key from duck Hash, then try child
         (duck[key] || duck[child]).to_i + 1
       end

data/lib/formtastic/helpers/file_column_detection.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
   module Helpers
     # @private

data/lib/formtastic/helpers/form_helper.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Formtastic
   module Helpers
 
@@ -163,7 +164,7 @@ module Formtastic
         class_names << @@default_form_class
         model_class_name = case record_or_name_or_array
           when String, Symbol then record_or_name_or_array.to_s                                  # :post => "post"
-          when Array then options[:as] || singularizer.call(record_or_name_or_array.last.class)  # [@post, @comment] # => "comment"
+          when Array then options[:as] || singularizer.call(record_or_name_or_array[-1].class)  # [@post, @comment] # => "comment"
           else options[:as] || singularizer.call(record_or_name_or_array.class)                  # @post => "post"
         end
         class_names << @@default_form_model_class_proc.call(model_class_name)