🔨 Better rake tasks for development

Author: pboling

Rakefile

@@ -2,80 +2,120 @@
 
 require "bundler/gem_tasks"
 
-require "version_gem"
+defaults = []
 
+# Setup Kettle Soup Cover
 begin
-  require "rspec/core/rake_task"
+  require "kettle-soup-cover"
 
-  RSpec::Core::RakeTask.new(:spec)
+  Kettle::Soup::Cover.install_tasks
+  # NOTE: Coverage on CI is configured independent of this task.
+  #       This task is for local development, as it opens results in browser
+  defaults << "coverage" unless Kettle::Soup::Cover::IS_CI
 rescue LoadError
-  task(:spec) do
-    warn("RSpec is disabled")
+  desc("(stub) coverage is unavailable")
+  task("coverage") do
+    warn("NOTE: kettle-soup-cover isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
   end
 end
 
-desc "alias test task to spec"
-task test: :spec
-
+# Setup stone_checksums
 begin
-  require "reek/rake/task"
+  require "stone_checksums"
 
-  Reek::Rake::Task.new do |t|
-    t.fail_on_error = true
-    t.verbose = false
-    t.source_files = "{spec,spec_ignored,spec_orms,lib}/**/*.rb"
-  end
+  GemChecksums.install_tasks
 rescue LoadError
-  task(:reek) do
-    warn("reek is disabled")
+  desc("(stub) build:generate_checksums is unavailable")
+  task("build:generate_checksums") do
+    warn("NOTE: stone_checksums isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
   end
 end
 
+# Setup Bundle Audit
 begin
-  require "yard-junk/rake"
+  require "bundler/audit/task"
 
-  YardJunk::Rake.define_task
+  Bundler::Audit::Task.new
+  defaults.push("bundle:audit:update", "bundle:audit")
 rescue LoadError
-  task("yard:junk") do
-    warn("yard:junk is disabled")
+  desc("(stub) bundle:audit is unavailable")
+  task("bundle:audit") do
+    warn("NOTE: bundler-audit isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
+  end
+  desc("(stub) bundle:audit:update is unavailable")
+  task("bundle:audit:update") do
+    warn("NOTE: bundler-audit isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
   end
 end
 
 begin
-  require "yard"
+  require "rspec/core/rake_task"
 
-  YARD::Rake::YardocTask.new(:yard)
+  RSpec::Core::RakeTask.new(:spec)
+  defaults << "spec"
 rescue LoadError
-  task(:yard) do
-    warn("yard is disabled")
+  desc("spec task stub")
+  task(:spec) do
+    warn("NOTE: rspec isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
   end
 end
 
+desc "run spec task with test task"
+task test: :spec
+
+# Setup Reek
 begin
-  require "rubocop/lts"
-  Rubocop::Lts.install_tasks
+  require "reek/rake/task"
+
+  Reek::Rake::Task.new do |t|
+    t.fail_on_error = true
+    t.verbose = false
+    t.source_files = "{lib,spec}/**/*.rb"
+  end
+  defaults << "reek"
 rescue LoadError
-  task(:rubocop_gradual) do
-    warn("RuboCop (Gradual) is disabled")
+  desc("(stub) reek is unavailable")
+  task(:reek) do
+    warn("NOTE: reek isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
   end
 end
 
+# Setup Yard
 begin
-  require "kettle-soup-cover"
-  Kettle::Soup::Cover.install_tasks
+  require "yard"
+
+  YARD::Rake::YardocTask.new(:yard) do |t|
+    t.files = [
+      # Splats (alphabetical)
+      "lib/**/*.rb",
+    ]
+  end
+  defaults << "yard"
 rescue LoadError
-  desc("alias coverage task to spec (coverage unavailable)")
-  task(coverage: :spec)
+  desc("(stub) yard is unavailable")
+  task(:yard) do
+    warn("NOTE: yard isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
+  end
 end
 
 begin
-  require "gem_checksums"
-  GemChecksums.install_tasks
+  require "rubocop/gradual/rake_task"
+
+  RuboCop::Gradual::RakeTask.new
+
+  defaults << "rubocop_gradual"
+
+  namespace(:rubocop_gradual) do
+    desc("dogfood internal rubocop configs")
+    task(:dogfood) do
+      %x(bin/rubocop-gradual -c .rubocop-dogfood.yml)
+    end
+  end
 rescue LoadError
-  task("build:generate_checksums") do
-    warn("gem_checksums is not available")
+  desc("(stub) rubocop_gradual is unavailable")
+  task(:rubocop_gradual) do
+    warn("NOTE: rubocop-gradual isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
   end
 end
 
-# coverage task will open coverage in browser locally
-task default: %i[coverage rubocop_gradual:autocorrect yard yard:junk]
+task default: defaults