mega-safe-tool 0.0.1

data/formtastic-6.0.0/formtastic.gemspec

@@ -0,0 +1,45 @@
+# encoding: utf-8
+$:.push File.expand_path("../lib", __FILE__)
+require "formtastic/version"
+
+Gem::Specification.new do |s|
+  s.name        = %q{formtastic}
+  s.version     = Formtastic::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = [%q{Justin French}]
+  s.email       = [%q{justin@indent.com.au}]
+  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   = []
+  s.require_paths = ["lib"]
+
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.extra_rdoc_files = ["README.md"]
+
+  # Minimum Ruby version is probably the same as whatever the minimum Rails version currently expects.
+  s.required_ruby_version = '>= 3.1.0'
+
+  # Minimum Ruby Gems version also matches whatever the minimum Rails version currently expects.
+  s.required_rubygems_version = ">= 1.8.11"
+
+  # User dependency is really just Rails, where we want describe the minimum version we support,
+  # which is probably the oldest version that hasn't reached end-of-life for security updates.
+  s.add_dependency(%q<actionpack>, [">= 7.2.0"])
+
+  # Development dependencies (for people working on Formtastic) are different to the minimum support
+  # version. Instead of specifying a specific version of each, we just specify the stack, and let the
+  # details of which versions work with each version of rails be managed in the Appraisal.
+  s.add_development_dependency(%q<appraisal>)
+  s.add_development_dependency(%q<rspec-rails>)
+  s.add_development_dependency(%q<rspec-dom-testing>)
+  s.add_development_dependency(%q<rspec-mocks>)
+  s.add_development_dependency(%q<yard>)
+  s.add_development_dependency(%q<ammeter>)
+  s.add_development_dependency(%q<rake>)
+  s.add_development_dependency(%q<sqlite3>)
+end

data/formtastic-6.0.0/gemfiles/rails_72.gemfile

@@ -0,0 +1,9 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "actionpack", "~> 7.2.3"
+gem "activesupport", "~> 7.2.3"
+gem "activerecord", "~> 7.2.3"
+
+gemspec path: "../"

data/formtastic-6.0.0/gemfiles/rails_80.gemfile

@@ -0,0 +1,9 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "actionpack", "~> 8.0.4"
+gem "activesupport", "~> 8.0.4"
+gem "activerecord", "~> 8.0.4"
+
+gemspec path: "../"

data/formtastic-6.0.0/gemfiles/rails_81.gemfile

@@ -0,0 +1,9 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "actionpack", "~> 8.1.2"
+gem "activesupport", "~> 8.1.2"
+gem "activerecord", "~> 8.1.2"
+
+gemspec path: "../"

data/formtastic-6.0.0/gemfiles/rails_edge.gemfile

@@ -0,0 +1,9 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "actionpack", git: "https://github.com/rails/rails.git", branch: "main"
+gem "activesupport", git: "https://github.com/rails/rails.git", branch: "main"
+gem "activerecord", git: "https://github.com/rails/rails.git", branch: "main"
+
+gemspec path: "../"

data/formtastic-6.0.0/lib/formtastic/action_class_finder.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+module Formtastic
+
+  # Uses the {NamespacedClassFinder} to look up action class names.
+  #
+  # See {Formtastic::Helpers::ActionHelper#namespaced_action_class} for details.
+  #
+  class ActionClassFinder < NamespacedClassFinder
+
+    # @param builder [FormBuilder]
+    def initialize(builder)
+      super builder.action_namespaces
+    end
+
+    def class_name(as)
+      "#{super}Action"
+    end
+  end
+end

data/formtastic-6.0.0/lib/formtastic/actions/base.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+module Formtastic
+  module Actions
+    module Base
+      include Formtastic::LocalizedString
+      
+      attr_accessor :builder, :template, :object, :object_name, :method, :options
+  
+      def initialize(builder, template, object, object_name, method, options)
+        @builder = builder
+        @template = template
+        @object = object
+        @object_name = object_name
+        @method = method
+        @options = options.dup
+        
+        check_supported_methods!
+      end
+      
+      def to_html
+        raise NotImplementedError
+      end
+      
+      def wrapper(&block)
+        template.content_tag(:li, 
+          template.capture(&block), 
+          wrapper_html_options
+        )
+      end
+      
+      def wrapper_html_options
+        wrapper_html_options_from_options.merge(default_wrapper_html_options)
+      end
+      
+      def wrapper_html_options_from_options
+        options[:wrapper_html] || {}
+      end
+      
+      def default_wrapper_html_options
+        {
+          :class => wrapper_class,
+          :id => wrapper_id
+        }
+      end
+      
+      def wrapper_class
+        (default_wrapper_classes << wrapper_classes_from_options).join(" ")
+      end
+      
+      def default_wrapper_classes
+        ["action", "#{options[:as]}_action"]
+      end
+      
+      def wrapper_classes_from_options
+        classes = wrapper_html_options_from_options[:class] || []
+        classes = classes.split(" ") if classes.is_a? String
+        classes
+      end
+      
+      def wrapper_html_options_from_options
+        options[:wrapper_html] || {}
+      end
+      
+      def wrapper_id
+        wrapper_id_from_options || default_wrapper_id
+      end
+      
+      def wrapper_id_from_options
+        wrapper_html_options_from_options[:id]
+      end
+      
+      def default_wrapper_id
+        "#{object_name}_#{method}_action"
+      end
+      
+      def supported_methods
+        raise NotImplementedError
+      end
+      
+      def text
+        text = options[:label]
+        text = (localized_string(i18n_key, text, :action, :model => sanitized_object_name) ||
+               Formtastic::I18n.t(i18n_key, :model => sanitized_object_name)) unless text.is_a?(::String)
+        text
+      end
+      
+      def button_html
+        default_button_html.merge(button_html_from_options || {}).merge(extra_button_html_options)
+      end
+      
+      def button_html_from_options
+        options[:button_html]
+      end
+      
+      def extra_button_html_options
+        {}
+      end
+      
+      def default_button_html
+        { :accesskey => accesskey }
+      end
+      
+      def accesskey
+        # TODO could be cleaner and separated, remember that nil is an allowed value for all of these
+        return options[:accesskey] if options.key?(:accesskey)
+        return options[:button_html][:accesskey] if options.key?(:button_html) && options[:button_html].key?(:accesskey)
+        # TODO might be different for cancel, etc?
+        return builder.default_commit_button_accesskey
+      end
+      
+      
+      protected
+      
+      def check_supported_methods!
+        raise Formtastic::UnsupportedMethodForAction unless supported_methods.include?(method)
+      end
+      
+      def i18n_key
+        return submit_i18n_key if method == :submit
+        method
+      end
+      
+      def submit_i18n_key
+        if new_or_persisted_object?
+          key = @object.persisted? ? :update : :create
+        else
+          key = :submit
+        end
+      end
+      
+      def new_or_persisted_object?
+        object && (object.respond_to?(:persisted?) || object.respond_to?(:new_record?))
+      end
+      
+      def sanitized_object_name
+        if new_or_persisted_object?
+          # Deal with some complications with ActiveRecord::Base.human_name and two name models (eg UserPost)
+          # ActiveRecord::Base.human_name falls back to ActiveRecord::Base.name.humanize ("Userpost")
+          # if there's no i18n, which is pretty crappy.  In this circumstance we want to detect this
+          # fall back (human_name == name.humanize) and do our own thing name.underscore.humanize ("User Post")
+          if object.class.model_name.respond_to?(:human)
+            sanitized_object_name = object.class.model_name.human
+          else
+            object_human_name = @object.class.human_name                # default is UserPost => "Userpost", but i18n may do better ("User post")
+            crappy_human_name = @object.class.name.humanize             # UserPost => "Userpost"
+            decent_human_name = @object.class.name.underscore.humanize  # UserPost => "User post"
+            sanitized_object_name = (object_human_name == crappy_human_name) ? decent_human_name : object_human_name
+          end
+        else
+          sanitized_object_name = object_name.to_s.send(builder.label_str_method)
+        end
+        sanitized_object_name
+      end
+      
+    end
+  end
+end

data/formtastic-6.0.0/lib/formtastic/actions/button_action.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+module Formtastic
+  module Actions
+
+  # Outputs a `<button type="submit">` or `<button type="reset">` wrapped in the standard `<li>`
+  # wrapper. This is an alternative choice for `:submit` and `:reset` actions, which render with
+  # `<input type="submit">` and `<input type="reset">` by default.
+  #
+  # @example Full form context and output
+  #
+  #   <%= semantic_form_for(@post) do |f| %>
+  #     <%= f.actions do %>
+  #       <%= f.action :reset, :as => :button %>
+  #       <%= f.action :submit, :as => :button %>
+  #     <% end %>
+  #   <% end %>
+  #
+  #   <form...>
+  #     <fieldset class="actions">
+  #       <ol>
+  #         <li class="action button_action" id="post_reset_action">
+  #           <button type="reset" value="Reset">
+  #         </li>
+  #         <li class="action button_action" id="post_submit_action">
+  #           <button type="submit" value="Create Post">
+  #         </li>
+  #       </ol>
+  #     </fieldset>
+  #   </form>
+  #
+  # @example Specifying a label with a String
+  #   <%= f.action :submit, :as => :button, :label => "Go" %>
+  #
+  # @example Pass HTML attributes down to the `<button>`
+  #   <%= f.action :submit, :as => :button, :button_html => { :class => 'pretty', :accesskey => 'g', :disable_with => "Wait..." } %>
+  #
+  # @example Access key can also be set as a top-level option
+  #   <%= f.action :submit, :as => :button, :accesskey => 'g' %>
+  #
+  # @example Pass HTML attributes down to the `<li>` wrapper (classes are appended to the existing classes)
+  #   <%= f.action :submit, :as => :button, :wrapper_html => { :class => 'special', :id => 'whatever' } %>
+  #   <%= f.action :submit, :as => :button, :wrapper_html => { :class => ['extra', 'special'], :id => 'whatever' } %>
+  #
+  # @todo document i18n keys
+  # @todo document i18n translation with :label (?)
+  class ButtonAction
+      include Base
+      include Buttonish
+
+      # @see Formtastic::Helpers::ActionHelper#action
+      # @option *args :label [String, Symbol]
+      #   Override the label text with a String or a symbol for an i18n translation key
+      #
+      # @option *args :button_html [Hash]
+      #   Override or add to the HTML attributes to be passed down to the `<input>` tag
+      #
+      # @option *args :wrapper_html [Hash]
+      #   Override or add to the HTML attributes to be passed down to the wrapping `<li>` tag
+
+      # TODO reset_action class?
+      def to_html
+        wrapper do
+          template.button_tag(text, button_html)
+        end
+      end
+    end
+  end
+end

data/formtastic-6.0.0/lib/formtastic/actions/buttonish.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+module Formtastic
+  module Actions
+    module Buttonish
+      
+      def supported_methods
+        [:submit, :reset]
+      end
+
+      def extra_button_html_options
+        {
+          :type => method
+        }
+      end
+      
+    end
+  end
+end

data/formtastic-6.0.0/lib/formtastic/actions/input_action.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+module Formtastic
+  module Actions
+
+  # Outputs an `<input type="submit">` or `<input type="reset">` wrapped in the standard `<li>`
+  # wrapper. This the default for `:submit` and `:reset` actions, but `:as => :button` is also
+  # available as an alternative.
+  #
+  # @example The `:as` can be omitted, these are functionally equivalent
+  #   <%= f.action :submit, :as => :input %>
+  #   <%= f.action :submit %>
+  #
+  # @example Full form context and output
+  #
+  #   <%= semantic_form_for(@post) do |f| %>
+  #     <%= f.actions do %>
+  #       <%= f.action :reset, :as => :input %>
+  #       <%= f.action :submit, :as => :input %>
+  #     <% end %>
+  #   <% end %>
+  #
+  #   <form...>
+  #     <fieldset class="actions">
+  #       <ol>
+  #         <li class="action input_action" id="post_reset_action">
+  #           <input type="reset" value="Reset">
+  #         </li>
+  #         <li class="action input_action" id="post_submit_action">
+  #           <input type="submit" value="Create Post">
+  #         </li>
+  #       </ol>
+  #     </fieldset>
+  #   </form>
+  #
+  # @example Specifying a label with a String
+  #   <%= f.action :submit, :as => :input, :label => "Go" %>
+  #
+  # @example Pass HTML attributes down to the `<input>`
+  #   <%= f.action :submit, :as => :input, :button_html => { :class => 'pretty', :accesskey => 'g', :disable_with => "Wait..." } %>
+  #
+  # @example Access key can also be set as a top-level option
+  #   <%= f.action :submit, :as => :input, :accesskey => 'g' %>
+  #
+  # @example Pass HTML attributes down to the `<li>` wrapper (classes are appended to the existing classes)
+  #   <%= f.action :submit, :as => :input, :wrapper_html => { :class => 'special', :id => 'whatever' } %>
+  #   <%= f.action :submit, :as => :input, :wrapper_html => { :class => ['extra', 'special'], :id => 'whatever' } %>
+  # @todo document i18n keys
+  # @todo document i18n translation with :label (?)
+  class InputAction
+      include Base
+      include Buttonish
+
+      # @see Formtastic::Helpers::ActionHelper#action
+      # @option *args :label [String, Symbol]
+      #   Override the label text with a String or a symbol for an i18n translation key
+      #
+      # @option *args :button_html [Hash]
+      #   Override or add to the HTML attributes to be passed down to the `<input>` tag
+      #
+      # @option *args :wrapper_html [Hash]
+      #   Override or add to the HTML attributes to be passed down to the wrapping `<li>` tag
+      #
+
+      def to_html
+        wrapper do
+          builder.submit(text, button_html)
+        end
+      end
+    end
+  end
+end

data/formtastic-6.0.0/lib/formtastic/actions/link_action.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+module Formtastic
+  module Actions
+  # Outputs a link wrapped in the standard `<li>` wrapper. This the default for `:cancel` actions.
+  # The link's URL defaults to Rails' built-in `:back` macro (the HTTP referrer, or Javascript for the
+  # browser's history), but can be altered with the `:url` option.
+  #
+  # @example The `:as` can be omitted, these are functionally equivalent
+  #   <%= f.action :cancel, :as => :link %>
+  #   <%= f.action :cancel %>
+  #
+  # @example Full form context and output
+  #
+  #   <%= semantic_form_for(@post) do |f| %>
+  #     <%= f.actions do %>
+  #       <%= f.action :submit, :as => :input %>
+  #       <%= f.action :cancel, :as => :link %>
+  #     <% end %>
+  #   <% end %>
+  #
+  #   <form...>
+  #     <fieldset class="actions">
+  #       <ol>
+  #         <li class="action input_action" id="post_submit_action">
+  #           <input type="submit" value="Create Post">
+  #         </li>
+  #         <li class="action link_action" id="post_cancel_action">
+  #           <a href="javascript:history.back()">Cancel</a>
+  #         </li>
+  #       </ol>
+  #     </fieldset>
+  #   </form>
+  #
+  # @example Modifying the URL for the link
+  #   <%= f.action :cancel, :as => :link, :url => "http://example.com/path" %>
+  #   <%= f.action :cancel, :as => :link, :url => "/path" %>
+  #   <%= f.action :cancel, :as => :link, :url => posts_path %>
+  #   <%= f.action :cancel, :as => :link, :url => url_for(...) %>
+  #   <%= f.action :cancel, :as => :link, :url => { :controller => "posts", :action => "index" } %>
+  #
+  # @example Specifying a label with a String
+  #   <%= f.action :cancel, :as => :link, :label => "Stop" %>
+  #
+  # @example Pass HTML attributes down to the `<a>`
+  #   <%= f.action :cancel, :as => :link, :button_html => { :class => 'pretty', :accesskey => 'x' } %>
+  #
+  # @example Access key can also be set as a top-level option
+  #   <%= f.action :cancel, :as => :link, :accesskey => 'x' %>
+  #
+  # @example Pass HTML attributes down to the `<li>` wrapper (classes are appended to the existing classes)
+  #   <%= f.action :cancel, :as => :link, :wrapper_html => { :class => 'special', :id => 'whatever' } %>
+  #   <%= f.action :cancel, :as => :link, :wrapper_html => { :class => ['extra', 'special'], :id => 'whatever' } %>
+  #
+  # @todo document i18n keys
+  # @todo document i18n translation with :label (?)
+  # @todo :prefix and :suffix options? (can also be done with CSS or subclassing for custom Actions)
+  class LinkAction
+      include Base
+
+      # @see Formtastic::Helpers::ActionHelper#action
+      # @option *args :label [String, Symbol]
+      #   Override the label text with a String or a symbol for an i18n translation key
+      #
+      # @option *args :button_html [Hash]
+      #   Override or add to the HTML attributes to be passed down to the `<a>` tag
+      #
+      # @option *args :wrapper_html [Hash]
+      #   Override or add to the HTML attributes to be passed down to the wrapping `<li>` tag
+      #
+
+      def supported_methods
+        [:cancel]
+      end
+
+      # TODO reset_action class?
+      def to_html
+        wrapper do
+          template.link_to(text, url, button_html)
+        end
+      end
+
+      def url
+        return options[:url] if options.key?(:url)
+        :back
+      end
+
+    end
+  end
+end

data/formtastic-6.0.0/lib/formtastic/actions.rb

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

data/formtastic-6.0.0/lib/formtastic/deprecation.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+require 'active_support/deprecation'
+
+module Formtastic
+  Deprecation = ActiveSupport::Deprecation.new("5.0.0", "Formtastic")
+end

data/formtastic-6.0.0/lib/formtastic/form_builder.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+module Formtastic
+  class FormBuilder < ActionView::Helpers::FormBuilder
+
+    # Defines a new configurable option
+    # @param [Symbol] name the configuration name
+    # @param [Object] default the configuration default value
+    # @private
+    #
+    # @!macro [new] configure
+    #   @!scope class
+    #   @!attribute [rw] $1
+    #   @api public
+    def self.configure(name, default = nil)
+      class_attribute(name)
+      self.send(:"#{name}=", default)
+    end
+
+    # Check {Formtastic::ActionClassFinder} to see how are inputs resolved.
+    configure :action_class_finder, Formtastic::ActionClassFinder
+    configure :action_namespaces, [::Object, ::Formtastic::Actions]
+    configure :all_fields_required_by_default, true
+    configure :collection_label_methods, %w[to_label display_name full_name name title username login value to_s]
+    configure :collection_value_methods, %w[id to_s]
+    configure :custom_namespace
+    configure :default_commit_button_accesskey
+    configure :default_error_list_class, 'errors'
+    configure :default_hint_class, 'inline-hints'
+    configure :default_inline_error_class, 'inline-errors'
+    configure :default_text_area_height, 20
+    configure :default_text_area_width
+    configure :default_text_field_size
+    configure :escape_html_entities_in_hints_and_labels, true
+    configure :file_metadata_suffixes, ['content_type', 'file_name', 'file_size']
+    configure :file_methods, [ :file?, :public_filename, :filename ]
+    configure :i18n_cache_lookups, true
+    configure :i18n_localizer, Formtastic::Localizer
+    configure :i18n_lookups_by_default, true
+    configure :include_blank_for_select_by_default, true
+    configure :inline_errors, :sentence
+    # Check {Formtastic::InputClassFinder} to see how are inputs resolved.
+    configure :input_class_finder, Formtastic::InputClassFinder
+    configure :input_namespaces, [::Object, ::Formtastic::Inputs]
+    configure :label_str_method, :humanize
+    configure :optional_string, ''
+    configure :perform_browser_validations, false
+    configure :priority_countries, ["Australia", "Canada", "United Kingdom", "United States"]
+    configure :priority_time_zones, []
+    configure :required_string, proc { %{<abbr title="#{Formtastic::I18n.t(:required)}">*</abbr>}.html_safe }
+    configure :semantic_errors_link_to_inputs, false
+    configure :skipped_columns, [:created_at, :updated_at, :created_on, :updated_on, :lock_version, :version]
+    configure :use_required_attribute, false
+
+    attr_reader :template
+
+    attr_reader :auto_index
+
+    include Formtastic::HtmlAttributes
+
+    include Formtastic::Helpers::InputHelper
+    include Formtastic::Helpers::InputsHelper
+    include Formtastic::Helpers::ActionHelper
+    include Formtastic::Helpers::ActionsHelper
+    include Formtastic::Helpers::ErrorsHelper
+
+    # 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`. 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`.
+    #
+    # @see https://api.rubyonrails.org/classes/ActionView/Helpers/FormBuilder.html#method-i-fields_for ActionView::Helpers::FormBuilder#fields_for
+    # @see https://api.rubyonrails.org/classes/ActionView/Helpers/FormHelper.html#method-i-fields_for ActionView::Helpers::FormHelper#fields_for
+    # @see Formtastic::Helpers::FormHelper#semantic_fields_for
+    #
+    # @example
+    #   <% semantic_form_for @post do |post| %>
+    #     <% post.semantic_fields_for :author do |author| %>
+    #       <% author.inputs :name %>
+    #     <% end %>
+    #   <% end %>
+    #
+    #   <form ...>
+    #     <fieldset class="inputs">
+    #       <ol>
+    #         <li class="string"><input type='text' name='post[author][name]' id='post_author_name' /></li>
+    #       </ol>
+    #     </fieldset>
+    #   </form>
+    #
+    # @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)
+      fields_for(record_or_name_or_array, *args, &block)
+    end
+
+    def initialize(object_name, object, template, options)
+      super
+
+      if respond_to?('multipart=') && options.is_a?(Hash) && options[:html]
+        self.multipart = options[:html][:multipart]
+      end
+    end
+
+  end
+
+end
+