git 1.19.1 → 5.5.0

data/lib/git/commands/config_option_syntax/replace_all.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+require 'git/commands/base'
+
+module Git
+  module Commands
+    module ConfigOptionSyntax
+      # Replace all matching values for a config key
+      #
+      # Wraps `git config --replace-all` to replace all entries matching the
+      # given key and optional value regex with a new value.
+      #
+      # @example Replace all values for a key
+      #   cmd = Git::Commands::ConfigOptionSyntax::ReplaceAll.new(lib)
+      #   cmd.call('core.autocrlf', 'true')
+      #
+      # @example Replace values matching a pattern
+      #   cmd = Git::Commands::ConfigOptionSyntax::ReplaceAll.new(lib)
+      #   cmd.call('core.autocrlf', 'true', 'false')
+      #
+      # @note `arguments` block audited against https://git-scm.com/docs/git-config/2.53.0
+      #
+      # @see Git::Commands::ConfigOptionSyntax
+      #
+      # @see https://git-scm.com/docs/git-config git-config documentation
+      #
+      # @api private
+      #
+      class ReplaceAll < Git::Commands::Base
+        arguments do
+          literal 'config'
+          literal '--replace-all'
+
+          # Write modifiers
+          value_option :comment
+
+          # File-scope options
+          flag_option :global
+          flag_option :system
+          flag_option :local
+          flag_option :worktree
+          value_option %i[file f]
+          value_option :blob
+
+          # Value matching
+          flag_option :fixed_value
+
+          # Type constraint
+          value_option :type, inline: true
+          flag_option :no_type
+
+          # Operands
+          end_of_options
+          operand :name, required: true
+          operand :value, required: true
+          operand :value_regex
+        end
+
+        # @!method call(*, **options)
+        #
+        #   @param options [Hash] command options
+        #
+        #   @option options [Boolean, nil] :global (nil) command option key; see
+        #     overload docs for the full option list
+        #
+        #   @overload call(name, value, value_regex = nil, **options)
+        #
+        #     Execute the `git config --replace-all` command
+        #
+        #     @param name [String] the config key name
+        #
+        #     @param value [String] the new value to set
+        #
+        #     @param value_regex [String, nil] (nil) optional regex to match existing values to replace
+        #
+        #     @param options [Hash] command options
+        #
+        #     @option options [Boolean, nil] :global (nil) write to global config (`~/.gitconfig`)
+        #
+        #     @option options [Boolean, nil] :system (nil) write to system config
+        #
+        #     @option options [Boolean, nil] :local (nil) write to repository config (`.git/config`)
+        #
+        #     @option options [Boolean, nil] :worktree (nil) write to worktree config
+        #
+        #     @option options [String] :file (nil) write to the specified file
+        #
+        #       Alias: :f
+        #
+        #     @option options [String] :blob (nil) read from the specified blob
+        #
+        #     @option options [String] :comment (nil) append a comment at the end of new or modified lines
+        #
+        #     @option options [Boolean, nil] :fixed_value (nil) treat the value regex as an exact string
+        #
+        #     @option options [String] :type (nil) ensure the value conforms to the given type
+        #
+        #     @option options [Boolean, nil] :no_type (nil) unset the previously set type specifier;
+        #       `true` emits `--no-type`
+        #
+        #     @return [Git::CommandLine::Result] the result of calling `git config --replace-all`
+        #
+        #     @raise [ArgumentError] if unsupported options are provided
+        #
+        #     @raise [Git::FailedError] if git exits with a non-zero exit status
+      end
+    end
+  end
+end

data/lib/git/commands/config_option_syntax/set.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require 'git/commands/base'
+
+module Git
+  module Commands
+    module ConfigOptionSyntax
+      # Set a config value
+      #
+      # Wraps the implicit `git config <name> <value>` set mode to assign
+      # a value to a config key, optionally replacing only the entry
+      # matching a value regex.
+      #
+      # @example Set a local config value
+      #   cmd = Git::Commands::ConfigOptionSyntax::Set.new(lib)
+      #   cmd.call('user.name', 'Alice')
+      #
+      # @example Set a global config value
+      #   cmd = Git::Commands::ConfigOptionSyntax::Set.new(lib)
+      #   cmd.call('user.name', 'Alice', global: true)
+      #
+      # @example Set a value with a type constraint
+      #   cmd = Git::Commands::ConfigOptionSyntax::Set.new(lib)
+      #   cmd.call('core.bare', 'true', type: 'bool')
+      #
+      # @note `arguments` block audited against https://git-scm.com/docs/git-config/2.53.0
+      #
+      # @see Git::Commands::ConfigOptionSyntax
+      #
+      # @see https://git-scm.com/docs/git-config git-config documentation
+      #
+      # @api private
+      #
+      class Set < Git::Commands::Base
+        arguments do
+          literal 'config'
+
+          # Write modifiers
+          flag_option :replace_all
+          flag_option :append
+          value_option :comment
+
+          # File-scope options
+          flag_option :global
+          flag_option :system
+          flag_option :local
+          flag_option :worktree
+          value_option %i[file f]
+          value_option :blob
+
+          # Value matching
+          flag_option :fixed_value
+
+          # Type constraint
+          value_option :type, inline: true
+          flag_option :no_type
+
+          # Operands
+          end_of_options
+          operand :name, required: true
+          operand :value, required: true
+          operand :value_regex
+        end
+
+        # @!method call(*, **options)
+        #
+        #   @param options [Hash] command options
+        #
+        #   @option options [Boolean, nil] :replace_all (nil) command option key;
+        #     see overload docs for the full option list
+        #
+        #   @overload call(name, value, value_regex = nil, **options)
+        #
+        #     Execute the `git config <name> <value>` command
+        #
+        #     @param name [String] the config key name to set
+        #
+        #     @param value [String] the value to assign
+        #
+        #     @param value_regex [String, nil] (nil) optional regex to match the existing value to replace
+        #
+        #     @param options [Hash] command options
+        #
+        #     @option options [Boolean, nil] :replace_all (nil) replace all lines matching the key
+        #
+        #     @option options [Boolean, nil] :append (nil) add a new line without altering existing values
+        #
+        #     @option options [String] :comment (nil) append a comment at the end of new or modified lines
+        #
+        #     @option options [Boolean, nil] :global (nil) write to global config (`~/.gitconfig`)
+        #
+        #     @option options [Boolean, nil] :system (nil) write to system config
+        #
+        #     @option options [Boolean, nil] :local (nil) write to repository config (`.git/config`)
+        #
+        #     @option options [Boolean, nil] :worktree (nil) write to worktree config
+        #
+        #     @option options [String] :file (nil) write to the specified file
+        #
+        #       Alias: :f
+        #
+        #     @option options [String] :blob (nil) read from the specified blob
+        #
+        #     @option options [Boolean, nil] :fixed_value (nil) treat the value regex as an exact string
+        #
+        #     @option options [String] :type (nil) ensure the value conforms to the given type
+        #
+        #     @option options [Boolean, nil] :no_type (nil) unset the previously set type specifier;
+        #       `true` emits `--no-type`
+        #
+        #     @return [Git::CommandLine::Result] the result of calling `git config`
+        #
+        #     @raise [ArgumentError] if unsupported options are provided
+        #
+        #     @raise [Git::FailedError] if git exits with a non-zero exit status
+      end
+    end
+  end
+end

data/lib/git/commands/config_option_syntax/unset.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'git/commands/base'
+
+module Git
+  module Commands
+    module ConfigOptionSyntax
+      # Remove a single config entry
+      #
+      # Wraps `git config --unset` to remove the entry matching the given
+      # key name and optional value regex.
+      #
+      # @example Unset a config key
+      #   cmd = Git::Commands::ConfigOptionSyntax::Unset.new(lib)
+      #   cmd.call('user.name')
+      #
+      # @example Unset a global config key
+      #   cmd = Git::Commands::ConfigOptionSyntax::Unset.new(lib)
+      #   cmd.call('user.name', global: true)
+      #
+      # @note `arguments` block audited against https://git-scm.com/docs/git-config/2.53.0
+      #
+      # @see Git::Commands::ConfigOptionSyntax
+      #
+      # @see https://git-scm.com/docs/git-config git-config documentation
+      #
+      # @api private
+      class Unset < Git::Commands::Base
+        arguments do
+          literal 'config'
+          literal '--unset'
+
+          # File-scope options
+          flag_option :global
+          flag_option :system
+          flag_option :local
+          flag_option :worktree
+          value_option %i[file f]
+          value_option :blob
+
+          # Value matching
+          flag_option :fixed_value
+
+          # Operands
+          end_of_options
+          operand :name, required: true
+          operand :value_regex
+        end
+
+        # git config --unset exits 5 when trying to unset a non-existent or multi-valued key
+        allow_exit_status 0..5
+
+        # @overload call(name, value_regex = nil, **options)
+        #
+        #     Execute the `git config --unset` command
+        #
+        #     @param name [String] the config key name to unset
+        #
+        #     @param value_regex [String, nil] (nil) optional regex to match the value to remove
+        #
+        #     @param options [Hash] command options
+        #
+        #     @option options [Boolean, nil] :global (nil) remove from global config (`~/.gitconfig`)
+        #
+        #     @option options [Boolean, nil] :system (nil) remove from system config
+        #
+        #     @option options [Boolean, nil] :local (nil) remove from repository config (`.git/config`)
+        #
+        #     @option options [Boolean, nil] :worktree (nil) remove from worktree config
+        #
+        #     @option options [String] :file (nil) remove from the specified file
+        #
+        #       Alias: :f
+        #
+        #     @option options [String] :blob (nil) read from the specified blob
+        #
+        #     @option options [Boolean, nil] :fixed_value (nil) treat the value regex as an exact string
+        #
+        #     @return [Git::CommandLine::Result] the result of calling `git config --unset`
+        #
+        #     @raise [ArgumentError] if unsupported options are provided
+        #
+        #     @raise [Git::FailedError] if git exits outside the allowed range (exit code > 5)
+        #
+        #     @api public
+        def call(*, **)
+          super
+        end
+      end
+    end
+  end
+end

data/lib/git/commands/config_option_syntax/unset_all.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require 'git/commands/base'
+
+module Git
+  module Commands
+    module ConfigOptionSyntax
+      # Remove all matching config entries
+      #
+      # Wraps `git config --unset-all` to remove all entries matching the
+      # given key name and optional value regex.
+      #
+      # @example Unset all values for a key
+      #   cmd = Git::Commands::ConfigOptionSyntax::UnsetAll.new(lib)
+      #   cmd.call('remote.origin.fetch')
+      #
+      # @example Unset all values matching a pattern
+      #   cmd = Git::Commands::ConfigOptionSyntax::UnsetAll.new(lib)
+      #   cmd.call('core.gitproxy', 'for kernel.org$')
+      #
+      # @note `arguments` block audited against https://git-scm.com/docs/git-config/2.53.0
+      #
+      # @see Git::Commands::ConfigOptionSyntax
+      #
+      # @see https://git-scm.com/docs/git-config git-config documentation
+      #
+      # @api private
+      class UnsetAll < Git::Commands::Base
+        arguments do
+          literal 'config'
+          literal '--unset-all'
+
+          # File-scope options
+          flag_option :global
+          flag_option :system
+          flag_option :local
+          flag_option :worktree
+          value_option %i[file f]
+          value_option :blob
+
+          # Value matching
+          flag_option :fixed_value
+
+          # Operands
+          end_of_options
+          operand :name, required: true
+          operand :value_regex
+        end
+
+        # git config --unset-all exits 5 when trying to unset a non-existent key
+        allow_exit_status 0..5
+
+        # @!method call(*, **options)
+        #
+        #   @param options [Hash] command options
+        #
+        #   @option options [Boolean, nil] :global (nil) command option key; see
+        #     overload docs for the full option list
+        #
+        #   @overload call(name, value_regex = nil, **options)
+        #
+        #     Execute the `git config --unset-all` command
+        #
+        #     @param name [String] the config key name to unset
+        #
+        #     @param value_regex [String, nil] (nil) optional regex to match values to remove
+        #
+        #     @param options [Hash] command options
+        #
+        #     @option options [Boolean, nil] :global (nil) remove from global config (`~/.gitconfig`)
+        #
+        #     @option options [Boolean, nil] :system (nil) remove from system config
+        #
+        #     @option options [Boolean, nil] :local (nil) remove from repository config (`.git/config`)
+        #
+        #     @option options [Boolean, nil] :worktree (nil) remove from worktree config
+        #
+        #     @option options [String] :file (nil) remove from the specified file
+        #
+        #       Alias: :f
+        #
+        #     @option options [String] :blob (nil) read from the specified blob
+        #
+        #     @option options [Boolean, nil] :fixed_value (nil) treat the value regex as an exact string
+        #
+        #     @return [Git::CommandLine::Result] the result of calling `git config --unset-all`
+        #
+        #     @raise [ArgumentError] if unsupported options are provided
+        #
+        #     @raise [Git::FailedError] if git exits outside the allowed range (exit code > 5)
+      end
+    end
+  end
+end

data/lib/git/commands/config_option_syntax.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require_relative 'config_option_syntax/add'
+require_relative 'config_option_syntax/get'
+require_relative 'config_option_syntax/get_all'
+require_relative 'config_option_syntax/get_color'
+require_relative 'config_option_syntax/get_color_bool'
+require_relative 'config_option_syntax/get_regexp'
+require_relative 'config_option_syntax/get_urlmatch'
+require_relative 'config_option_syntax/list'
+require_relative 'config_option_syntax/remove_section'
+require_relative 'config_option_syntax/rename_section'
+require_relative 'config_option_syntax/replace_all'
+require_relative 'config_option_syntax/set'
+require_relative 'config_option_syntax/unset'
+require_relative 'config_option_syntax/unset_all'
+
+module Git
+  module Commands
+    # Implements the `git config` command using the option-based interface
+    #
+    # This module contains command classes for the pre-2.46.0 option-based
+    # `git config` interface (`--get`, `--list`, `--add`, etc.):
+    #
+    # **Read operations:**
+    # - {ConfigOptionSyntax::Get} — retrieve a single value (`--get`)
+    # - {ConfigOptionSyntax::GetAll} — retrieve all values for a multi-valued key (`--get-all`)
+    # - {ConfigOptionSyntax::GetRegexp} — retrieve values matching a name regex (`--get-regexp`)
+    # - {ConfigOptionSyntax::GetUrlmatch} — retrieve URL-matched values (`--get-urlmatch`)
+    # - {ConfigOptionSyntax::GetColor} — retrieve an ANSI color string (`--get-color`)
+    # - {ConfigOptionSyntax::GetColorBool} — query whether color output is enabled (`--get-colorbool`)
+    # - {ConfigOptionSyntax::List} — list all config entries (`--list`)
+    #
+    # **Write operations:**
+    # - {ConfigOptionSyntax::Set} — set a config value (implicit set mode)
+    # - {ConfigOptionSyntax::Add} — append a value to a multi-valued key (`--add`)
+    # - {ConfigOptionSyntax::ReplaceAll} — replace all matching values (`--replace-all`)
+    #
+    # **Delete operations:**
+    # - {ConfigOptionSyntax::Unset} — remove a single value (`--unset`)
+    # - {ConfigOptionSyntax::UnsetAll} — remove all matching values (`--unset-all`)
+    #
+    # **Section operations:**
+    # - {ConfigOptionSyntax::RenameSection} — rename a config section (`--rename-section`)
+    # - {ConfigOptionSyntax::RemoveSection} — remove a config section (`--remove-section`)
+    #
+    # @see https://git-scm.com/docs/git-config/2.28.0 git-config documentation (v2.28.0)
+    #
+    # @see Git::Commands
+    #
+    # @api private
+    #
+    module ConfigOptionSyntax
+    end
+  end
+end

data/lib/git/commands/describe.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+require 'git/commands/base'
+
+module Git
+  module Commands
+    # Implements the `git describe` command
+    #
+    # Gives a human-readable name to a commit based on the most recent
+    # reachable tag. When the tag points directly at the commit, only the
+    # tag name is shown. Otherwise, the tag name is suffixed with the number
+    # of additional commits and the abbreviated commit SHA.
+    #
+    # @example Typical usage
+    #   describe = Git::Commands::Describe.new(execution_context)
+    #   describe.call
+    #   describe.call('abc123')
+    #   describe.call(tags: true)
+    #   describe.call(dirty: true)
+    #   describe.call(dirty: '-dirty')
+    #
+    # @note `arguments` block audited against
+    #   https://git-scm.com/docs/git-describe/2.53.0
+    #
+    # @see https://git-scm.com/docs/git-describe git-describe
+    #
+    # @see Git::Commands
+    #
+    # @api private
+    #
+    class Describe < Git::Commands::Base
+      arguments do
+        literal 'describe'
+
+        # Ref selection
+        flag_option :all
+        flag_option :tags
+        flag_option :contains
+
+        # Abbreviation
+        flag_or_value_option :abbrev, inline: true
+
+        # Working tree state
+        flag_or_value_option :dirty, inline: true
+        flag_or_value_option :broken, inline: true
+
+        # Match candidates
+        value_option :candidates, inline: true
+        flag_option :exact_match
+
+        # Output control
+        flag_option :debug
+        flag_option :long
+
+        # Pattern filtering
+        value_option :match, repeatable: true
+        value_option :exclude, repeatable: true
+
+        # Fallback and history
+        flag_option :always
+        flag_option :first_parent
+
+        end_of_options
+        operand :commit_ish, repeatable: true
+      end
+
+      # @overload call(*commit_ish, **options)
+      #
+      #     Execute the `git describe` command
+      #
+      #     @param commit_ish [Array<String>] zero or more commit-ish objects
+      #       to describe
+      #
+      #       When none are given, describes HEAD.
+      #
+      #     @param options [Hash] command options
+      #
+      #     @option options [Boolean, nil] :all (nil) use any ref found in the
+      #       `refs/` namespace, not just tags
+      #
+      #     @option options [Boolean, nil] :tags (nil) use any tag found in the
+      #       `refs/tags` namespace, instead of only annotated tags
+      #
+      #     @option options [Boolean, nil] :contains (nil) find the tag that
+      #       comes after the commit and thus contains it, rather than the
+      #       most recent tag reachable from it
+      #
+      #     @option options [Boolean, String, nil] :abbrev (nil) use this many
+      #       digits for the abbreviated commit object name
+      #
+      #       When `true`, emits bare `--abbrev` (which uses git's default
+      #       length). Pass a string to emit `--abbrev=<n>`.
+      #
+      #     @option options [Boolean, String, nil] :dirty (nil) describe the
+      #       working tree
+      #
+      #       When `true`, appends `-dirty`; when a String, appends that
+      #       string as the dirty mark. Maps to `--dirty[=<mark>]`.
+      #
+      #     @option options [Boolean, String, nil] :broken (nil) describe the
+      #       working tree, treating broken links as dirty
+      #
+      #       When `true`, appends `-broken`; when a String, appends that
+      #       string as the broken mark. Maps to `--broken[=<mark>]`.
+      #
+      #     @option options [Integer, String] :candidates (nil) consider up
+      #       to this many candidates
+      #
+      #       Increasing above the default of 10 will take a slightly
+      #       longer time but may produce a more accurate result. Maps to
+      #       `--candidates=<n>`.
+      #
+      #     @option options [Boolean, nil] :exact_match (nil) only output exact
+      #       matches (a tag directly references the supplied commit object)
+      #
+      #     @option options [Boolean, nil] :debug (nil) verbosely display
+      #       information about the searching strategy being employed
+      #
+      #     @option options [Boolean, nil] :long (nil) always output the long
+      #       format (the tag, the number of commits, and the abbreviated
+      #       object name) even when it matches a tag exactly
+      #
+      #     @option options [String, Array<String>] :match (nil) only
+      #       consider tags matching the given `glob(7)` pattern
+      #
+      #       Pass an array to match against multiple patterns. Maps to
+      #       `--match <pattern>`.
+      #
+      #     @option options [String, Array<String>] :exclude (nil) do not
+      #       consider tags matching the given `glob(7)` pattern
+      #
+      #       Pass an array to exclude multiple patterns. Maps to
+      #       `--exclude <pattern>`.
+      #
+      #     @option options [Boolean, nil] :always (nil) show uniquely
+      #       abbreviated commit object as fallback when the commit cannot
+      #       be described
+      #
+      #     @option options [Boolean, nil] :first_parent (nil) follow only the
+      #       first parent of a merge commit
+      #
+      #     @return [Git::CommandLine::Result] the result of calling
+      #       `git describe`
+      #
+      #     @raise [ArgumentError] if unsupported options are provided
+      #
+      #     @raise [Git::FailedError] if git exits with a non-zero exit
+      #       status
+      #
+      #     @api public
+      def call(*, **)
+        super
+      end
+    end
+  end
+end