ruby_git 0.3.1 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b12470df80fc020031e73898e6332def5b5d6e7c419acb3036a58585263269b7
-  data.tar.gz: d1138d2381fc7272397357105b8e884a78bed2396289608df6dc746896018b4b
+  metadata.gz: 9c3507b566d30abc32d770188184bf932f3af97985f579df84dfa24b3e6e9a96
+  data.tar.gz: 8fecb84e47a289736ecf79579a2de496b0520734a4a3d6199c5838e0543ba1d1
 SHA512:
-  metadata.gz: f1cbdfcdea413421d06bf15ad2c205866dff32a1b92ffea0b260dbecf31fe62313fb6b355ae81fff9cb0f07fab26af622c90eeb28c1b1e28c63c27a02223e499
-  data.tar.gz: e51b5c257998f8a2c9cad6927bfd1b32d4f397c793b82edd6017a00b4581b9b6f6f00623f05ec9d2052b42a72c62fabc94268bb4caa6b1d6b408a3b2d5041f46
+  metadata.gz: b8c39128ee93c9a24cb6b07f7b99284f2373647c02d276aa76e9ccad9bfa3ce622ed12c7e0d0043bb3e4b4834069db626de9cc4885ec25fd89a8bac86b705bcc
+  data.tar.gz: bc37e79e11cead6979605727b5134fbbd528610977768bb7302c79cb7eebf7fa385ce1b07573d208f1ff7e4af29344a30e2ddf9e1a9c66a38d60330253b79271

data/.github/workflows/continuous_integration.yml

@@ -1,9 +1,6 @@
 name: Continuous Integration
 
 on:
-  push:
-    branches: [main]
-
   pull_request:
     branches: [main]
 
@@ -26,6 +23,10 @@ jobs:
   build:
     name: Ruby ${{ matrix.ruby }} on ${{ matrix.operating-system }}
 
+    if: >-
+      github.event_name == 'workflow_dispatch' ||
+      (github.event_name == 'pull_request' && !startsWith(github.event.pull_request.head.ref, 'release-please--'))
+
     runs-on: ${{ matrix.operating-system }}
     continue-on-error: true
 
@@ -35,19 +36,9 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: ["3.1", "3.2", "3.3", "3.4"]
+        ruby: ["3.1", "3.4"]
         operating-system: [ubuntu-latest]
         fail_on_low_coverage: [true]
-        include:
-          - ruby: "3.1"
-            operating-system: windows-latest
-            fail_on_low_coverage: false
-          - ruby: "jruby-9.4"
-            operating-system: ubuntu-latest
-            fail_on_low_coverage: false
-          - ruby: "truffleruby-24"
-            operating-system: ubuntu-latest
-            fail_on_low_coverage: false
 
     steps:
       - name: Checkout
@@ -61,27 +52,3 @@ jobs:
 
       - name: Run rake
         run: bundle exec rake
-
-  coverage:
-    name: Report test coverage to CodeClimate
-
-    needs: [build]
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Initialize Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 3.1
-          bundler-cache: true
-
-      - name: Report test coverage
-        uses: paambaati/codeclimate-action@v9
-        env:
-          CC_TEST_REPORTER_ID: b86e77bc6980a43dc09314502fe13334e0f663770b840628ca0716e6dcdeeb5d
-        with:
-          coverageCommand: bundle exec rake spec
-          coverageLocations: ${{github.workspace}}/coverage/lcov/*.lcov:lcov

data/.github/workflows/enforce_conventional_commits.yml

@@ -9,6 +9,10 @@ jobs:
   commit-lint:
     name: Verify Conventional Commits
 
+    if: >-
+      github.event_name == 'workflow_dispatch' ||
+      (github.event_name == 'pull_request' && !startsWith(github.event.pull_request.head.ref, 'release-please--'))
+
     runs-on: ubuntu-latest
 
     steps:

data/.github/workflows/experimental_ruby_builds.yml

@@ -1,9 +1,6 @@
 name: Experimental Ruby Builds
 
 on:
-  push:
-    branches: [main]
-
   workflow_dispatch:
 
 env:
@@ -34,19 +31,28 @@ jobs:
       matrix:
         fail_on_low_coverage: [true]
         include:
+          - ruby: "3.1"
+            operating-system: windows-latest
+            fail_on_low_coverage: false
           - ruby: head
             operating-system: ubuntu-latest
           - ruby: head
             operating-system: windows-latest
+          - ruby: "truffleruby-24"
+            operating-system: ubuntu-latest
+            fail_on_low_coverage: false
           - ruby: truffleruby-head
             operating-system: ubuntu-latest
             fail_on_low_coverage: false
-          - ruby: jruby-head
+          - ruby: "jruby-9.4"
             operating-system: ubuntu-latest
             fail_on_low_coverage: false
           - ruby: "jruby-9.4"
             operating-system: windows-latest
             fail_on_low_coverage: false
+          - ruby: jruby-head
+            operating-system: ubuntu-latest
+            fail_on_low_coverage: false
           - ruby: jruby-head
             operating-system: windows-latest
             fail_on_low_coverage: false

data/.github/workflows/release.yml

@@ -0,0 +1,51 @@
+---
+name: Release Gem
+description: |
+  This workflow creates a new release on GitHub and publishes the gem to
+  RubyGems.org.
+
+  The workflow uses the `googleapis/release-please-action` to handle the
+  release creation process and the `rubygems/release-gem` action to publish
+  the gem.
+
+on:
+  push:
+    branches: ["main"]
+
+  workflow_dispatch:
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    environment:
+      name: RubyGems
+      url: https://rubygems.org/gems/ruby_git
+
+    permissions:
+      contents: write
+      pull-requests: write
+      id-token: write
+
+    steps:
+      - name: Checkout project
+        uses: actions/checkout@v4
+
+      - name: Create release
+        uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          token: ${{ secrets.AUTO_RELEASE_TOKEN }}
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+      - name: Setup ruby
+        uses: ruby/setup-ruby@v1
+        if: ${{ steps.release.outputs.release_created }}
+        with:
+          bundler-cache: true
+          ruby-version: ruby
+
+      - name: Push to RubyGems.org
+        uses: rubygems/release-gem@v1
+        if: ${{ steps.release.outputs.release_created }}

data/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.3.4"
+}

data/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Change Log
 
+## [0.3.4](https://github.com/main-branch/ruby_git/compare/v0.3.3...v0.3.4) (2025-04-17)
+
+
+### Features
+
+* Add initial_branch option to RubyGit::Worktree.init ([9f5e8da](https://github.com/main-branch/ruby_git/commit/9f5e8daca1599d46c9a53429b24f4fff47f148b6))
+* Add initial_branch option to RubyGit.init ([c0007e5](https://github.com/main-branch/ruby_git/commit/c0007e501c2768e921c1aef618c8edb4969e5e95))
+
+
+### Bug Fixes
+
+* Rewrap any errors raised by Process.spawn in RubyGit::SpawnError ([1ed4444](https://github.com/main-branch/ruby_git/commit/1ed4444c12ff1598af8915eac0c568bbaa865c84))
+
+## [0.3.3](https://github.com/main-branch/ruby_git/compare/v0.3.2...v0.3.3) (2025-04-17)
+
+
+### Bug Fixes
+
+* Do not trigger build workflows after merging to main or for release PRs ([0678dd3](https://github.com/main-branch/ruby_git/commit/0678dd347235aaa9f55d84853de94d01935f974d))
+* Move unneeded builds from continuous_integration to experimental_ruby_builds ([2d15e1c](https://github.com/main-branch/ruby_git/commit/2d15e1c7aef848e4d3cc857e6f606a0f68d7bf6f))
+
+## [0.3.2](https://github.com/main-branch/ruby_git/compare/v0.3.1...v0.3.2) (2025-04-16)
+
+
+### Bug Fixes
+
+* Automate commit-to-publish workflow ([9850fed](https://github.com/main-branch/ruby_git/commit/9850fed2230f154eaf6319644d0e6b40c5352e7f))
+
 ## v0.3.1 (2025-03-28)
 
 [Full Changelog](https://github.com/main-branch/ruby_git/compare/v0.3.0..v0.3.1)

data/README.md

@@ -7,8 +7,6 @@ and the order of implementing new features.
 [![Build Status](https://github.com/main-branch/ruby_git/actions/workflows/continuous_integration.yml/badge.svg)](https://github.com/main-branch/ruby_git/actions/workflows/continuous_integration.yml)
 [![Documentation](https://img.shields.io/badge/Documentation-Latest-green)](https://rubydoc.info/gems/ruby_git/)
 [![Change Log](https://img.shields.io/badge/CHANGELOG-Latest-green)](https://rubydoc.info/gems/ruby_git/file/CHANGELOG.md)
-[![Maintainability](https://api.codeclimate.com/v1/badges/5403e4613b7518f70da7/maintainability)](https://codeclimate.com/github/main-branch/ruby_git/maintainability)
-[![Test Coverage](https://api.codeclimate.com/v1/badges/5403e4613b7518f70da7/test_coverage)](https://codeclimate.com/github/main-branch/ruby_git/test_coverage)
 [![Slack](https://img.shields.io/badge/slack-main--branch/ruby__git-yellow.svg?logo=slack)](https://main-branch.slack.com/archives/C01CHR7TMM2)
 
 Git Is Hard™ but it doesn't have to be that way. Git has this reputation because it has an

data/Rakefile

@@ -17,6 +17,13 @@ Bundler::Audit::Task.new
 require 'bundler'
 require 'bundler/gem_tasks'
 
+# Make it so that calling `rake release` just calls `rake release:rubygems_push` to
+# avoid creating and pushing a new tag.
+
+Rake::Task['release'].clear
+desc 'Customized release task to avoid creating a new tag'
+task release: 'release:rubygem_push'
+
 # RSpec
 
 require 'rspec/core/rake_task'

data/lib/ruby_git/command_line/runner.rb

@@ -187,20 +187,39 @@ module RubyGit
       #
       # @api private
       #
-      def run_with_chdir(args, options)
-        return ProcessExecuter.run_with_options(args, options) unless jruby? && options.chdir != :not_set
+      def run_with_chdir(args, options) # rubocop:disable Metrics/MethodLength
+        return run_and_handle_spawn_error(args, options) unless jruby? && options.chdir != :not_set
 
         # :nocov: Not executed in MRI Ruby
-        Dir.chdir(options.chdir) do
-          saved_chdir = options.chdir
-          options.merge!(chdir: :not_set)
-          ProcessExecuter.run_with_options(args, options).tap do
-            options.merge!(chdir: saved_chdir)
+        begin
+          Dir.chdir(options.chdir) do
+            saved_chdir = options.chdir
+            options.merge!(chdir: :not_set)
+            run_and_handle_spawn_error(args, options).tap do
+              options.merge!(chdir: saved_chdir)
+            end
           end
+        rescue Errno::ENOENT, Errno::ENOTDIR => e
+          raise RubyGit::SpawnError, "chdir(#{options.chdir}) failed: #{e.message}"
         end
         # :nocov:
       end
 
+      # Catch ProcessExecuter::SpawnError and raise a RubyGit::SpawnError in its place
+      #
+      # @param args [Array<String>] the command to run
+      # @param options [RubyGit::CommandLine::Options] the options to pass to `Process.spawn`
+      #
+      # @return [ProcessExecuter::Result] the result of the command
+      #
+      # @api private
+      #
+      def run_and_handle_spawn_error(args, options)
+        ProcessExecuter.run_with_options(args, options)
+      rescue ProcessExecuter::SpawnError => e
+        raise RubyGit::SpawnError, e.message
+      end
+
       # Returns true if running on JRuby
       #
       # @return [Boolean]

data/lib/ruby_git/errors.rb

@@ -21,6 +21,7 @@ module RubyGit
   #     │   └─> RubyGit::SignaledError
   #     │       └─> RubyGit::TimeoutError
   #     ├─> RubyGit::ProcessIOError
+  #     ├─> RubyGit::SpawnError
   #     └─> RubyGit::UnexpectedResultError
   # ```
   #
@@ -32,6 +33,7 @@ module RubyGit
   # | `SignaledError` | This error is raised when the git command line is terminated as a result of receiving a signal. This could happen if the process is forcibly terminated or if there is a serious system error. |
   # | `TimeoutError` | This is a specific type of `SignaledError` that is raised when the git command line operation times out and is killed via the SIGKILL signal. This happens if the operation takes longer than the timeout duration configured in `Git.config.timeout` or via the `:timeout` parameter given in git methods that support timeouts. |
   # | `ProcessIOError` | An error was encountered reading or writing to a subprocess. |
+  # | `SpawnError` | An error was encountered when spawning a subprocess and it never started. |
   # | `UnexpectedResultError` | The command line ran without error but did not return the expected results. |
   #
   # @example Rescuing a generic error
@@ -166,4 +168,10 @@ module RubyGit
   # @api public
   #
   class UnexpectedResultError < RubyGit::Error; end
+
+  # Raised when the git command could not be spawned
+  #
+  # @api public
+  #
+  class SpawnError < RubyGit::Error; end
 end

data/lib/ruby_git/option_validators.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module RubyGit
+  # Module containing option validators for RubyGit
+  # @api public
+  module OptionValidators
+    # Raise an error if an option is not a Boolean (or optionally nil) value
+    # @param name [String] the name of the option
+    # @param value [Object] the value of the option
+    # @param nullable [Boolean] whether the option can be nil (default is false)
+    # @return [void]
+    # @raise [ArgumentError] if the option is not a Boolean (or optionally nil) value
+    # @api private
+    def validate_boolean_option(name:, value:, nullable: false)
+      return if nullable && value.nil?
+
+      return if [true, false].include?(value)
+
+      raise ArgumentError, "The '#{name}:' option must be a Boolean value but was #{value.inspect}"
+    end
+
+    # Raise an error if an option is not a String (or optionally nil) value
+    # @param name [String] the name of the option
+    # @param value [Object] the value of the option
+    # @param nullable [Boolean] whether the option can be nil (default is false)
+    # @return [void]
+    # @raise [ArgumentError] if the option is not a String (or optionally nil) value
+    # @api private
+    def validate_string_option(name:, value:, nullable: false)
+      return if nullable && value.nil?
+
+      return if value.is_a?(String)
+
+      raise ArgumentError, "The '#{name}:' option must be a String or nil but was #{value.inspect}"
+    end
+  end
+end

data/lib/ruby_git/repository.rb

@@ -26,8 +26,36 @@ module RubyGit
     #
     # @param [String] repository_path the path to the repository
     #
+    #   The purpose of this flag is to allow tests to not have to mock the
+    #   normalization of the path. This allows testing that the right git command
+    #   is contructed based on the options passed any particular method.
+    #
+    # @raise [ArgumentError] if the path is not a directory
+    #
     def initialize(repository_path)
-      @path = File.realpath(repository_path)
+      @path = normalize_path(repository_path)
+    end
+
+    private
+
+    # Expand and convert the given path to an absolute, real path
+    #
+    # @example Expand the path
+    #   normalize_path('~/repository.git') #=> '/Users/james/repository.git'
+    #
+    # @example Convert to an absolute path
+    #   File.chdir('/User/james/repository/.git')
+    #   normalize_path('.') #=> '/User/james/repository/.git'
+    #
+    # @param path [String] the path to normalize
+    #
+    # @return [String]
+    #
+    # @api private
+    def normalize_path(path)
+      raise ArgumentError, "Directory '#{path}' does not exist." unless File.directory?(path)
+
+      File.realpath(File.expand_path(path))
     end
   end
 end

data/lib/ruby_git/version.rb

@@ -3,5 +3,5 @@
 module RubyGit
   # The ruby_git gem version
   #
-  VERSION = '0.3.1'
+  VERSION = '0.3.4'
 end

data/lib/ruby_git/worktree.rb

@@ -7,6 +7,9 @@ module RubyGit
   # Create a new Worktree using {.init}, {.clone}, or {.open}.
   #
   class Worktree
+    extend RubyGit::OptionValidators
+    include RubyGit::OptionValidators
+
     # The root path of the working tree
     #
     # @example
@@ -26,19 +29,24 @@ module RubyGit
     # @see https://git-scm.com/docs/git-init git-init
     #
     # @example
-    #   worktree = Worktree.init(worktree_path)
+    #   worktree = Worktree.init(worktree_path, initial_branch: 'main')
     #
-    # @param [String] worktree_path the root path of a Git working tree
+    # @param worktree_path [String] the root path of a Git working tree
+    # @param initial_branch [String] the initial branch in the newly created repository
     #
-    # @raise [RubyGit::Error] if worktree_path is not a directory
+    # @raise [ArgumentError] if worktree_path does not exist or is not a directory
+    # @raise [RubyGit::Error] if there is an error initializing the repository
     #
     # @return [RubyGit::Worktree] the working tree whose root is at `path`
     #
-    def self.init(worktree_path)
-      raise RubyGit::Error, "Path '#{worktree_path}' not valid." unless File.directory?(worktree_path)
+    def self.init(worktree_path, initial_branch: nil)
+      validate_string_option(name: :initial_branch, value: initial_branch, nullable: true)
 
       command = ['init']
+      command << '--initial-branch' << initial_branch unless initial_branch.nil?
+
       options = { chdir: worktree_path, out: StringIO.new, err: StringIO.new }
+
       RubyGit::CommandLine.run(*command, **options)
 
       new(worktree_path)
@@ -105,17 +113,6 @@ module RubyGit
       new(cloned_to(clone_output))
     end
 
-    # Get path of the cloned worktree from `git clone` stderr output
-    #
-    # @param clone_output [String] the stderr output of the `git clone` command
-    #
-    # @return [String] the path of the cloned worktree
-    #
-    # @api private
-    def self.cloned_to(clone_output)
-      clone_output.match(/Cloning into ['"](.+)['"]\.\.\./)[1]
-    end
-
     # Show the working tree and index status
     #
     # @example worktree = Worktree.open(worktree_path) worktree.status #=>
@@ -154,7 +151,7 @@ module RubyGit
       command << '--' unless path_specs.empty?
       command.concat(path_specs)
       options = { out: StringIO.new, err: StringIO.new }
-      status_output = run(*command, **options).stdout
+      status_output = run_with_context(*command, **options).stdout
       RubyGit::Status.parse(status_output)
     end
 
@@ -194,7 +191,7 @@ module RubyGit
 
       options = { out: StringIO.new, err: StringIO.new }
 
-      run(*command, **options)
+      run_with_context(*command, **options)
     end
 
     # Return the repository associated with the worktree
@@ -206,42 +203,95 @@ module RubyGit
     # @return [RubyGit::Repository] the repository associated with the worktree
     #
     def repository
-      @repository ||= begin
-        command = %w[rev-parse --git-dir]
-        options = { chdir: path, chomp: true, out: StringIO.new, err: StringIO.new }
-        # rev-parse path might be relative to the worktree, thus the need to expand it
-        git_dir = File.realpath(RubyGit::CommandLine.run(*command, **options).stdout, path)
-        Repository.new(git_dir)
-      end
+      @repository ||= Repository.new(repository_path)
     end
 
     private
 
+    # The path to the repository associated with this worktree
+    #
+    # @return [String]
+    #
+    # @api private
+    #
+    def repository_path
+      command = %w[rev-parse --git-dir]
+      options = { chdir: path, chomp: true, out: StringIO.new, err: StringIO.new }
+      # rev-parse path might be relative to the worktree, thus the need to expand it
+      File.realpath(RubyGit::CommandLine.run(*command, **options).stdout, path)
+    end
+
     # Create a Worktree object
     #
     # @param worktree_path [String] a path anywhere in the worktree
     #
+    #   The purpose of this flag is to allow tests to not have to mock the
+    #   normalization of the path. This allows testing that the right git command
+    #   is contructed based on the options passed any particular method.
+    #
+    # @raise [ArgumentError] if the path is not a directory or the path is not in a
+    #   git working tree
+    #
+    # @return [RubyGit::Worktree] the worktree whose root is at `path`
     # @api private
     #
     def initialize(worktree_path)
-      raise RubyGit::Error, "Path '#{worktree_path}' not valid." unless File.directory?(worktree_path)
-
-      @path = root_path(worktree_path)
+      @path = normalize_path(worktree_path)
       RubyGit.logger.debug("Created #{inspect}")
     end
 
-    # Find the root path of a Git working tree containing `path`
+    # Get path of the cloned worktree from `git clone` stderr output
     #
-    # @raise [RubyGit::FailedError] if the path is not in a Git working tree
+    # @param clone_output [String] the stderr output of the `git clone` command
+    #
+    # @return [String] the path of the cloned worktree
+    #
+    # @api private
+    private_class_method def self.cloned_to(clone_output)
+      clone_output.match(/Cloning into ['"](.+)['"]\.\.\./)[1]
+    end
+
+    # Return the absolute path to the root of the working tree containing path
+    #
+    # @example Expand the path
+    #   normalize_path('~/worktree') #=> '/Users/james/worktree'
+    #
+    # @example Convert to an absolute path
+    #   File.chdir('/User/james/worktree')
+    #   normalize_path('.') #=> '/User/james/worktree'
+    #
+    # @param path [String] a (possibly relative) path within the worktree
+    #
+    # @return [String]
+    #
+    # @raise [ArgumentError] if the path is not a directory or the path is not in a
+    #   git working tree
+    #
+    # @api private
+    #
+    def normalize_path(path)
+      raise ArgumentError, "Directory '#{path}' does not exist." unless File.directory?(path)
+
+      begin
+        root_path(path)
+      rescue RubyGit::FailedError => e
+        raise ArgumentError, e.message
+      end
+    end
+
+    # Find the root path of a Git working tree containing `path`
     #
     # @return [String] the root path of the Git working tree containing `path`
     #
+    # @raise [ArgumentError] if the path is not in a Git working tree
+    #
     # @api private
     #
     def root_path(worktree_path)
       command = %w[rev-parse --show-toplevel]
       options = { chdir: worktree_path, chomp: true, out: StringIO.new, err: StringIO.new }
-      File.realpath(RubyGit::CommandLine.run(*command, **options).stdout)
+      root_path = RubyGit::CommandLine.run(*command, **options).stdout
+      File.realpath(File.expand_path(root_path))
     end
 
     # Run a Git command in this worktree
@@ -255,23 +305,8 @@ module RubyGit
     #
     # @api private
     #
-    def run(*command, **options)
+    def run_with_context(*command, **options)
       RubyGit::CommandLine.run(*command, repository_path: repository.path, worktree_path: path, **options)
     end
-
-    # Raise an error if an option is not a Boolean (or optionally nil) value
-    # @param name [String] the name of the option
-    # @param value [Object] the value of the option
-    # @param nullable [Boolean] whether the option can be nil (default is false)
-    # @return [void]
-    # @raise [ArgumentError] if the option is not a Boolean (or optionally nil) value
-    # @api private
-    def validate_boolean_option(name:, value:, nullable: false)
-      return if nullable && value.nil?
-
-      return if [true, false].include?(value)
-
-      raise ArgumentError, "The '#{name}:' option must be a Boolean value but was #{value.inspect}"
-    end
   end
 end

data/lib/ruby_git.rb

@@ -3,6 +3,7 @@
 require_relative 'ruby_git/command_line'
 require_relative 'ruby_git/encoding_normalizer'
 require_relative 'ruby_git/errors'
+require_relative 'ruby_git/option_validators'
 require_relative 'ruby_git/repository'
 require_relative 'ruby_git/status'
 require_relative 'ruby_git/version'
@@ -79,16 +80,17 @@ module RubyGit
   # @see https://git-scm.com/docs/git-init git-init
   #
   # @example
-  #   worktree = Worktree.init(worktree_path)
+  #   worktree = Worktree.init(worktree_path, initial_branch: 'main')
   #
-  # @param [String] worktree_path the root path of a worktree
+  # @param worktree_path [String] the root path of a worktree
+  # @param initial_branch [String] the initial branch in the newly created repository
   #
   # @raise [RubyGit::Error] if worktree_path is not a directory
   #
   # @return [RubyGit::Worktree] the worktree whose root is at `path`
   #
-  def self.init(worktree_path)
-    RubyGit::Worktree.init(worktree_path)
+  def self.init(worktree_path, initial_branch:)
+    RubyGit::Worktree.init(worktree_path, initial_branch:)
   end
 
   # Open an existing Git working tree that contains worktree_path

data/release-please-config.json

@@ -0,0 +1,23 @@
+{
+  "bootstrap-sha": "b03a7aebb563e4a25eca7f664dd39c7a0595eb61",
+  "packages": {
+    ".": {
+      "release-type": "ruby",
+      "package-name": "ruby_git",
+      "changelog-path": "CHANGELOG.md",
+      "version-file": "lib/ruby_git/version.rb",
+      "bump-minor-pre-major": true,
+      "bump-patch-for-minor-pre-major": true,
+      "draft": true,
+      "prerelease": false,
+      "include-component-in-tag": false,
+      "pull-request-title-pattern": "chore: release v${version}"
+    }
+  },
+  "plugins": [
+    {
+      "type": "sentence-case"
+    }
+  ],
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json"
+}

data/ruby_git.gemspec

@@ -56,7 +56,7 @@ Gem::Specification.new do |spec|
     spec.add_development_dependency 'yardstick', '~> 0.9'
   end
 
-  spec.add_dependency 'process_executer', '~> 3.0'
+  spec.add_dependency 'process_executer', '~> 3.2'
   spec.add_dependency 'rchardet', '~> 1.9'
 
   spec.metadata['rubygems_mfa_required'] = 'true'

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ruby_git
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.4
 platform: ruby
 authors:
 - James Couball
 bindir: exe
 cert_chain: []
-date: 2025-03-28 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler-audit
@@ -203,14 +203,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.2'
 - !ruby/object:Gem::Dependency
   name: rchardet
   requirement: !ruby/object:Gem::Requirement
@@ -241,9 +241,11 @@ files:
 - ".github/workflows/continuous_integration.yml"
 - ".github/workflows/enforce_conventional_commits.yml"
 - ".github/workflows/experimental_ruby_builds.yml"
+- ".github/workflows/release.yml"
 - ".gitignore"
 - ".husky/commit-msg"
 - ".markdownlint.yml"
+- ".release-please-manifest.json"
 - ".rspec"
 - ".rubocop.yml"
 - ".yardopts"
@@ -266,6 +268,7 @@ files:
 - lib/ruby_git/command_line/runner.rb
 - lib/ruby_git/encoding_normalizer.rb
 - lib/ruby_git/errors.rb
+- lib/ruby_git/option_validators.rb
 - lib/ruby_git/repository.rb
 - lib/ruby_git/status.rb
 - lib/ruby_git/status/branch.rb
@@ -283,6 +286,7 @@ files:
 - lib/ruby_git/worktree.rb
 - package.json
 - pre-commit
+- release-please-config.json
 - ruby_git.gemspec
 homepage: https://github.com/main-branch/ruby_git
 licenses:
@@ -291,8 +295,8 @@ metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/main-branch/ruby_git
   source_code_uri: https://github.com/main-branch/ruby_git
-  documentation_uri: https://rubydoc.info/gems/ruby_git/0.3.1
-  changelog_uri: https://rubydoc.info/gems/ruby_git/0.3.1/file/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/ruby_git/0.3.4
+  changelog_uri: https://rubydoc.info/gems/ruby_git/0.3.4/file/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
@@ -311,7 +315,7 @@ requirements:
 - 'Platform: Mac, Linux, or Windows'
 - 'Ruby: MRI 3.1 or later, TruffleRuby 24 or later, or JRuby 9.4 or later'
 - Git 2.28.0 or later
-rubygems_version: 3.6.2
+rubygems_version: 3.6.7
 specification_version: 4
 summary: An object-oriented interface to working with the git command line
 test_files: []