suspenders 20250317.0 → 20251219.0

metadata

@@ -1,71 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: suspenders
 version: !ruby/object:Gem::Version
-  version: '20250317.0'
+  version: '20251219.0'
 platform: ruby
 authors:
 - thoughtbot
-autorequire:
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2025-03-17 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: rails
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '8.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '8.0'
-- !ruby/object:Gem::Dependency
-  name: climate_control
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: mocha
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: standard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
 description: |
   Suspenders is a Rails plugin containing generators for configuring Rails
   applications. It is used by thoughtbot to get a jump start on a new or
@@ -73,67 +16,41 @@ description: |
   don't use it if you like missing deadlines.
 email:
 - support@thoughtbot.com
-executables: []
+executables:
+- suspenders
 extensions: []
 extra_rdoc_files: []
 files:
+- ".ruby-version"
+- CODEOWNERS
+- CONTRIBUTING.md
+- FEATURES.md
+- GOALS.md
+- LICENSE
+- NEWS.md
 - README.md
+- RELEASING.md
 - Rakefile
-- lib/generators/suspenders/accessibility_generator.rb
-- lib/generators/suspenders/advisories_generator.rb
-- lib/generators/suspenders/ci_generator.rb
-- lib/generators/suspenders/email_generator.rb
-- lib/generators/suspenders/environments/development_generator.rb
-- lib/generators/suspenders/environments/production_generator.rb
-- lib/generators/suspenders/environments/test_generator.rb
-- lib/generators/suspenders/factories_generator.rb
-- lib/generators/suspenders/inline_svg_generator.rb
-- lib/generators/suspenders/install/web_generator.rb
-- lib/generators/suspenders/jobs_generator.rb
-- lib/generators/suspenders/lint_generator.rb
-- lib/generators/suspenders/prerequisites_generator.rb
-- lib/generators/suspenders/rake_generator.rb
-- lib/generators/suspenders/setup_generator.rb
-- lib/generators/suspenders/styles_generator.rb
-- lib/generators/suspenders/tasks_generator.rb
-- lib/generators/suspenders/testing_generator.rb
-- lib/generators/suspenders/views_generator.rb
-- lib/generators/templates/ci/ci.yml.tt
-- lib/generators/templates/email/email_interceptor.rb
-- lib/generators/templates/factories/factories.rb
-- lib/generators/templates/factories/factories_spec.rb
-- lib/generators/templates/factories/factories_test.rb
-- lib/generators/templates/factories/factory_bot_rspec.rb
-- lib/generators/templates/inline_svg/inline_svg.rb
-- lib/generators/templates/install/web/CONTRIBUTING.md
-- lib/generators/templates/lint/config_better_html.yml
-- lib/generators/templates/lint/config_initializers_better_html.rb
-- lib/generators/templates/lint/erb-lint.yml
-- lib/generators/templates/lint/erblint.rake
-- lib/generators/templates/lint/eslintrc.json
-- lib/generators/templates/lint/package.json
-- lib/generators/templates/lint/prettierignore
-- lib/generators/templates/lint/prettierrc
-- lib/generators/templates/lint/rubocop.yml.tt
-- lib/generators/templates/lint/stylelintrc.json
-- lib/generators/templates/prerequisites/node-version.tt
-- lib/generators/templates/setup/bin_setup.rb
-- lib/generators/templates/styles/postcss.config.js
-- lib/generators/templates/tasks/dev.rake
-- lib/generators/templates/testing/action_mailer.rb
-- lib/generators/templates/testing/driver.rb
-- lib/generators/templates/testing/i18n.rb
-- lib/generators/templates/testing/shoulda_matchers.rb
-- lib/generators/templates/views/flashes.html.erb
-- lib/install/web.rb
+- SECURITY.md
+- exe/suspenders
 - lib/suspenders.rb
-- lib/suspenders/cleanup/generate_readme.rb
-- lib/suspenders/cleanup/organize_gemfile.rb
-- lib/suspenders/engine.rb
-- lib/suspenders/generators.rb
-- lib/suspenders/railtie.rb
+- lib/suspenders/cli.rb
 - lib/suspenders/version.rb
-- lib/tasks/suspenders.rake
+- lib/templates/Procfile
+- lib/templates/Procfile.dev
+- lib/templates/app/views/application/_flashes.html.erb
+- lib/templates/app/views/application/_form_errors.html.erb
+- lib/templates/config/initializers/sidekiq.rb
+- lib/templates/lib/development/seeder.rb
+- lib/templates/lib/tasks/development.rake
+- lib/templates/spec/factories_spec.rb
+- lib/templates/spec/support/action_mailer.rb
+- lib/templates/spec/support/driver.rb
+- lib/templates/spec/support/factory_bot.rb
+- lib/templates/spec/support/i18n.rb
+- lib/templates/spec/support/shoulda_matchers.rb
+- lib/templates/web.rb
+- sig/suspenders.rbs
 homepage: http://github.com/thoughtbot/suspenders
 licenses:
 - MIT
@@ -141,7 +58,6 @@ metadata:
   homepage_uri: http://github.com/thoughtbot/suspenders
   source_code_uri: http://github.com/thoughtbot/suspenders
   changelog_uri: https://github.com/thoughtbot/suspenders/blob/main/NEWS.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -149,15 +65,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.9
-signing_key:
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Rails generators using thoughtbot's best practices.
 test_files: []

data/lib/generators/suspenders/accessibility_generator.rb

@@ -1,24 +0,0 @@
-module Suspenders
-  module Generators
-    class AccessibilityGenerator < Rails::Generators::Base
-      include Suspenders::Generators::APIAppUnsupported
-
-      desc <<~MARKDOWN
-        Uses [capybara_accessibility_audit][] and
-        [capybara_accessible_selectors][] to encourage and enforce accessibility best
-        practices.
-
-        [capybara_accessibility_audit]: https://github.com/thoughtbot/capybara_accessibility_audit
-        [capybara_accessible_selectors]: https://github.com/citizensadvice/capybara_accessible_selectors
-      MARKDOWN
-
-      def add_capybara_gems
-        gem_group :test do
-          gem "capybara_accessibility_audit", github: "thoughtbot/capybara_accessibility_audit"
-          gem "capybara_accessible_selectors", github: "citizensadvice/capybara_accessible_selectors", tag: "v0.12.0"
-        end
-        Bundler.with_unbundled_env { run "bundle install" }
-      end
-    end
-  end
-end

data/lib/generators/suspenders/advisories_generator.rb

@@ -1,32 +0,0 @@
-module Suspenders
-  module Generators
-    class AdvisoriesGenerator < Rails::Generators::Base
-      source_root File.expand_path("../../templates/advisories", __FILE__)
-      desc <<~MARKDOWN
-        Uses [bundler-audit][] to update the local security database and show
-        any relevant issues with the app's dependencies via a Rake task.
-
-        [bundler-audit]: https://github.com/rubysec/bundler-audit
-      MARKDOWN
-
-      def add_bundler_audit
-        gem_group :development, :test do
-          gem "bundler-audit", ">= 0.7.0", require: false
-        end
-        Bundler.with_unbundled_env { run "bundle install" }
-      end
-
-      def modify_rakefile
-        content = <<~RUBY
-
-          if Rails.env.local?
-            require "bundler/audit/task"
-            Bundler::Audit::Task.new
-          end
-        RUBY
-
-        insert_into_file "Rakefile", content, after: /require_relative "config\/application"\n/
-      end
-    end
-  end
-end

data/lib/generators/suspenders/ci_generator.rb

@@ -1,54 +0,0 @@
-module Suspenders
-  module Generators
-    class CiGenerator < Rails::Generators::Base
-      include Suspenders::Generators::DatabaseUnsupported
-      include Suspenders::Generators::Helpers
-
-      source_root File.expand_path("../../templates/ci", __FILE__)
-      desc <<~MARKDOWN
-        Uses [GitHub Actions][] for CI
-
-        [GitHub Actions]: https://docs.github.com/en/actions
-      MARKDOWN
-
-      def ci_files
-        template "ci.yml", ".github/workflows/ci.yml", force: true
-      end
-
-      private
-
-      def scan_ruby?
-        has_gem? "bundler-audit"
-      end
-
-      def scan_js?
-        File.exist?("bin/importmap") && using_node?
-      end
-
-      def lint?
-        using_node? && has_gem?("standard") && has_yarn_script?("lint")
-      end
-
-      def using_node?
-        File.exist? "package.json"
-      end
-
-      def has_gem?(name)
-        Bundler.rubygems.find_name(name).any?
-      end
-
-      def using_rspec?
-        File.exist? "spec"
-      end
-
-      def has_yarn_script?(name)
-        return false if !using_node?
-
-        content = File.read("package.json")
-        json = JSON.parse(content)
-
-        json.dig("scripts", name)
-      end
-    end
-  end
-end

data/lib/generators/suspenders/email_generator.rb

@@ -1,56 +0,0 @@
-module Suspenders
-  module Generators
-    class EmailGenerator < Rails::Generators::Base
-      source_root File.expand_path("../../templates/email", __FILE__)
-      desc <<~MARKDOWN
-        [Intercept][] emails in non-production environments by setting `INTERCEPTOR_ADDRESSES`.
-
-        ```sh
-        INTERCEPTOR_ADDRESSES="user_1@example.com,user_2@example.com" bin/rails s
-        ```
-
-        Configuration can be found at `config/initializers/email_interceptor.rb`.
-
-        Interceptor can be found at `app/mailers/email_interceptor.rb`.
-
-        [Intercept]: https://guides.rubyonrails.org/action_mailer_basics.html#intercepting-emails
-      MARKDOWN
-
-      def create_email_interceptor
-        copy_file "email_interceptor.rb", "app/mailers/email_interceptor.rb"
-      end
-
-      def create_email_interceptor_initializer
-        initializer "email_interceptor.rb", <<~RUBY
-          Rails.application.configure do
-            if ENV["INTERCEPTOR_ADDRESSES"].present?
-              config.action_mailer.interceptors = %w[EmailInterceptor]
-            end
-          end
-        RUBY
-      end
-
-      def configure_email_interceptor
-        environment do
-          %(
-            config.to_prepare do
-              EmailInterceptor.config.interceptor_addresses = ENV.fetch("INTERCEPTOR_ADDRESSES", "").split(",")
-            end
-          )
-        end
-      end
-
-      # TODO: Remove once https://github.com/rails/rails/pull/51191 is in latest
-      # Rails release
-      def configure_development_environment
-        environment %(config.action_mailer.default_url_options = { host: "localhost", port: 3000 }), env: "development"
-      end
-
-      # TODO: Remove once https://github.com/rails/rails/pull/51191 is in latest
-      # Rails release
-      def configure_test_environment
-        environment %(config.action_mailer.default_url_options = { host: "www.example.com" }), env: "test"
-      end
-    end
-  end
-end

data/lib/generators/suspenders/environments/development_generator.rb

@@ -1,50 +0,0 @@
-module Suspenders
-  module Generators
-    module Environments
-      class DevelopmentGenerator < Rails::Generators::Base
-        desc <<~MARKDOWN
-          - Enables [raise_on_missing_translations][].
-          - Enables [annotate_rendered_view_with_filenames][].
-          - Enables [i18n_customize_full_message][].
-          - Enables [query_log_tags_enabled][].
-
-          [raise_on_missing_translations]: https://guides.rubyonrails.org/configuring.html#config-i18n-raise-on-missing-translations
-          [annotate_rendered_view_with_filenames]: https://guides.rubyonrails.org/configuring.html#config-action-view-annotate-rendered-view-with-filenames
-          [i18n_customize_full_message]: https://guides.rubyonrails.org/configuring.html#config-active-model-i18n-customize-full-message
-          [query_log_tags_enabled]: https://guides.rubyonrails.org/configuring.html#config-active-record-query-log-tags-enabled
-        MARKDOWN
-
-        def raise_on_missing_translations
-          if development_config.match?(/^\s#\s*config\.i18n\.raise_on_missing_translations/)
-            uncomment_lines "config/environments/development.rb", "config.i18n.raise_on_missing_translations = true"
-          else
-            environment %(config.i18n.raise_on_missing_translations = true), env: "development"
-          end
-        end
-
-        def annotate_render_view_with_filename
-          if development_config.match?(/^\s#\s*config\.action_view\.annotate_render_view_with_filename/)
-            uncomment_lines "config/environments/development.rb",
-              "config.action_view.annotate_rendered_view_with_filenames = true"
-          else
-            environment %(config.action_view.annotate_rendered_view_with_filenames = true), env: "development"
-          end
-        end
-
-        def enable_i18n_customize_full_message
-          environment %(config.active_model.i18n_customize_full_message = true), env: "development"
-        end
-
-        def enable_query_log_tags_enabled
-          environment %(config.active_record.query_log_tags_enabled = true), env: "development"
-        end
-
-        private
-
-        def development_config
-          File.read(Rails.root.join("config/environments/development.rb"))
-        end
-      end
-    end
-  end
-end

data/lib/generators/suspenders/environments/production_generator.rb

@@ -1,27 +0,0 @@
-module Suspenders
-  module Generators
-    module Environments
-      class ProductionGenerator < Rails::Generators::Base
-        desc <<~MARKDOWN
-          - Enables [require_master_key][].
-
-          [require_master_key]: https://guides.rubyonrails.org/configuring.html#config-require-master-key
-        MARKDOWN
-
-        def require_master_key
-          if production_config.match?(/^\s*#\s*config\.require_master_key\s*=\s*true/)
-            uncomment_lines "config/environments/production.rb", /config\.require_master_key\s*=\s*true/
-          else
-            environment %(config.require_master_key = true), env: "production"
-          end
-        end
-
-        private
-
-        def production_config
-          File.read(Rails.root.join("config/environments/production.rb"))
-        end
-      end
-    end
-  end
-end

data/lib/generators/suspenders/environments/test_generator.rb

@@ -1,39 +0,0 @@
-module Suspenders
-  module Generators
-    module Environments
-      class TestGenerator < Rails::Generators::Base
-        desc <<~MARKDOWN
-          - Enables [raise_on_missing_translations][].
-          - Disables [action_dispatch.show_exceptions][].
-
-          [raise_on_missing_translations]: https://guides.rubyonrails.org/configuring.html#config-i18n-raise-on-missing-translations
-          [action_dispatch.show_exceptions]: https://edgeguides.rubyonrails.org/configuring.html#config-action-dispatch-show-exceptions
-        MARKDOWN
-
-        def raise_on_missing_translations
-          if test_config.match?(/^\s*#\s*config\.i18n\.raise_on_missing_translations\s*=\s*true/)
-            uncomment_lines "config/environments/test.rb", /config\.i18n\.raise_on_missing_translations\s*=\s*true/
-          else
-            environment %(config.i18n.raise_on_missing_translations = true), env: "test"
-          end
-        end
-
-        def disable_action_dispatch_show_exceptions
-          if test_config.match?(/^\s*config\.action_dispatch\.show_exceptions\s*=\s*:rescuable/)
-            gsub_file "config/environments/test.rb", /^\s*config\.action_dispatch\.show_exceptions\s*=\s*:rescuable/,
-              "config.action_dispatch.show_exceptions = :none"
-            gsub_file "config/environments/test.rb", /^\s*#\s*Raise exceptions instead of rendering exception templates/i, ""
-          else
-            environment %(config.action_dispatch.show_exceptions = :none), env: "test"
-          end
-        end
-
-        private
-
-        def test_config
-          File.read(Rails.root.join("config/environments/test.rb"))
-        end
-      end
-    end
-  end
-end

data/lib/generators/suspenders/factories_generator.rb

@@ -1,64 +0,0 @@
-module Suspenders
-  module Generators
-    class FactoriesGenerator < Rails::Generators::Base
-      include Suspenders::Generators::Helpers
-
-      source_root File.expand_path("../../templates/factories", __FILE__)
-      desc <<~MARKDOWN
-        Uses [FactoryBot][] as an alternative to [Fixtures][] to help you define
-        dummy and test data for your test suite. The `create`, `build`, and
-        `build_stubbed` class methods are directly available to all tests.
-
-        Place FactoryBot definitions in `spec/factories.rb`, at least until it
-        grows unwieldy. This helps reduce confusion around circular dependencies and
-        makes it easy to jump between definitions.
-
-        [FactoryBot]: https://github.com/thoughtbot/factory_bot
-        [Fixtures]: https://guides.rubyonrails.org/testing.html#the-low-down-on-fixtures
-      MARKDOWN
-
-      def add_factory_bot
-        gem_group :development, :test do
-          gem "factory_bot_rails"
-        end
-
-        Bundler.with_unbundled_env { run "bundle install" }
-      end
-
-      def set_up_factory_bot
-        if default_test_helper_present?
-          insert_into_file Rails.root.join("test/test_helper.rb"), after: "class TestCase" do
-            "\n    include FactoryBot::Syntax::Methods"
-          end
-        elsif rspec_test_helper_present?
-          copy_file "factory_bot_rspec.rb", "spec/support/factory_bot.rb"
-          insert_into_file Rails.root.join("spec/rails_helper.rb") do
-            %(Dir[Rails.root.join("spec/support/**/*.rb")].sort.each { |file| require file })
-          end
-        end
-      end
-
-      def generate_empty_factories_file
-        if default_test_suite?
-          copy_file "factories.rb", "test/factories.rb"
-        elsif rspec_test_suite?
-          copy_file "factories.rb", "spec/factories.rb"
-        end
-      end
-
-      def remove_fixture_definitions
-        if default_test_helper_present?
-          comment_lines "test/test_helper.rb", /fixtures :all/
-        end
-      end
-
-      def create_linting_test
-        if default_test_suite?
-          copy_file "factories_test.rb", "test/factory_bots/factories_test.rb"
-        elsif rspec_test_suite?
-          copy_file "factories_spec.rb", "spec/factory_bots/factories_spec.rb"
-        end
-      end
-    end
-  end
-end

data/lib/generators/suspenders/inline_svg_generator.rb

@@ -1,24 +0,0 @@
-module Suspenders
-  module Generators
-    class InlineSvgGenerator < Rails::Generators::Base
-      include Suspenders::Generators::APIAppUnsupported
-      source_root File.expand_path("../../templates/inline_svg", __FILE__)
-      desc <<~MARKDOWN
-        Uses [inline_svg][] for embedding SVG documents into views.
-
-        Configuration can be found at `config/initializers/inline_svg.rb`
-
-        [inline_svg]: https://github.com/jamesmartin/inline_svg
-      MARKDOWN
-
-      def add_inline_svg_gem
-        gem "inline_svg"
-        Bundler.with_unbundled_env { run "bundle install" }
-      end
-
-      def configure_inline_svg
-        copy_file "inline_svg.rb", "config/initializers/inline_svg.rb"
-      end
-    end
-  end
-end

data/lib/generators/suspenders/install/web_generator.rb

@@ -1,85 +0,0 @@
-module Suspenders
-  module Generators
-    module Install
-      class WebGenerator < Rails::Generators::Base
-        include Suspenders::Generators::APIAppUnsupported
-        include Suspenders::Generators::DatabaseUnsupported
-        include Suspenders::Generators::NodeNotInstalled
-        include Suspenders::Generators::NodeVersionUnsupported
-
-        source_root File.expand_path("../../../templates/install/web", __FILE__)
-        desc <<~MARKDOWN
-          Invokes all necessary generators for new Rails applications generated with Suspenders.
-
-          This generatator is intended to be invoked as part of an [application template][].
-
-          #### Use the latest suspenders release:
-
-          ```
-          rails new <app_name> \\
-          --skip-rubocop \\
-          --skip-test \\
-          -d=postgresql \\
-          -m=https://raw.githubusercontent.com/thoughtbot/suspenders/main/lib/install/web.rb
-          ```
-
-          #### OR use the current (possibly unreleased) `main` branch of suspenders:
-
-          ```
-          rails new app_name \\
-          --suspenders-main \\
-          --skip-rubocop \\
-          --skip-test \\
-          -d=postgresql \\
-          -m=https://raw.githubusercontent.com/thoughtbot/suspenders/main/lib/install/web.rb
-          ```
-
-          [application template]: https://guides.rubyonrails.org/rails_application_templates.html
-        MARKDOWN
-
-        def invoke_generators
-          # This needs to go first, since it configures `.node-version`
-          generate "suspenders:prerequisites"
-
-          generate "suspenders:accessibility"
-          generate "suspenders:advisories"
-          generate "suspenders:email"
-          generate "suspenders:factories"
-          generate "suspenders:inline_svg"
-          generate "suspenders:lint"
-          generate "suspenders:rake"
-          generate "suspenders:setup"
-          generate "suspenders:tasks"
-          generate "suspenders:testing"
-          generate "suspenders:views"
-
-          # suspenders:jobs needs to be invoked before suspenders:styles, since
-          # suspenders:styles generator creates Procfile.dev
-          generate "suspenders:styles"
-          generate "suspenders:jobs"
-
-          # Needs to run after other generators, since some touch the
-          # configuration files.
-          generate "suspenders:environments:test"
-          generate "suspenders:environments:development"
-          generate "suspenders:environments:production"
-
-          # Needs to be run last since it depends on lint, testing, and
-          # advisories
-          generate "suspenders:ci"
-        end
-
-        def cleanup
-          rake "suspenders:cleanup:organize_gemfile"
-          rake "suspenders:cleanup:generate_readme"
-          copy_file "CONTRIBUTING.md", "CONTRIBUTING.md"
-        end
-
-        def lint
-          run "yarn run fix:prettier"
-          run "bundle exec rake standard:fix_unsafely"
-        end
-      end
-    end
-  end
-end