Introduce suspenders:rake generator

Add necessary files to make the [plugin][] an [engine][], which
automatically loads Rake tasks located in `lib/tasks`. This means when
the `suspenders` gem is installed, the consumer can run `bundle exec
rake suspenders:rake`, and any future tasks.

Because `suspenders:lint` and `suspenders:advisories` may not
necessarily have been invoked, we need to check if those gems are
installed.

[plugin]: https://guides.rubyonrails.org/plugins.html
[engine]: https://guides.rubyonrails.org/engines.html

To Do

- [ ] RSpec
- [ ] Do we need to require bundler-audit in the Rakefile

Co-authored-by: Mike Burns <[email protected]>

NEWS.md

@@ -8,6 +8,7 @@ Unreleased
 * Introduce `suspenders:styles` generator
 * Introduce `suspenders:jobs` generator
 * Introduce `suspenders:lint` generator
+* Introduce `suspenders:rake` generator
 
 20230113.0 (January, 13, 2023)
 

README.md

@@ -30,6 +30,7 @@ Installs [capybara_accessibility_audit] and [capybara_accessible_selectors]
   [capybara_accessibility_audit]: https://github.com/thoughtbot/capybara_accessibility_audit
   [capybara_accessible_selectors]: https://github.com/citizensadvice/capybara_accessible_selectors
 
+<<<<<<< HEAD
 ### Advisories
 
 Show security advisories during development.
@@ -116,6 +117,16 @@ Installs [Sidekiq][] for background job processing and configures ActiveJob for
 
   [Sidekiq]: https://github.com/sidekiq/sidekiq
 
+### Rake
+
+Configures the default Rake task to audit and lint the codebase with
+[bundler-audit][] and [standard][].
+
+`/bin/rails g suspenders:rake`
+
+  [bundler-audit]: https://github.com/rubysec/bundler-audit
+  [standard]: https://github.com/standardrb/standard
+
 ## Contributing
 
 See the [CONTRIBUTING] document.

bin/rails

@@ -3,6 +3,7 @@
 # installed from the root of your application.
 
 ENGINE_ROOT = File.expand_path("..", __dir__)
+ENGINE_PATH = File.expand_path("../lib/suspenders/engine", __dir__)
 APP_PATH = File.expand_path("../test/dummy/config/application", __dir__)
 
 # Set up gems listed in the Gemfile.

lib/generators/suspenders/rake_generator.rb

@@ -0,0 +1,14 @@
+module Suspenders
+  module Generators
+    class RakeGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../templates/rake", __FILE__)
+      desc(<<~TEXT)
+        Configures the default Rake task to audit and lint the codebase with `bundler-audit` and `standard`.
+      TEXT
+
+      def configure_default_rake_task
+        append_to_file "Rakefile", %(task default: "suspenders:rake")
+      end
+    end
+  end
+end

lib/suspenders.rb

@@ -1,4 +1,5 @@
 require "suspenders/version"
+require "suspenders/engine"
 require "suspenders/railtie"
 require "suspenders/generators"
 

lib/suspenders/engine.rb

@@ -0,0 +1,5 @@
+module Suspenders
+  class Engine < ::Rails::Engine
+    isolate_namespace Suspenders
+  end
+end

lib/tasks/suspenders.rake

@@ -0,0 +1,12 @@
+namespace :suspenders do
+  desc "Default task for Suspenders"
+  task :rake do
+    if Bundler.rubygems.find_name("bundler-audit").any?
+      Rake::Task[:"bundle:audit"].invoke
+    end
+
+    if Bundler.rubygems.find_name("standard").any?
+      Rake::Task[:standard].invoke
+    end
+  end
+end

test/generators/suspenders/rake_generator_test.rb

@@ -0,0 +1,43 @@
+require "test_helper"
+require "generators/suspenders/rake_generator"
+
+module Suspenders
+  module Generators
+    class RakeGeneratorTest < Rails::Generators::TestCase
+      include Suspenders::TestHelpers
+
+      tests Suspenders::Generators::RakeGenerator
+      destination Rails.root
+      setup :prepare_destination
+      teardown :restore_destination
+
+      test "modifies existing Rakefile" do
+        run_generator
+
+        assert_file app_root("Rakefile") do |file|
+          assert_match /task default: "suspenders:rake"/, file
+        end
+      end
+
+      test "generator has a description" do
+        description = <<~TEXT
+          Configures the default Rake task to audit and lint the codebase with `bundler-audit` and `standard`.
+        TEXT
+
+        assert_equal description, generator_class.desc
+      end
+
+      private
+
+      def prepare_destination
+        touch "Gemfile"
+        backup_file "Rakefile"
+      end
+
+      def restore_destination
+        remove_file_if_exists "Gemfile"
+        restore_file "Rakefile"
+      end
+    end
+  end
+end