tomo 1.17.0 → 1.18.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6202b071b5584a5fc5b2db693130e5160585b784822b2b220ff3685c4272f53c
-  data.tar.gz: 6c35312e003c7c00153a7ddf8d5c2761f19b9c16aa72d8f74b271f25b5f1d69c
+  metadata.gz: 1df37ae46768cbf38ec93e0a12a25344daf0214e4d51ec36e94b0910cc52fe09
+  data.tar.gz: 3005404f4cbb57a5bf7ef3df25cb6a84e55ab4a67752dae7022399bc2f8125a5
 SHA512:
-  metadata.gz: 3c1a3a5edc2e67bd5d1aa77231534ca36d379214a9d4fade127d81ae810cfd75137d600f8018c44d171c41a6d0d6abacbc2986cef629de661747fd2199997f4d
-  data.tar.gz: efd002dc923b18b4aa48f98d2fa79069c1713fbc604614a68f0fe1b9bc0477de591b83a280edfe1ea2c8fcf398408394a095bd56d8fab27f58ddba7c5748d2d9
+  metadata.gz: 5e06977997842a6ee0594857e1ae70d6c4d1bd9f5780d62d47b33b5e6b3aca7bf68d2ab5238b0074113f21a6ecea941afa3e721ad8a68b7f0ce2b6ad5a40663f
+  data.tar.gz: 0e1194fcdf339e9f52744fe1de2152d86350c812c5b4ad3035a5b25b4f84eb0a87e73e5c4802813acad916af41da78819b795ad27b93a73f9289b93925283914

data/README.md

@@ -1,8 +1,9 @@
 # Tomo
 
-[![Gem Version](https://badge.fury.io/rb/tomo.svg)](https://rubygems.org/gems/tomo)
-[![Build Status](https://mattbrictson.semaphoreci.com/badges/tomo/branches/main.svg?style=shields)](https://mattbrictson.semaphoreci.com/projects/tomo)
-[![Code Climate](https://codeclimate.com/github/mattbrictson/tomo/badges/gpa.svg)](https://codeclimate.com/github/mattbrictson/tomo)
+[![Gem Version](https://img.shields.io/gem/v/tomo)](https://rubygems.org/gems/tomo)
+[![Gem Downloads](https://img.shields.io/gem/dt/tomo)](https://www.ruby-toolbox.com/projects/tomo)
+[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/mattbrictson/tomo/ci.yml)](https://github.com/mattbrictson/tomo/actions/workflows/ci.yml)
+[![Code Climate maintainability](https://img.shields.io/codeclimate/maintainability/mattbrictson/tomo)](https://codeclimate.com/github/mattbrictson/tomo)
 
 Tomo is a friendly command-line tool for deploying Rails apps.
 
@@ -13,7 +14,7 @@ Tomo is a friendly command-line tool for deploying Rails apps.
 📚 Quality documentation<br/>
 🔬 Minimal dependencies<br/>
 
-[→ See how tomo compares to other Ruby deployment tools like Capistrano and Mina.](https://tomo-deploy.com/comparisons/)
+[→ See how tomo compares to other Ruby deployment tools like Capistrano and Mina.](https://tomo.mattbrictson.com/comparisons/)
 
 ---
 
@@ -21,6 +22,7 @@ Tomo is a friendly command-line tool for deploying Rails apps.
 - [Usage](#usage)
 - [Extending tomo](#extending-tomo)
 - [Tutorials](#tutorials)
+- [Blog posts](#blog-posts)
 - [Reference documentation](#reference-documentation)
 - [FAQ](#faq)
 - [Support](#support)
@@ -86,8 +88,8 @@ end
 
 #### Next steps
 
-[→ The reference docs have a complete guide to tomo configuration.](https://tomo-deploy.com/configuration/)<br>
-[→ Check out the **Deploying Rails From Scratch** tutorial for a step-by-step guide to using tomo with a real app.](https://tomo-deploy.com/tutorials/deploying-rails-from-scratch/)
+[→ The reference docs have a complete guide to tomo configuration.](https://tomo.mattbrictson.com/configuration/)<br>
+[→ Check out the **Deploying Rails From Scratch** tutorial for a step-by-step guide to using tomo with a real app.](https://tomo.mattbrictson.com/tutorials/deploying-rails-from-scratch/)
 
 ## Usage
 
@@ -111,25 +113,24 @@ Out of the box, tomo will:
 - Create all necessary deployment directories
 - Create the Rails database, load the schema, and insert seed data
 
-[→ Here is the default list of tasks invoked by the setup command.](https://tomo-deploy.com/configuration#setupblock)<br>
-[→ The `tomo setup` section of the reference docs explains supported command-line options.](https://tomo-deploy.com/commands/setup/)
+[→ Here is the default list of tasks invoked by the setup command.](https://tomo.mattbrictson.com/configuration#setupblock)<br>
+[→ The `tomo setup` section of the reference docs explains supported command-line options.](https://tomo.mattbrictson.com/commands/setup/)
 
 ### `tomo deploy`
 
 Whereas `tomo setup` is typically run once, you can use `tomo deploy` every time you want to deploy a new version of your app. The deploy command will sequentially run the `deploy` list of tasks specified in `.tomo/config.rb`. You can customize this list to meet the needs of your app. By default, tomo runs these tasks:
 
-1. Create a release (using the [git:create_release](https://tomo-deploy.com/plugins/git#gitcreate_release) task)
-2. Build the project (e.g. [bundler:install](https://tomo-deploy.com/plugins/bundler#bundlerinstall), [rails:assets_precompile](https://tomo-deploy.com/plugins/rails#railsassets_precompile))
-3. Migrate data to the meet the requirements of the new release (e.g. [rails:db_migrate](https://tomo-deploy.com/plugins/rails#railsdb_migrate))
-4. Make the new release the "current" one ([core:symlink_current](https://tomo-deploy.com/plugins/core#coresymlink_current))
-5. Restart the app to use the new current release (e.g. [puma:restart](https://tomo-deploy.com/plugins/puma#pumarestart))
-6. Perform any cleanup (e.g. [bundler:clean](https://tomo-deploy.com/plugins/bundler#bundlerclean))
+1. Create a release (using the [git:create_release](https://tomo.mattbrictson.com/plugins/git#gitcreate_release) task)
+2. Build the project (e.g. [bundler:install](https://tomo.mattbrictson.com/plugins/bundler#bundlerinstall), [rails:assets_precompile](https://tomo.mattbrictson.com/plugins/rails#railsassets_precompile))
+3. Migrate data to the meet the requirements of the new release (e.g. [rails:db_migrate](https://tomo.mattbrictson.com/plugins/rails#railsdb_migrate))
+4. Make the new release the "current" one ([core:symlink_current](https://tomo.mattbrictson.com/plugins/core#coresymlink_current))
+5. Restart the app to use the new current release (e.g. [puma:restart](https://tomo.mattbrictson.com/plugins/puma#pumarestart))
+6. Perform any cleanup (e.g. [bundler:clean](https://tomo.mattbrictson.com/plugins/bundler#bundlerclean))
 
 > 💡 **Protip:** you can abbreviate tomo commands, like `tomo d` for `tomo deploy` or `tomo s` for `tomo setup`.
 
-[→ Here is the default list of tasks invoked by the deploy command.](https://tomo-deploy.com/configuration#deployblock)<br>
-[→ The `tomo deploy` section of the reference docs explains supported command-line options, like `--dry-run`.](https://tomo-deploy.com/commands/deploy/)
-
+[→ Here is the default list of tasks invoked by the deploy command.](https://tomo.mattbrictson.com/configuration#deployblock)<br>
+[→ The `tomo deploy` section of the reference docs explains supported command-line options, like `--dry-run`.](https://tomo.mattbrictson.com/commands/deploy/)
 
 ### `tomo run [TASK]`
 
@@ -143,9 +144,7 @@ One of the built-in Rails tasks is `rails:console`, which brings up a fully-inte
 
 > 💡 **Protip:** you can shorten this as `tomo rails:console` (the `run` command is implied).
 
-[→ The `tomo run` section of the reference docs explains supported command-line options and has more examples.](https://tomo-deploy.com/commands/run/)
-
-
+[→ The `tomo run` section of the reference docs explains supported command-line options and has more examples.](https://tomo.mattbrictson.com/commands/run/)
 
 ## Extending tomo
 
@@ -171,43 +170,47 @@ And run it!
 
 ![$ tomo run my-plugin:hello](./readme_images/tomo-run-hello.png)
 
-[→ The **Writing Custom Tasks** tutorial has an in-depth explanation of how plugins work.](https://tomo-deploy.com/tutorials/writing-custom-tasks/)<br>
-[→ The **TaskLibrary** API is tomo's DSL for building tasks.](https://tomo-deploy.com/api/TaskLibrary/)<br>
-[→ The **Publishing a Plugin** tutorial explains how to package your plugin as a Ruby gem to share it with the community.](https://tomo-deploy.com/tutorials/publishing-a-plugin/)
+[→ The **Writing Custom Tasks** tutorial has an in-depth explanation of how plugins work.](https://tomo.mattbrictson.com/tutorials/writing-custom-tasks/)<br>
+[→ The **TaskLibrary** API is tomo's DSL for building tasks.](https://tomo.mattbrictson.com/api/TaskLibrary/)<br>
+[→ The **Publishing a Plugin** tutorial explains how to package your plugin as a Ruby gem to share it with the community.](https://tomo.mattbrictson.com/tutorials/publishing-a-plugin/)
 
 ## Tutorials
 
-- [Deploying Rails From Scratch](https://tomo-deploy.com/tutorials/deploying-rails-from-scratch/)
-- [Writing Custom Tasks](https://tomo-deploy.com/tutorials/writing-custom-tasks/)
-- [Publishing a Plugin](https://tomo-deploy.com/tutorials/publishing-a-plugin/)
+- [Deploying Rails From Scratch](https://tomo.mattbrictson.com/tutorials/deploying-rails-from-scratch/)
+- [Writing Custom Tasks](https://tomo.mattbrictson.com/tutorials/writing-custom-tasks/)
+- [Publishing a Plugin](https://tomo.mattbrictson.com/tutorials/publishing-a-plugin/)
+
+## Blog posts
+
+- [Automate Rails deployments with GitHub Actions](https://mattbrictson.com/blog/deploy-rails-with-github-actions)
 
 ## Reference documentation
 
-- [Configuration](https://tomo-deploy.com/configuration/)
+- [Configuration](https://tomo.mattbrictson.com/configuration/)
 - Commands
-  - [init](https://tomo-deploy.com/commands/init/)
-  - [setup](https://tomo-deploy.com/commands/setup/)
-  - [deploy](https://tomo-deploy.com/commands/deploy/)
-  - [run](https://tomo-deploy.com/commands/run/)
-  - [tasks](https://tomo-deploy.com/commands/tasks/)
+  - [init](https://tomo.mattbrictson.com/commands/init/)
+  - [setup](https://tomo.mattbrictson.com/commands/setup/)
+  - [deploy](https://tomo.mattbrictson.com/commands/deploy/)
+  - [run](https://tomo.mattbrictson.com/commands/run/)
+  - [tasks](https://tomo.mattbrictson.com/commands/tasks/)
 - Plugins
-  - [core](https://tomo-deploy.com/plugins/core/)
-  - [bundler](https://tomo-deploy.com/plugins/bundler/)
-  - [env](https://tomo-deploy.com/plugins/env/)
-  - [git](https://tomo-deploy.com/plugins/git/)
-  - [nodenv](https://tomo-deploy.com/plugins/nodenv/)
-  - [puma](https://tomo-deploy.com/plugins/puma/)
-  - [rails](https://tomo-deploy.com/plugins/rails/)
-  - [rbenv](https://tomo-deploy.com/plugins/rbenv/)
+  - [core](https://tomo.mattbrictson.com/plugins/core/)
+  - [bundler](https://tomo.mattbrictson.com/plugins/bundler/)
+  - [env](https://tomo.mattbrictson.com/plugins/env/)
+  - [git](https://tomo.mattbrictson.com/plugins/git/)
+  - [nodenv](https://tomo.mattbrictson.com/plugins/nodenv/)
+  - [puma](https://tomo.mattbrictson.com/plugins/puma/)
+  - [rails](https://tomo.mattbrictson.com/plugins/rails/)
+  - [rbenv](https://tomo.mattbrictson.com/plugins/rbenv/)
 - API
-  - [Host](https://tomo-deploy.com/api/Host/)
-  - [Logger](https://tomo-deploy.com/api/Logger/)
-  - [Paths](https://tomo-deploy.com/api/Paths/)
-  - [PluginDSL](https://tomo-deploy.com/api/PluginDSL/)
-  - [Remote](https://tomo-deploy.com/api/Remote/)
-  - [Result](https://tomo-deploy.com/api/Result/)
-  - [TaskLibrary](https://tomo-deploy.com/api/TaskLibrary/)
-  - [Testing::MockPluginTester](https://tomo-deploy.com/api/testing/MockPluginTester/)
+  - [Host](https://tomo.mattbrictson.com/api/Host/)
+  - [Logger](https://tomo.mattbrictson.com/api/Logger/)
+  - [Paths](https://tomo.mattbrictson.com/api/Paths/)
+  - [PluginDSL](https://tomo.mattbrictson.com/api/PluginDSL/)
+  - [Remote](https://tomo.mattbrictson.com/api/Remote/)
+  - [Result](https://tomo.mattbrictson.com/api/Result/)
+  - [TaskLibrary](https://tomo.mattbrictson.com/api/TaskLibrary/)
+  - [Testing::MockPluginTester](https://tomo.mattbrictson.com/api/testing/MockPluginTester/)
 
 ## FAQ
 
@@ -224,7 +227,7 @@ set ssh_strict_host_key_checking: true # or false
 
 Tomo relies on the host user's bash profile for various things, like setting environment variables and initializing rbenv and nodenv. This makes it impractical to deploy multiple apps to a single host using the same deploy user.
 
-The solution is to create multiple users on the remote host, and then configure a different user for deploying each app. That way each user can have its own distinct environment variables and you can easily configure each app differently without risking conflicts. Refer to the [tomo Rails tutorial](https://tomo-deploy.com/tutorials/deploying-rails-from-scratch/#set-up-a-deployer-user) for instructions on creating a deploy user.
+The solution is to create multiple users on the remote host, and then configure a different user for deploying each app. That way each user can have its own distinct environment variables and you can easily configure each app differently without risking conflicts. Refer to the [tomo Rails tutorial](https://tomo.mattbrictson.com/tutorials/deploying-rails-from-scratch/#set-up-a-deployer-user) for instructions on creating a deploy user.
 
 E.g. app1 would be configured to deploy as:
 

data/lib/tomo/cli/completions.rb

@@ -45,7 +45,7 @@ module Tomo
 
         # Don't complete the =value part of long switch unless the user has
         # already typed at least up to the = sign.
-        return true if cand.match?(/\A--.*=/) && !word.match?(/\A--.*=/)
+        true if cand.match?(/\A--.*=/) && !word.match?(/\A--.*=/)
       end
 
       # bash tokenizes the user's input prior to completion, and expects the

data/lib/tomo/cli/usage.rb

@@ -26,7 +26,7 @@ module Tomo
       attr_reader :banner_proc, :options
 
       def options_help
-        width = options.map(&:first).map(&:length).max
+        width = options.map { |opt| opt.first.length }.max
         options.each_with_object([]) do |(spec, desc), help|
           help << "#{Colors.yellow(spec.ljust(width))}    #{desc}"
         end.join("\n")

data/lib/tomo/commands/default.rb

@@ -33,7 +33,7 @@ module Tomo
 
           Or read the full documentation for all commands at:
 
-            #{blue('https://tomo-deploy.com/')}
+            #{blue('https://tomo.mattbrictson.com/')}
         BANNER
       end
 

data/lib/tomo/commands/deploy.rb

@@ -39,7 +39,7 @@ module Tomo
 
           More documentation and examples can be found here:
 
-            #{blue('https://tomo-deploy.com/commands/deploy')}
+            #{blue('https://tomo.mattbrictson.com/commands/deploy')}
         BANNER
       end
 

data/lib/tomo/commands/init.rb

@@ -30,11 +30,9 @@ module Tomo
 
         app = args.first || current_dir_name || "default"
         app = app.gsub(/([^\w-]|_)+/, "_").downcase
-        FileUtils.mkdir_p(".tomo/plugins")
-
-        # TODO: use a template for this file
-        FileUtils.touch(".tomo/plugins/#{app}.rb")
 
+        FileUtils.mkdir_p(".tomo/plugins")
+        File.write(".tomo/plugins/#{app}.rb", plugin_rb_template)
         File.write(DEFAULT_CONFIG_PATH, config_rb_template(app))
 
         logger.info(green("✔ Created #{DEFAULT_CONFIG_PATH}"))
@@ -71,10 +69,22 @@ module Tomo
         nil
       end
 
-      def git_branch
+      def git_main_branch
         return unless File.file?(".git/config")
 
-        `git rev-parse --abbrev-ref HEAD`.chomp
+        # If "main" or "master" is in the list of branch names, use that
+        branch = (%w[main master] & `git branch`.scan(/^\W*(.+)$/).flatten).first
+
+        # If not, use the current branch
+        if branch.nil?
+          branch = if `git --version`[/\d+\.\d+/].to_f >= 2.22
+                     `git branch --show-current`.chomp
+                   else
+                     `git rev-parse --abbrev-ref HEAD`.chomp
+                   end
+        end
+
+        branch.empty? ? nil : branch
       rescue SystemCallError
         nil
       end
@@ -119,6 +129,12 @@ module Tomo
         template = File.read(path)
         ERB.new(template, trim_mode: "-").result(binding)
       end
+
+      def plugin_rb_template
+        path = File.expand_path("../templates/plugin.rb.erb", __dir__)
+        template = File.read(path)
+        ERB.new(template, trim_mode: "-").result(binding)
+      end
     end
   end
 end

data/lib/tomo/commands/run.rb

@@ -46,7 +46,7 @@ module Tomo
 
           For more documentation and examples, visit:
 
-            #{blue('https://tomo-deploy.com/commands/run')}
+            #{blue('https://tomo.mattbrictson.com/commands/run')}
         BANNER
       end
 

data/lib/tomo/commands/setup.rb

@@ -24,7 +24,7 @@ module Tomo
 
           More documentation and examples can be found here:
 
-            #{blue('https://tomo-deploy.com/commands/setup')}
+            #{blue('https://tomo.mattbrictson.com/commands/setup')}
         BANNER
       end
 

data/lib/tomo/configuration/dsl/error_formatter.rb

@@ -35,7 +35,7 @@ module Tomo
             #{highlighted_lines}
             #{Colors.red([self.class, message].join(': '))}
 
-            Visit #{Colors.blue('https://tomo-deploy.com/configuration')} for syntax reference.
+            Visit #{Colors.blue('https://tomo.mattbrictson.com/configuration')} for syntax reference.
             #{trace_hint}
           ERROR
         end

data/lib/tomo/host.rb

@@ -10,7 +10,7 @@ module Tomo
       user, address = host.match(PATTERN).captures
       raise ArgumentError, "host cannot be blank" if address.empty?
 
-      new(**{ user: user, address: address }.merge(kwargs))
+      new(user: user, address: address, **kwargs)
     end
 
     def initialize(address:, port: nil, log_prefix: nil, roles: nil, user: nil, privileged_user: "root")

data/lib/tomo/plugin/bundler/tasks.rb

@@ -5,6 +5,7 @@ module Tomo::Plugin::Bundler
     CONFIG_SETTINGS = %i[
       bundler_deployment
       bundler_gemfile
+      bundler_ignore_messages
       bundler_jobs
       bundler_path
       bundler_retry

data/lib/tomo/plugin/bundler.rb

@@ -8,13 +8,14 @@ module Tomo::Plugin
     tasks Tomo::Plugin::Bundler::Tasks
     helpers Tomo::Plugin::Bundler::Helpers
 
-    defaults bundler_config_path: ".bundle/config",
-             bundler_deployment:  true,
-             bundler_gemfile:     nil,
-             bundler_jobs:        nil,
-             bundler_path:        "%{shared_path}/bundle",
-             bundler_retry:       "3",
-             bundler_version:     nil,
-             bundler_without:     %w[development test]
+    defaults bundler_config_path:     ".bundle/config",
+             bundler_deployment:      true,
+             bundler_gemfile:         nil,
+             bundler_ignore_messages: true,
+             bundler_jobs:            nil,
+             bundler_path:            "%{shared_path}/bundle",
+             bundler_retry:           "3",
+             bundler_version:         nil,
+             bundler_without:         %w[development test]
   end
 end

data/lib/tomo/plugin/core/helpers.rb

@@ -3,7 +3,7 @@ require "shellwords"
 module Tomo::Plugin::Core
   module Helpers
     def capture(*command, **run_opts)
-      result = run(*command, **{ silent: true }.merge(run_opts))
+      result = run(*command, silent: true, **run_opts)
       result.stdout
     end
 
@@ -18,7 +18,8 @@ module Tomo::Plugin::Core
       message = "Writing #{text.bytesize} bytes to #{to}"
       run(
         "echo -n #{text.shellescape} #{append ? '>>' : '>'} #{to.shellescape}",
-        **{ echo: message }.merge(run_opts)
+        echo: message,
+        **run_opts
       )
     end
 
@@ -43,7 +44,7 @@ module Tomo::Plugin::Core
     end
 
     def command_available?(command_name, **run_opts)
-      run?("which", command_name, **{ silent: true }.merge(run_opts))
+      run?("which", command_name, silent: true, **run_opts)
     end
 
     def file?(file, **run_opts)

data/lib/tomo/plugin/env/tasks.rb

@@ -129,7 +129,7 @@ module Tomo::Plugin::Env
         user@host. To deploy multiple applications to the same host, use a separate
         deployer user per app. Refer to the tomo FAQ for details:
 
-          https://tomo-deploy.com/#faq
+          https://tomo.mattbrictson.com/#faq
 
         You may be receiving this message in error if you recently renamed or
         reconfigured your application. In this case, remove the references to the

data/lib/tomo/plugin/puma/tasks.rb

@@ -81,7 +81,7 @@ module Tomo::Plugin::Puma
 
     def setup_directories
       files = [service.path, socket.path].compact
-      dirs = files.map(&:dirname).map(&:to_s)
+      dirs = files.map { |f| f.dirname.to_s }
       remote.mkdir_p dirs.uniq
     end
 

data/lib/tomo/remote.rb

@@ -21,7 +21,7 @@ module Tomo
 
     def attach(*command, default_chdir: nil, **command_opts)
       full_command = shell_builder.build(*command, default_chdir: default_chdir)
-      ssh.ssh_exec(Script.new(full_command, **{ pty: true }.merge(command_opts)))
+      ssh.ssh_exec(Script.new(full_command, pty: true, **command_opts))
     end
 
     def run(*command, attach: false, default_chdir: nil, **command_opts)

data/lib/tomo/runtime/concurrent_ruby_thread_pool.rb

@@ -17,10 +17,10 @@ module Tomo
         @promises = []
       end
 
-      def post(*args, &block)
+      def post(...)
         return if failure?
 
-        promises << future_on(executor, *args, &block)
+        promises << future_on(executor, ...)
           .on_rejection_using(executor) do |reason|
             self.failure = reason
           end

data/lib/tomo/runtime/explanation.rb

@@ -22,7 +22,7 @@ module Tomo
             indent = threads > 1 ? "  = " : ""
             if threads > 1 && step.applicable_tasks.length > 1
               desc << "#{indent}IN SEQUENCE:"
-              indent.sub!(/=/, "   ")
+              indent.sub!("=", "   ")
             end
             desc << step.explain.gsub(/^/, indent)
           end

data/lib/tomo/runtime/no_tasks_error.rb

@@ -10,7 +10,7 @@ module Tomo
 
           More configuration documentation and examples can be found here:
 
-            #{blue('https://tomo-deploy.com/configuration')}
+            #{blue('https://tomo.mattbrictson.com/configuration')}
         ERROR
       end
     end

data/lib/tomo/runtime/settings_interpolation.rb

@@ -39,7 +39,7 @@ module Tomo
       end
 
       def dump_settings(hash)
-        key_len = hash.keys.map(&:to_s).map(&:length).max
+        key_len = hash.keys.map { |k| k.to_s.length }.max
         dump = "Settings: {\n"
         hash.to_a.sort_by(&:first).each do |key, value|
           justified_key = "#{key}:".ljust(key_len + 1)

data/lib/tomo/shell_builder.rb

@@ -67,7 +67,7 @@ module Tomo
     def shell_join(*command)
       return command.first.to_s if command.length == 1
 
-      command.flatten.compact.map(&:to_s).map(&:shellescape).join(" ")
+      command.flatten.compact.map { |arg| arg.to_s.shellescape }.join(" ")
     end
 
     def cd_chdir

data/lib/tomo/templates/config.rb.erb

@@ -22,7 +22,7 @@ set nodenv_node_version: <%= node_version&.inspect || "nil # FIXME" %>
 <% end -%>
 set nodenv_install_yarn: <%= yarn_version ? "true" : "false" %>
 set git_url: <%= git_origin_url&.inspect || "nil # FIXME" %>
-set git_branch: <%= git_branch&.inspect || "nil # FIXME" %>
+set git_branch: <%= git_main_branch&.inspect || "nil # FIXME" %>
 set git_exclusions: %w[
   .tomo/
   spec/

data/lib/tomo/templates/plugin.rb.erb

@@ -0,0 +1 @@
+# https://tomo.mattbrictson.com/tutorials/writing-custom-tasks/

data/lib/tomo/version.rb

@@ -1,3 +1,3 @@
 module Tomo
-  VERSION = "1.17.0".freeze
+  VERSION = "1.18.1".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tomo
 version: !ruby/object:Gem::Version
-  version: 1.17.0
+  version: 1.18.1
 platform: ruby
 authors:
 - Matt Brictson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-06-13 00:00:00.000000000 Z
+date: 2023-11-22 00:00:00.000000000 Z
 dependencies: []
 description: Tomo is a feature-rich deployment tool that contains everything you need
   to deploy a basic Rails app out of the box. It has an opinionated, production-tested
@@ -145,6 +145,7 @@ files:
 - lib/tomo/task_api.rb
 - lib/tomo/task_library.rb
 - lib/tomo/templates/config.rb.erb
+- lib/tomo/templates/plugin.rb.erb
 - lib/tomo/testing.rb
 - lib/tomo/testing/Dockerfile
 - lib/tomo/testing/cli_extensions.rb
@@ -172,7 +173,7 @@ metadata:
   changelog_uri: https://github.com/mattbrictson/tomo/releases
   source_code_uri: https://github.com/mattbrictson/tomo
   homepage_uri: https://github.com/mattbrictson/tomo
-  documentation_uri: https://tomo-deploy.com/
+  documentation_uri: https://tomo.mattbrictson.com/
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
@@ -189,7 +190,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.13
+rubygems_version: 3.4.21
 signing_key:
 specification_version: 4
 summary: A friendly CLI for deploying Rails apps ✨