rails-worktrees 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c6da0f27411c99c20b5ab3496a4ac0672ba6a3833e429b33b53b5884d3a3c76
-  data.tar.gz: cb144472bad91868165d8a37de3ba12f0675255aabc2fa3df0d9e8d6c3d736ff
+  metadata.gz: 5cf1debd660652a5429a2d5485e944006685268b423866a96e15af71f9cb3471
+  data.tar.gz: 14f6a3f5efaa6b829026b3d4d085c9b55d09236cb7b610bafa8f8834a534fb5b
 SHA512:
-  metadata.gz: 7d959fde216a23fa191dca31294ff776b0091e3f230db9191a87890e8736217c3182b773e2950b18cbc151c20f833b238b7f3a07e618a5a4aa997bad5191760e
-  data.tar.gz: 7abecada6524724a90bd993b3975ce8b20a05e5123c0a9e2f6a2e8bc3d5435d04590a2ba3df83561ec41004d03d83627d48659866290b78b5ce4ed3bebbabfb1
+  metadata.gz: e16d066bfb55c97b959e92b4c25d1b2ac08404a728cadf077852a937a1a4c00ea17ca0c08dcfecc571654f836ba0aeccc6f81b08b6a96f7a4443093681d3b25d
+  data.tar.gz: f7fdc3e954463fed68f62934d153fbe4b086fb86f4be97c8f8e172b54c0bcc4d402587b99c2b171cc024f7ef53be14e950da311399e49ef0a491d696ac15dc64

data/.release-please-manifest.json

@@ -1 +1 @@
-{".":"0.1.1"}
+{".":"0.2.0"}

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.2.0](https://github.com/asjer/rails-worktrees/compare/v0.1.1...v0.2.0) (2026-03-30)
+
+
+### Features
+
+* add `--yolo` mode to install common follow-ups without manual edits ([1ec82ec](https://github.com/asjer/rails-worktrees/commit/1ec82ec83726b5ca9cbaee39697c607fdb825f26))
+
 ## [0.1.1](https://github.com/asjer/rails-worktrees/compare/v0.1.0...v0.1.1) (2026-03-30)
 
 

data/README.md

@@ -13,6 +13,8 @@
 ```bash
 bundle add rails-worktrees
 bin/rails generate worktrees:install
+# or, to apply the common Procfile.dev + mise follow-ups automatically:
+bin/rails generate worktrees:install --yolo
 ```
 
 The installer adds:
@@ -22,6 +24,11 @@ The installer adds:
 - `Procfile.dev.worktree.example` — a copy-paste helper for `${DEV_PORT:-3000}` in `Procfile.dev`
 - a safe update to `config/database.yml` for common development/test database names
 
+With `--yolo`, the installer also:
+
+- replaces the existing `web:` entry in `Procfile.dev` with the DEV_PORT-aware command when `Procfile.dev` already exists
+- updates `mise.toml` or `.mise.toml` to load `.env` from `[env]` when either file already exists
+
 ## Usage
 
 ```bash
@@ -115,12 +122,17 @@ When `bin/wt` creates a worktree it writes a worktree-local `.env` with:
 
 Existing `.env` values are never overwritten.
 
-The gem does **not** edit your `Procfile.dev` or add dotenv. The installer generates `Procfile.dev.worktree.example` with a ready-to-copy line:
+By default, the installer does **not** edit your `Procfile.dev` or `mise` config. It generates `Procfile.dev.worktree.example` with a ready-to-copy line:
 
 ```text
 web: env RUBY_DEBUG_OPEN=true bin/rails server -b 0.0.0.0 -p ${DEV_PORT:-3000}
 ```
 
+If you run `bin/rails generate worktrees:install --yolo`, the installer applies the two common follow-ups for you when the files already exist:
+
+- replace the existing `web:` entry in `Procfile.dev`
+- add `_.file = ".env"` to the `[env]` section of `mise.toml` or `.mise.toml`
+
 Use a project-local env loader like `mise` with `_.file = ".env"` to keep values scoped per-worktree.
 
 ## Development
@@ -141,8 +153,8 @@ This smoke test:
 
 - creates a temporary Rails app from a compatible Rails version
 - installs `rails-worktrees` from the current checkout path
-- runs `bin/rails generate worktrees:install`
-- verifies `bin/wt`, the generated initializer, the Procfile example, `config/database.yml` patching, and worktree `.env` bootstrapping
+- runs `bin/rails generate worktrees:install --yolo`
+- verifies `bin/wt`, the generated initializer, the Procfile example, yolo updates to `Procfile.dev` and `mise.toml`, `config/database.yml` patching, and worktree `.env` bootstrapping
 - creates a temporary bare `origin` and confirms `bin/wt smoke-branch` creates a real worktree
 
 By default, the script cleans up all temp directories after the run. Set `KEEP_SMOKE_TEST_ARTIFACTS=1` to keep them around for debugging, or set `RAILS_WORKTREES_SMOKE_RAILS_VERSION` to try a different compatible Rails version.

data/lib/generators/rails/worktrees/mise_follow_up.rb

@@ -11,7 +11,8 @@ module Rails
           [
             '',
             '      Tip:',
-            '        Detected mise.toml. To auto-load the worktree-local .env when you enter a worktree,',
+            "        Detected #{File.basename(mise_toml_path)}. To auto-load the worktree-local .env when",
+            '        you enter a worktree,',
             '        consider adding:',
             '          [env]',
             '          _.file = ".env"'
@@ -19,15 +20,24 @@ module Rails
         end
 
         def suggest_mise_env_file?
-          File.file?(mise_toml_path) && !mise_env_file_configured?
+          mise_toml_path && !mise_env_file_configured?
         end
 
         def mise_env_file_configured?
-          File.read(mise_toml_path).match?(/^\s*_.file\s*=\s*["']\.env["']\s*$/)
+          return false unless mise_toml_path
+
+          File.read(mise_toml_path).match?(/^\s*_.file\s*=\s*["']\.env["']\s*(?:#.*)?\s*$/)
         end
 
         def mise_toml_path
-          File.join(destination_root, 'mise.toml')
+          @mise_toml_path ||= mise_toml_paths.find { |path| File.file?(path) }
+        end
+
+        def mise_toml_paths
+          [
+            File.join(destination_root, 'mise.toml'),
+            File.join(destination_root, '.mise.toml')
+          ]
         end
       end
     end

data/lib/generators/worktrees/install/install_generator.rb

@@ -3,10 +3,13 @@ require 'rails/generators'
 
 require_relative '../../rails/worktrees/mise_follow_up'
 require_relative '../../../rails/worktrees/database_config_updater'
+require_relative '../../../rails/worktrees/procfile_updater'
+require_relative '../../../rails/worktrees/mise_toml_updater'
 
 module Worktrees
   module Generators
     # Installs the wt wrapper, configuration, and safe database.yml updates.
+    # rubocop:disable Metrics/ClassLength
     class InstallGenerator < ::Rails::Generators::Base
       include ::Rails::Worktrees::Generators::MiseFollowUp
 
@@ -15,6 +18,8 @@ module Worktrees
       source_root File.expand_path('../../rails/worktrees/templates', __dir__)
       class_option :conductor, type: :boolean, default: false,
                                desc: 'Configure the installer for ~/Sites/conductor/workspaces'
+      class_option :yolo, type: :boolean, default: false,
+                          desc: 'Apply common Procfile.dev and mise .env follow-up edits when safe'
 
       FOLLOW_UP_TEMPLATE = <<~TEXT.freeze
           ============================================
@@ -46,6 +51,13 @@ module Worktrees
         template('Procfile.dev.worktree.example.tt', 'Procfile.dev.worktree.example')
       end
 
+      def apply_yolo_follow_ups
+        return unless options[:yolo]
+
+        update_procfile
+        update_mise_toml
+      end
+
       def update_database_configuration
         unless File.exist?(database_config_path)
           say_status(:skip, 'config/database.yml not found', :yellow)
@@ -76,6 +88,17 @@ module Worktrees
         File.join(destination_root, 'config/database.yml')
       end
 
+      def procfile_path
+        File.join(destination_root, 'Procfile.dev')
+      end
+
+      def mise_toml_paths
+        [
+          File.join(destination_root, 'mise.toml'),
+          File.join(destination_root, '.mise.toml')
+        ]
+      end
+
       def database_update_result
         result = ::Rails::Worktrees::DatabaseConfigUpdater.new(
           content: File.read(database_config_path)
@@ -117,6 +140,51 @@ module Worktrees
         result.messages.each { |message| say(message) }
       end
 
+      def update_procfile
+        unless File.exist?(procfile_path)
+          say_status(:skip, 'Procfile.dev not found', :yellow)
+          say('Skipped Procfile.dev yolo update because the file does not exist yet.')
+          return
+        end
+
+        result = ::Rails::Worktrees::ProcfileUpdater.new(content: File.read(procfile_path)).call
+        File.write(procfile_path, result.content) if result.changed?
+        announce_updater_result('Procfile.dev', result)
+      end
+
+      def update_mise_toml
+        path = first_mise_toml_path
+        return announce_missing_mise_toml unless path
+
+        result = ::Rails::Worktrees::MiseTomlUpdater.new(
+          content: File.read(path),
+          file_name: File.basename(path)
+        ).call
+
+        File.write(path, result.content) if result.changed?
+        announce_updater_result(File.basename(path), result)
+      end
+
+      def announce_updater_result(path, result)
+        status, color = case result.status
+                        when :updated then %i[update green]
+                        when :identical then %i[identical blue]
+                        else %i[skip yellow]
+                        end
+
+        say_status(status, path, color)
+        result.messages.each { |message| say(message) }
+      end
+
+      def first_mise_toml_path
+        mise_toml_paths.find { |candidate| File.file?(candidate) }
+      end
+
+      def announce_missing_mise_toml
+        say_status(:skip, 'mise.toml/.mise.toml not found', :yellow)
+        say('Skipped mise yolo update because no supported mise config file was found.')
+      end
+
       def git_repo?
         _stdout_str, _stderr_str, status = Open3.capture3(
           'git', 'rev-parse', '--is-inside-work-tree', chdir: destination_root
@@ -130,5 +198,6 @@ module Worktrees
         "File.expand_path('~/Sites/conductor/workspaces')"
       end
     end
+    # rubocop:enable Metrics/ClassLength
   end
 end

data/lib/rails/worktrees/mise_toml_updater.rb

@@ -0,0 +1,82 @@
+module Rails
+  module Worktrees
+    # Safely updates mise config to load the worktree-local .env.
+    class MiseTomlUpdater
+      Result = Struct.new(:content, :changed, :status, :messages) do
+        def changed?
+          changed
+        end
+      end
+
+      ENV_SECTION_PATTERN = /\A\s*\[env\]\s*(?:#.*)?\z/
+      ENV_FILE_PATTERN = /\A\s*_.file\s*=\s*["']\.env["']\s*(?:#.*)?\z/
+      SECTION_PATTERN = /\A\s*\[[^\]]+\]\s*(?:#.*)?\z/
+      ENV_FILE_ENTRY = '_.file = ".env"'.freeze
+
+      def initialize(content:, file_name:)
+        @content = content
+        @file_name = file_name
+      end
+
+      def call
+        lines = @content.lines(chomp: true)
+        return update_existing_env_section(lines) if env_section_present?(lines)
+
+        append_env_section(lines)
+      end
+
+      private
+
+      def update_existing_env_section(lines)
+        env_section_start, env_section_end = env_section_bounds(lines)
+        return identical_result if env_file_configured?(lines, env_section_start, env_section_end)
+
+        updated_lines = lines.dup
+        updated_lines.insert(env_section_end, ENV_FILE_ENTRY)
+        updated_result(rebuild_content(updated_lines, trailing_newline: @content.end_with?("\n")))
+      end
+
+      def append_env_section(lines)
+        updated_lines = lines.dup
+        updated_lines << '' if updated_lines.any? && !updated_lines.last.empty?
+        updated_lines << '[env]'
+        updated_lines << ENV_FILE_ENTRY
+
+        updated_result(rebuild_content(updated_lines, trailing_newline: true))
+      end
+
+      def updated_result(content)
+        Result.new(content, true, :updated, ["Configured #{@file_name} to load .env from [env]."])
+      end
+
+      def identical_result
+        Result.new(@content, false, :identical, ["#{@file_name} already loads .env from [env]."])
+      end
+
+      def env_section_bounds(lines)
+        start_index = lines.find_index { |line| line.match?(ENV_SECTION_PATTERN) }
+        return [nil, nil] unless start_index
+
+        end_index = ((start_index + 1)...lines.length).find do |index|
+          lines[index].match?(SECTION_PATTERN)
+        end || lines.length
+        [start_index, end_index]
+      end
+
+      def env_section_present?(lines)
+        env_section_bounds(lines).first
+      end
+
+      def env_file_configured?(lines, start_index, end_index)
+        lines[(start_index + 1)...end_index].any? { |line| line.match?(ENV_FILE_PATTERN) }
+      end
+
+      def rebuild_content(lines, trailing_newline:)
+        content = lines.join("\n")
+        return content if content.empty? || !trailing_newline
+
+        "#{content}\n"
+      end
+    end
+  end
+end

data/lib/rails/worktrees/procfile_updater.rb

@@ -0,0 +1,69 @@
+module Rails
+  module Worktrees
+    # Safely updates Procfile.dev to use the worktree-local DEV_PORT.
+    class ProcfileUpdater
+      Result = Struct.new(:content, :changed, :status, :messages) do
+        def changed?
+          changed
+        end
+      end
+
+      STANDARD_WEB_ENTRY = 'web: env RUBY_DEBUG_OPEN=true bin/rails server -b 0.0.0.0 -p ${DEV_PORT:-3000}'.freeze
+      WEB_ENTRY_PATTERN = /\Aweb:\s*.*\z/
+
+      def initialize(content:)
+        @content = content
+      end
+
+      def call
+        lines = @content.lines(chomp: true)
+        web_entry_indexes = web_entry_indexes(lines)
+        return skip_result if web_entry_indexes.empty?
+
+        updated_content = rebuild_content(
+          replace_web_entries(lines, web_entry_indexes),
+          trailing_newline: @content.end_with?("\n")
+        )
+
+        build_result(updated_content)
+      end
+
+      private
+
+      def updated_result(content)
+        Result.new(content, true, :updated, ['Updated Procfile.dev web entry to use DEV_PORT.'])
+      end
+
+      def identical_result(content)
+        Result.new(content, false, :identical, ['Procfile.dev already uses the DEV_PORT-aware web entry.'])
+      end
+
+      def skip_result
+        Result.new(@content, false, :skip, ['No web: entry found in Procfile.dev; update it manually if needed.'])
+      end
+
+      def web_entry_indexes(lines)
+        lines.each_index.select { |index| lines[index].match?(WEB_ENTRY_PATTERN) }
+      end
+
+      def replace_web_entries(lines, web_entry_indexes)
+        lines.dup.tap do |updated_lines|
+          web_entry_indexes.each { |index| updated_lines[index] = STANDARD_WEB_ENTRY }
+        end
+      end
+
+      def build_result(content)
+        return identical_result(content) if content == @content
+
+        updated_result(content)
+      end
+
+      def rebuild_content(lines, trailing_newline:)
+        content = lines.join("\n")
+        return content if content.empty? || !trailing_newline
+
+        "#{content}\n"
+      end
+    end
+  end
+end

data/lib/rails/worktrees/version.rb

@@ -1,5 +1,5 @@
 module Rails
   module Worktrees
-    VERSION = '0.1.1'.freeze
+    VERSION = '0.2.0'.freeze
   end
 end

data/lib/rails/worktrees.rb

@@ -6,6 +6,8 @@ require_relative 'worktrees/env_bootstrapper'
 require_relative 'worktrees/command'
 require_relative 'worktrees/cli'
 require_relative 'worktrees/database_config_updater'
+require_relative 'worktrees/procfile_updater'
+require_relative 'worktrees/mise_toml_updater'
 
 module Rails
   # Rails-specific git worktree helpers and installer support.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-worktrees
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Asjer Querido
@@ -61,7 +61,9 @@ files:
 - lib/rails/worktrees/configuration.rb
 - lib/rails/worktrees/database_config_updater.rb
 - lib/rails/worktrees/env_bootstrapper.rb
+- lib/rails/worktrees/mise_toml_updater.rb
 - lib/rails/worktrees/names/cities.txt
+- lib/rails/worktrees/procfile_updater.rb
 - lib/rails/worktrees/railtie.rb
 - lib/rails/worktrees/version.rb
 - mise.toml