Introduce suspenders:setup generator

NEWS.md

@@ -10,6 +10,7 @@ Unreleased
 * Introduce `suspenders:lint` generator
 * Introduce `suspenders:rake` generator
 * Introduce `suspenders:views` generator
+* Introduce `suspenders:setup` generator
 
 20230113.0 (January, 13, 2023)
 

README.md

@@ -134,6 +134,20 @@ document [lang][].
 [title]: https://github.com/calebhearth/title
 [lang]: https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang
 
+### Setup
+
+A holistic setup script.
+
+```sh
+bin/setup
+```
+
+or
+
+```sh
+WIPE_DATABASE=true bin/setup
+```
+
 ## Contributing
 
 See the [CONTRIBUTING] document.

lib/generators/suspenders/setup_generator.rb

@@ -0,0 +1,32 @@
+module Suspenders
+  module Generators
+    class SetupGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../templates/setup", __FILE__)
+      desc <<~TEXT
+        A holistic setup script.
+
+        ```sh
+        bin/setup
+        ```
+
+        or
+
+        ```sh
+        WIPE_DATABASE=true bin/setup
+        ```
+      TEXT
+
+      def create_brewfile
+        copy_file "brewfile", "Brewfile"
+      end
+
+      def create_dev_prime
+        copy_file "dev_prime.rb", "lib/tasks/dev.rake"
+      end
+
+      def replace_bin_setup
+        copy_file "bin_setup.rb", "bin/setup", force: true
+      end
+    end
+  end
+end

lib/generators/templates/setup/bin_setup.rb

@@ -0,0 +1,59 @@
+#!/usr/bin/env ruby
+require "fileutils"
+require "open3"
+
+# path to your application root.
+APP_ROOT = File.expand_path("..", __dir__)
+
+def system!(*args)
+  system(*args, exception: true)
+end
+
+def using_node?
+  File.exist? "package.json"
+end
+
+FileUtils.chdir APP_ROOT do
+  if ENV["CI"].nil?
+    puts "\n== Installing Homebrew Bundle from Brewfile =="
+    system! "brew bundle"
+
+    puts "\n== Starting postgresql@15 =="
+    system! "brew services restart postgresql@15"
+
+    puts "\n== Starting redis =="
+    system! "brew services restart redis"
+
+    _, _, status = Open3.capture3("which asdf")
+    if status.success?
+      puts "\n== Installing tool dependecies via asdf =="
+      system! "asdf plugin-add ruby https://github.com/asdf-vm/asdf-ruby"
+      system! "asdf plugin-add nodejs https://github.com/asdf-vm/asdf-nodejs" if using_node?
+      system! "asdf plugin-add yarn https://github.com/twuni/asdf-yarn" if using_node?
+      system! "asdf plugin-update --all"
+      system! "asdf install"
+    end
+  end
+
+  puts "\n== Installing dependencies =="
+  system! "gem install bundler --conservative"
+  system("bundle check") || system!("bundle install")
+  system("yarn install --check-files") if using_node?
+
+  puts "\n== Preparing database and adding development seed data =="
+  if ENV["WIPE_DATABASE"] == true
+    system! "bin/rails db:reset dev:prime"
+  else
+    system! "bin/rails dev:prime"
+  end
+
+  # https://github.com/rails/rails/pull/47719/files
+  puts "\n== Setup test environment =="
+  system! "bin/rails test:prepare"
+
+  puts "\n== Removing old logs and tempfiles =="
+  system! "bin/rails log:clear tmp:clear"
+
+  puts "\n== Restarting application server =="
+  system! "bin/rails restart"
+end

lib/generators/templates/setup/brewfile

@@ -0,0 +1,9 @@
+# https://formulae.brew.sh/formula/vips
+brew "vips"
+
+# https://formulae.brew.sh/formula/redis
+brew "redis"
+
+# https://formulae.brew.sh/formula/postgresql@15
+# Change version to match production
+brew "postgresql@15"

lib/generators/templates/setup/dev_prime.rb

@@ -0,0 +1,12 @@
+if Rails.env.development? || Rails.env.test?
+  require "factory_bot" if Bundler.rubygems.find_name("factory_bot_rails").any?
+
+  namespace :dev do
+    desc "Sample data for local development environment"
+    task prime: "db:setup" do
+      include FactoryBot::Syntax::Methods if Bundler.rubygems.find_name("factory_bot_rails").any?
+
+      # create(:user, email: "[email protected]", password: "password")
+    end
+  end
+end

test/generators/suspenders/setup_generator_test.rb

@@ -0,0 +1,88 @@
+require "test_helper"
+require "generators/suspenders/setup_generator"
+
+module Suspenders
+  module Generators
+    class SetupGeneratorTest < Rails::Generators::TestCase
+      include Suspenders::TestHelpers
+
+      tests Suspenders::Generators::SetupGenerator
+      destination Rails.root
+      setup :prepare_destination
+      teardown :restore_destination
+
+      test "creates Brewfile" do
+        expected = <<~TEXT
+          # https://formulae.brew.sh/formula/vips
+          brew "vips"
+
+          # https://formulae.brew.sh/formula/redis
+          brew "redis"
+
+          # https://formulae.brew.sh/formula/postgresql@15
+          # Change version to match production
+          brew "postgresql@15"
+        TEXT
+
+        run_generator
+
+        assert_file app_root("Brewfile") do |file|
+          assert_equal expected, file
+        end
+      end
+
+      test "modifies bin/setup" do
+        expected = bin_setup
+
+        run_generator
+
+        assert_file app_root("bin/setup") do |file|
+          assert_equal expected, file
+        end
+      end
+
+      test "creates dev:prime task" do
+        expected = <<~RUBY
+          if Rails.env.development? || Rails.env.test?
+            require "factory_bot" if Bundler.rubygems.find_name("factory_bot_rails").any?
+
+            namespace :dev do
+              desc "Sample data for local development environment"
+              task prime: "db:setup" do
+                include FactoryBot::Syntax::Methods if Bundler.rubygems.find_name("factory_bot_rails").any?
+
+                # create(:user, email: "[email protected]", password: "password")
+              end
+            end
+          end
+        RUBY
+
+        run_generator
+
+        assert_file app_root("lib/tasks/dev.rake") do |file|
+          assert_equal expected, file
+        end
+      end
+
+      test "has a custom description" do
+        assert_no_match(/Description:/, generator_class.desc)
+      end
+
+      private
+
+      def prepare_destination
+        backup_file "bin/setup"
+      end
+
+      def restore_destination
+        remove_file_if_exists "Brewfile"
+        restore_file "bin/setup"
+        remove_dir_if_exists "lib/tasks"
+      end
+
+      def bin_setup
+        File.read("./lib/generators/templates/setup/bin_setup.rb")
+      end
+    end
+  end
+end