formtastic 5.0.0 → 6.0.0.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70272678a1b436280de8d89add80583ca886cac153f6d4e43be93e6a641c344f
-  data.tar.gz: d2549407b0a3c5d21e7afe24cfd21bd008c9ca957bd06cf2d59fb7b3101fa042
+  metadata.gz: 211d0d0b33c1ea9fbd35858a71924740a27dd0a39b4e0e0cc48f16e7753388b1
+  data.tar.gz: 102435b082e7b83ddcfd874d8fe89f016b622e7f48fea56de0f8a136e162e072
 SHA512:
-  metadata.gz: 4164b15cb0dc3eb5d2d90f257977d59b8459a1708f4520ba6ff1708eaf9dd898f2713d9f59945c1d50c2b481e2175c0e3d7af6259c9f1e715a836aac0dd0e53b
-  data.tar.gz: e93800c9ca16ea4afb445f5a95cb56e1dd0224f06654ef8af7b13dba8ddb4c520e09c4b49c760d10a7e71d6f381f9b6fb91bbe61e26e1cab83823c7e2dc827de
+  metadata.gz: 454ed223f77ba1aa04c722e08fde0cf6494343e95f871611bc57275f335cd1cae26933b4ca45505abb58f4cfba539a9ffd0ec9888c55a7cd7a1d2badcbecf7c0
+  data.tar.gz: af525b290f06a4bb5753842a52ea6f7ff439b6496a8e435d1fa23ca9d3c2edcbcbc74eb8e44f46adeb7eb608f2fa3ffbcde6b0dfb8919b58dd37b39ab6407349

data/.github/workflows/integration.yaml

@@ -0,0 +1,36 @@
+name: integration
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v6
+  test:
+    runs-on: ubuntu-22.04
+
+    strategy:
+      fail-fast: false
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 11
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '4.0'
+          bundler-cache: true
+          bundler: latest
+
+      - name: Run integration
+        run: script/integration.sh

data/.github/workflows/test.yml

@@ -2,6 +2,8 @@ name: test
 
 on:
   push:
+    branches:
+      - main
   pull_request:
 
 jobs:
@@ -9,41 +11,46 @@ jobs:
     runs-on: ubuntu-latest
     needs: test
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v6
   test:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
 
     strategy:
       fail-fast: false
 
       matrix:
         gemfile:
-          - gemfiles/rails_6.0/Gemfile
-          - gemfiles/rails_6.1/Gemfile
-          - gemfiles/rails_7.0/Gemfile
-          - gemfiles/rails_7.1/Gemfile
-          - gemfiles/rails_edge/Gemfile
+          - gemfiles/rails_72.gemfile
+          - gemfiles/rails_80.gemfile
+          - gemfiles/rails_81.gemfile
+          - gemfiles/rails_edge.gemfile
 
         ruby:
-          - 2.6.6
-          - 2.7.2
-          - 3.0.0
+          - '3.1'
+          - '3.2'
+          - '3.3'
+          - '3.4'
+          - '4.0'
 
         exclude:
-          - ruby: 2.6.6
-            gemfile: gemfiles/rails_7.0/Gemfile
-          - ruby: 2.6.6
-            gemfile: gemfiles/rails_7.1/Gemfile
-          - ruby: 2.6.6
-            gemfile: gemfiles/rails_edge/Gemfile
+          - gemfile: gemfiles/rails_80.gemfile
+            ruby: '3.1'
+          - gemfile: gemfiles/rails_81.gemfile
+            ruby: '3.1'
+          - gemfile: gemfiles/rails_edge.gemfile
+            ruby: '3.1'
+          - gemfile: gemfiles/rails_edge.gemfile
+            ruby: '3.2'
+          - gemfile: gemfiles/rails_72.gemfile
+            ruby: '4.0'
 
     env:
       BUNDLE_GEMFILE: ${{ matrix.gemfile }}
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v6
 
-      - uses: actions/setup-node@v2
+      - uses: actions/setup-node@v6
         with:
           node-version: 11
 
@@ -57,5 +64,4 @@ jobs:
       - name: Run tests
         run: |
           bundle exec rake spec
-          script/integration.sh
-        continue-on-error: ${{ matrix.gemfile == 'gemfiles/rails_edge/Gemfile' }}
+        continue-on-error: ${{ matrix.gemfile == 'gemfiles/rails_edge.gemfile' }}

data/.gitignore

@@ -14,5 +14,6 @@ log/*
 .yardoc
 doc/
 tmp
-gemfiles/*/Gemfile.lock
+Gemfile.lock
+gemfiles/*.gemfile.lock
 /dummy/

data/Appraisals

@@ -0,0 +1,23 @@
+appraise "rails-72" do
+  gem "actionpack", "~> 7.2.3"
+  gem "activesupport", "~> 7.2.3"
+  gem "activerecord", "~> 7.2.3"
+end
+
+appraise "rails-80" do
+  gem "actionpack", "~> 8.0.4"
+  gem "activesupport", "~> 8.0.4"
+  gem "activerecord", "~> 8.0.4"
+end
+
+appraise "rails-81" do
+  gem "actionpack", "~> 8.1.2"
+  gem "activesupport", "~> 8.1.2"
+  gem "activerecord", "~> 8.1.2"
+end
+
+appraise "rails-edge" do
+  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"
+end

data/CHANGELOG.md

@@ -1,4 +1,21 @@
+## 6.0.0.alpha
+
+ * Removed support for Rails 6.0 & 7.1 (min version is now 7.2)
+ * Removed support for Ruby < 3.1 in line with Rails 7.2
+ * Added requirement for minimum Ruby Gems version in line with Rails 7.2
+ * Added formtastic:stylesheets generator (does not include legacy IE stylesheets)
+ * Removed formtastic engine stylesheets
+ * Added `semantic_errors_link_to_inputs` config option to improve accessibility of `semantic_errors`. ([#1388](https://github.com/formtastic/formtastic/pull/1388))
+ * Fixed country_select compatibility by switching from v1 to v2 syntax ([#1382](https://github.com/formtastic/formtastic/pull/1382))
+ * Fixed that passing caller to Deprecation#warn is deprecated ([#1384](https://github.com/formtastic/formtastic/pull/1384))
+ * Added `label_html` option for overriding & adding label HTML attributes ([#1379](https://github.com/formtastic/formtastic/pull/1379))
+ * Added better support for collections of Symbols ([#1391](https://github.com/formtastic/formtastic/pull/1391))
+ * Fixed issue with inferred max length for integer columns
+ * Fixed issue with Prox length validations ([#1405](https://github.com/formtastic/formtastic/pull/1405))
+ * Various minor Ruby, Rails, documentation and maintenance activities
+
 ## 5.0.0
+
  * Added support for Rails 7.1 ([#1371](https://github.com/formtastic/formtastic/pull/1371))
  * Removed support for Rails < 6.0.0 ([#1354](https://github.com/formtastic/formtastic/pull/1354))
  * Removed support for Rubies < 2.6.0 ([#1332](https://github.com/formtastic/formtastic/pull/1332), [#1355](https://github.com/formtastic/formtastic.git/pull/1355))
@@ -8,6 +25,7 @@
  * Use frozen_string_literal internally ([#1339](https://github.com/formtastic/formtastic/pull/1339))
 
 ## 4.0.0
+
   * Fixed default_columns_for_object when object has non-standard foreign keys (#1241)
   * Fixed missing constants in production (#911)
   * Removed support for Rails 3 and 4.0 (#1108)

data/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing
+
+## General Workflow
+
+* Fork the project on Github
+* Install development dependencies (`bundle install` and `bundle exec rake appraisal:install`)
+* Run the appraisals to check you've got a clean build with passing tests to work on (`bundle exec rake`)
+* Create a topic branch for your changes
+* Ensure that you provide *documentation* and *test coverage* for your changes (patches won't be accepted without)
+* Ensure that all tests still pass (`bundle exec rake`)
+* Create a pull request on Github (these are also a great place to start a conversation around a WIP patch as early as possible)
+
+
+## Continuos Integration
+
+Formtastic supports multiple versions of Rails and Ruby. Here's the approach to managing the complexity:
+
+* The gemspec has a `required_ruby_version` that matches the minimum Ruby version supported by the minimum Rails version we currently support.
+* The gemspec has a dependency on `actionpack` matching the minimum Rails version we currently support.
+* The gemspec has several development dependencies, but we're not specific about which version. That complexity is handled by Appraisals and/or bundler.
+* There is an Appraisal for each of the Rails versions we currently test with (eg Rails 7, 8 and edge) that can name specific versions of these dependencies and developer dependencies as needed.
+* Use `bundle exec appraisal` to generate new `gemfiles/*` as needed. We do not check-in the `*.gemfile.lock`, so that each Ruby version in the CI matrix can select an appropriate version of each dependency.
+* The GitHub `test.yml` workflow runs a matrix of builds agqainst multiple Ruby and Rails versions, excluding any that don't make sense based on the minimum Ruby version for certain Rails versions.
+
+
+
+

data/Gemfile

@@ -1,3 +1,8 @@
 source 'https://rubygems.org'
 
+# Which version of Rails to use specifically for local development. These currently match rails_8.gemfile.
+gem "actionpack", "~> 8.0.2"
+gem "activesupport", "~> 8.0.2"
+gem "activerecord", "~> 8.0.2"
+
 gemspec

data/MIT-LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2008-2021
+Copyright (c) 2007-2025
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -9,17 +9,15 @@ Formtastic is a Rails FormBuilder DSL (with some other goodies) to make it far e
 
 ## Documentation & Support
 
-* [Documentation is available on rdoc.info](https://rdoc.info/projects/formtastic/formtastic)
+* [Documentation is available on rubydoc.info](https://rubydoc.info/github/formtastic/formtastic)
 * [We track issues & bugs on GitHub](https://github.com/formtastic/formtastic/issues)
 * [We have a wiki on GitHub](https://github.com/formtastic/formtastic/wiki)
 * [StackOverflow can help](https://stackoverflow.com/questions/tagged/formtastic)
 
 ## Compatibility
 
-* Formtastic 5 requires Rails 6.0 and Ruby 2.6 minimum
-* Formtastic 4 requires Rails 5.2 and Ruby 2.4 minimum
-* Formtastic 3 requires Rails 3.2.13 minimum
-* Formtastic 2 requires Rails 3
+* Formtastic 5.0 (current release) requires Rails 6.0 and Ruby 2.6 minimum
+* Formtastic 6.0 / edge requires Rails 7.2 and Ruby 3.1 minimum, inline with Rails minimum supported versions
 * Formtastic, much like Rails, is very ActiveRecord-centric. Many are successfully using other ActiveModel-like ORMs and objects (DataMapper, MongoMapper, Mongoid, Authlogic, Devise...) but we're not guaranteeing full compatibility at this stage. Patches are welcome!
 
 ## The Story
@@ -101,37 +99,12 @@ $ rails generate formtastic:install
 
 ## Stylesheets
 
-A proof-of-concept set of stylesheets are provided which you can include in your layout. Customization is best achieved by overriding these styles in an additional stylesheet.
+An optional proof-of-concept stylesheet can be generated and installed into your app:
 
-Rails 3.1 introduces an asset pipeline that allows plugins like Formtastic to serve their own Stylesheets, Javascripts, etc without having to run generators that copy them across to the host application. Formtastic makes three stylesheets available as an Engine, you just need to require them in your global stylesheets.
-
-```css
-  # app/assets/stylesheets/application.css
-  *= require formtastic
-  *= require my_formtastic_changes
-```
-
-Conditional stylesheets need to be compiled separately to prevent them being bundled and included with other application styles.  Remove `require_tree .` from application.css and specify required stylesheets individually.
-
-```css
-  # app/assets/stylesheets/ie6.css
-  *= require formtastic_ie6
-
-  # app/assets/stylesheets/ie7.css
-  *= require formtastic_ie7
-```
-
-```erb
-  # app/views/layouts/application.html.erb
-  <%= stylesheet_link_tag 'application' %>
-  <!--[if IE 6]><%= stylesheet_link_tag 'ie6' %><![endif]-->
-  <!--[if IE 7]><%= stylesheet_link_tag 'ie7' %><![endif]-->
+```shell
+$ rails generate formtastic:stylesheet
 ```
 
-```ruby
-  # config/environments/production.rb
-  config.assets.precompile += %w( ie6.css ie7.css )
-```
 
 ## Usage
 
@@ -608,18 +581,13 @@ You can use your new input with `:as => :date_picker`.
 
 There are none other than Rails itself, but...
 
-* If you want to use the `:country` input, you'll need to install the [country-select plugin](https://github.com/stefanpenner/country_select) (or any other country_select plugin with the same API). Both 1.x and 2.x are supported, but they behave differently when storing data, so please see their [upgrade notes](https://github.com/stefanpenner/country_select/blob/master/UPGRADING.md) if switching from 1.x.
+* If you want to use the `:country` input, you'll need to install the [country-select plugin](https://github.com/countries/country_select) (or any other country_select plugin with the same API).
 * There are a bunch of development dependencies if you plan to contribute to Formtastic
 
 
 ## How to contribute
 
-* Fork the project on Github
-* Install development dependencies (`bundle install` and `bin/appraisal install`)
-* Create a topic branch for your changes
-* Ensure that you provide *documentation* and *test coverage* for your changes (patches won't be accepted without)
-* Ensure that all tests pass (`bundle exec rake`)
-* Create a pull request on Github (these are also a great place to start a conversation around a patch as early as possible)
+See `CONTRIBUTING.md`
 
 
 ## Project Info
@@ -628,5 +596,5 @@ Formtastic was created by [Justin French](https://www.justinfrench.com) with con
 
 The project is hosted on Github: [https://github.com/formtastic/formtastic](https://github.com/formtastic/formtastic), where your contributions, forkings, comments, issues and feedback are greatly welcomed.
 
-Copyright (c) 2007-2021, released under the MIT license.
+Copyright (c) 2007-2025, released under the MIT license.
 

data/Rakefile

@@ -25,7 +25,7 @@ namespace :appraisal do
 end
 
 def for_all_gemfiles(*args)
-  Dir.glob("gemfiles/*/Gemfile").sort.each do |gemfile|
+  Dir.glob("gemfiles/*.gemfile").sort.each do |gemfile|
     Bundler.with_original_env do
       sh({ "APPRAISAL_INITIALIZED" => "true", "BUNDLE_GEMFILE" => gemfile }, "bundle", *args)
     end

data/formtastic.gemspec

@@ -21,18 +21,25 @@ Gem::Specification.new do |s|
   s.rdoc_options = ["--charset=UTF-8"]
   s.extra_rdoc_files = ["README.md"]
 
-  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}
+  # Minimum Ruby version is probably the same as whatever the minimum Rails version currently expects.
+  s.required_ruby_version = '>= 3.1.0'
 
-  s.add_dependency(%q<actionpack>, [">= 6.0.0"])
+  # Minimum Ruby Gems version also matches whatever the minimum Rails version currently expects.
+  s.required_rubygems_version = ">= 1.8.11"
 
-  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"])
+  # 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"])
 
-  s.add_development_dependency(%q<yard>, ["~> 0.9.20"])
-  s.add_development_dependency(%q<ammeter>, ["~> 1.1.3"])
+  # 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>, ["~> 1.4"])
+  s.add_development_dependency(%q<sqlite3>)
 end

data/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/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/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/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/lib/formtastic/form_builder.rb

@@ -16,40 +16,40 @@ module Formtastic
       self.send(:"#{name}=", default)
     end
 
-    configure :custom_namespace
-    configure :default_text_field_size
-    configure :default_text_area_height, 20
-    configure :default_text_area_width
+    # 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 :include_blank_for_select_by_default, true
-    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
     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 :file_methods, [ :file?, :public_filename, :filename ]
-    configure :file_metadata_suffixes, ['content_type', 'file_name', 'file_size']
-    configure :priority_countries, ["Australia", "Canada", "United Kingdom", "United States"]
-    configure :i18n_lookups_by_default, true
-    configure :i18n_cache_lookups, true
-    configure :i18n_localizer, Formtastic::Localizer
-    configure :escape_html_entities_in_hints_and_labels, true
+    configure :custom_namespace
     configure :default_commit_button_accesskey
-    configure :default_inline_error_class, 'inline-errors'
     configure :default_error_list_class, 'errors'
     configure :default_hint_class, 'inline-hints'
-    configure :use_required_attribute, false
-    configure :perform_browser_validations, false
+    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_namespaces, [::Object, ::Formtastic::Inputs]
     configure :input_class_finder, Formtastic::InputClassFinder
-    # Check {Formtastic::ActionClassFinder} to see how are inputs resolved.
-    configure :action_namespaces, [::Object, ::Formtastic::Actions]
-    configure :action_class_finder, Formtastic::ActionClassFinder
-
-    configure :skipped_columns, [:created_at, :updated_at, :created_on, :updated_on, :lock_version, :version]
+    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
 

data/lib/formtastic/helpers/action_helper.rb

@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 # frozen_string_literal: true
 module Formtastic
   module Helpers

data/lib/formtastic/helpers/errors_helper.rb

@@ -16,6 +16,10 @@ module Formtastic
       # A hash can be used as the last set of arguments to pass HTML attributes to the `<ul>`
       # wrapper.
       #
+      # # in config/initializers/formtastic.rb
+      # Setting `Formtastic::FormBuilder.semantic_errors_link_to_inputs = true`
+      # will render attribute errors as links to the corresponding errored inputs.
+      #
       # @example A list of errors on the base model
       #   <%= semantic_form_for ... %>
       #     <%= f.semantic_errors %>
@@ -41,24 +45,37 @@ module Formtastic
       #   <% end %>
       def semantic_errors(*args)
         html_options = args.extract_options!
-        args = args - [:base]
-        full_errors = args.inject([]) do |array, method|
-          attribute = localized_string(method, method.to_sym, :label) || humanized_attribute_name(method)
-          errors = Array(@object.errors[method.to_sym]).to_sentence
-          errors.present? ? array << [attribute, errors].join(" ") : array ||= []
-        end
-        full_errors << @object.errors[:base]
-        full_errors.flatten!
-        full_errors.compact!
-        return nil if full_errors.blank?
         html_options[:class] ||= "errors"
-        template.content_tag(:ul, html_options) do
-          full_errors.map { |error| template.content_tag(:li, error) }.join.html_safe
+
+        if Formtastic::FormBuilder.semantic_errors_link_to_inputs
+          attribute_error_hash = semantic_error_hash_from_attributes(args)
+          return nil if @object.errors[:base].blank? && attribute_error_hash.blank?
+
+          template.content_tag(:ul, html_options) do
+            (
+              @object.errors[:base].map { |base_error| template.content_tag(:li, base_error) } <<
+              attribute_error_hash.map { |attribute, error_message|
+                template.content_tag(:li) do
+                  template.content_tag(:a, href: "##{object_name}_#{attribute}") do
+                    error_message
+                  end
+                end
+              }
+            ).join.html_safe
+          end
+        else
+          full_errors = @object.errors[:base]
+          full_errors += semantic_error_list_from_attributes(args)
+          return nil if full_errors.blank?
+
+          template.content_tag(:ul, html_options) do
+            full_errors.map { |error| template.content_tag(:li, error) }.join.html_safe
+          end
         end
       end
-      
+
       protected
-      
+
       def error_keys(method, options)
         @methods_for_error ||= {}
         @methods_for_error[method] ||= begin
@@ -77,6 +94,46 @@ module Formtastic
       def render_inline_errors?
         @object && @object.respond_to?(:errors) && Formtastic::FormBuilder::INLINE_ERROR_TYPES.include?(inline_errors)
       end
+
+      def semantic_error_list_from_attributes(*args)
+        attribute_errors = []
+        args = args.flatten
+        args.each do |attribute|
+          next if attribute == :base
+
+          full_message = error_message_for_attribute(attribute)
+
+          attribute_errors << full_message unless full_message.blank?
+        end
+
+        attribute_errors
+      end
+
+      # returns { 'attribute': 'error_message_for_attribute' }
+      def semantic_error_hash_from_attributes(*args)
+        attribute_error_hash = {}
+        args = args.flatten
+        args.each do |attribute|
+          next if attribute == :base
+
+          full_message = error_message_for_attribute(attribute)
+
+          attribute_error_hash[attribute] = full_message unless full_message.blank?
+        end
+
+        attribute_error_hash
+      end
+
+      # Returns "Attribute error_message_sentence" localized, humanized
+      def error_message_for_attribute(attribute)
+        attribute_string = localized_string(attribute, attribute.to_sym, :label) || humanized_attribute_name(attribute)
+        error_message = @object.errors[attribute.to_sym]&.to_sentence
+
+        return nil if error_message.blank?
+
+        full_message = [attribute_string, error_message].join(" ")
+        full_message
+      end
     end
   end
 end

data/lib/formtastic/helpers/input_helper.rb

@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 # frozen_string_literal: true
 module Formtastic
   module Helpers
@@ -177,6 +176,9 @@ module Formtastic
       # @example Changing or adding to HTML attributes in the main `<input>` or `<select>` tag
       #   <%= f.input :title, :input_html => { :onchange => "somethingAwesome();", :class => 'awesome' } %>
       #
+      # @example Changing or adding to HTML attributes in the main `<label>` tag
+      #   <%= f.input :title, :label_html => { :data => { :tooltip => 'Great Tooltip' } } %>
+      #
       # @example Changing or adding to HTML attributes in the wrapper `<li>` tag
       #   <%= f.input :title, :wrapper_html => { :class => "important-input" } %>
       #
@@ -278,7 +280,7 @@ module Formtastic
             return :number
           when :float, :decimal
             return :number
-          when :datetime, :timestamp
+          when :datetime, :timestamp, :timestamptz
             return :datetime_select
           when :time
             return :time_select

data/lib/formtastic/i18n.rb

@@ -1,4 +1,3 @@
-# encoding: utf-8
 # frozen_string_literal: true
 
 module Formtastic