git 1.19.1 → 5.5.0

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

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require 'git/commands/base'
+
+module Git
+  module Commands
+    module ConfigOptionSyntax
+      # Retrieve an ANSI color string from config
+      #
+      # Wraps `git config --get-color` to look up a color configuration
+      # and output the ANSI escape sequence for that color.
+      #
+      # @example Get a color config value
+      #   cmd = Git::Commands::ConfigOptionSyntax::GetColor.new(lib)
+      #   cmd.call('color.diff.new')
+      #
+      # @example Get a color config value with a default
+      #   cmd = Git::Commands::ConfigOptionSyntax::GetColor.new(lib)
+      #   cmd.call('color.diff.new', 'green')
+      #
+      # @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 GetColor < Git::Commands::Base
+        arguments do
+          literal 'config'
+          literal '--get-color'
+
+          # File-scope options
+          flag_option :global
+          flag_option :system
+          flag_option :local
+          flag_option :worktree
+          value_option %i[file f]
+          value_option :blob
+
+          # General read options
+          flag_option :includes, negatable: true
+
+          # Operands
+          end_of_options
+          operand :name, required: true
+          operand :default
+        end
+
+        # @overload call(name, default = nil, **options)
+        #
+        #     Execute the `git config --get-color` command
+        #
+        #     @param name [String] the color config key name to look up
+        #
+        #     @param default [String, nil] (nil) fallback color when the key is not set
+        #
+        #     @param options [Hash] command options
+        #
+        #     @option options [Boolean, nil] :global (nil) read from global config (`~/.gitconfig`)
+        #
+        #     @option options [Boolean, nil] :system (nil) read from system config
+        #
+        #     @option options [Boolean, nil] :local (nil) read from repository config (`.git/config`)
+        #
+        #     @option options [Boolean, nil] :worktree (nil) read from worktree config
+        #
+        #     @option options [String] :file (nil) read from the specified file
+        #
+        #       Alias: :f
+        #
+        #     @option options [String] :blob (nil) read from the specified blob
+        #
+        #     @option options [Boolean, nil] :includes (nil) respect include directives in config files
+        #       (`--includes`)
+        #
+        #     @option options [Boolean, nil] :no_includes (nil) suppress include directive processing
+        #       (`--no-includes`)
+        #
+        #     @return [Git::CommandLine::Result] the result of calling `git config --get-color`
+        #
+        #     @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
+end

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

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require 'git/commands/base'
+
+module Git
+  module Commands
+    module ConfigOptionSyntax
+      # Query whether color output is enabled for a config key
+      #
+      # Wraps `git config --get-colorbool` to check whether color output
+      # should be used. This command has no subcommand equivalent even in
+      # git 2.46.0 — it exists only in the option-syntax interface.
+      #
+      # @example Query whether color is enabled for diff
+      #   cmd = Git::Commands::ConfigOptionSyntax::GetColorBool.new(lib)
+      #   cmd.call('color.diff')
+      #
+      # @example Query with explicit stdout-is-tty hint
+      #   cmd = Git::Commands::ConfigOptionSyntax::GetColorBool.new(lib)
+      #   cmd.call('color.diff', '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 GetColorBool < Git::Commands::Base
+        arguments do
+          literal 'config'
+          literal '--get-colorbool'
+
+          # File-scope options
+          flag_option :global
+          flag_option :system
+          flag_option :local
+          flag_option :worktree
+          value_option %i[file f]
+          value_option :blob
+
+          # General read options
+          flag_option :includes, negatable: true
+
+          # Operands
+          end_of_options
+          operand :name, required: true
+          operand :stdout_is_tty
+        end
+
+        # git config --get-colorbool exits 0 for color=yes, 1 for color=no
+        allow_exit_status 0..1
+
+        # @overload call(name, stdout_is_tty = nil, **options)
+        #
+        #     Execute the `git config --get-colorbool` command
+        #
+        #     @param name [String] the color config key name to query
+        #
+        #     @param stdout_is_tty [String, nil] (nil) hint whether stdout is a TTY (`"true"` or `"false"`)
+        #
+        #     @param options [Hash] command options
+        #
+        #     @option options [Boolean, nil] :global (nil) read from global config (`~/.gitconfig`)
+        #
+        #     @option options [Boolean, nil] :system (nil) read from system config
+        #
+        #     @option options [Boolean, nil] :local (nil) read from repository config (`.git/config`)
+        #
+        #     @option options [Boolean, nil] :worktree (nil) read from worktree config
+        #
+        #     @option options [String] :file (nil) read from the specified file
+        #
+        #       Alias: :f
+        #
+        #     @option options [String] :blob (nil) read from the specified blob
+        #
+        #     @option options [Boolean, nil] :includes (nil) respect include directives in config files (`--includes`)
+        #
+        #     @option options [Boolean, nil] :no_includes (nil) disable include directive processing (`--no-includes`)
+        #
+        #     @return [Git::CommandLine::Result] the result of calling `git config --get-colorbool`
+        #
+        #     @raise [ArgumentError] if unsupported options are provided
+        #
+        #     @raise [Git::FailedError] if git exits outside the allowed range (exit code > 1)
+        #
+        #     @api public
+        def call(*, **)
+          super
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require 'git/commands/base'
+
+module Git
+  module Commands
+    module ConfigOptionSyntax
+      # Retrieve config entries matching a name regex
+      #
+      # Wraps `git config --get-regexp` to return all config entries whose
+      # key name matches the given regular expression.
+      #
+      # @example Get all entries matching a pattern
+      #   cmd = Git::Commands::ConfigOptionSyntax::GetRegexp.new(lib)
+      #   cmd.call('remote\..*\.url')
+      #
+      # @example Get matching entries with value filter
+      #   cmd = Git::Commands::ConfigOptionSyntax::GetRegexp.new(lib)
+      #   cmd.call('remote\..*\.url', 'github')
+      #
+      # @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
+      #
+      # @api private
+      #
+      class GetRegexp < Git::Commands::Base
+        arguments do
+          literal 'config'
+          literal '--get-regexp'
+
+          # File-scope options
+          flag_option :global
+          flag_option :system
+          flag_option :local
+          flag_option :worktree
+          value_option %i[file f]
+          value_option :blob
+
+          # General read options
+          flag_option :includes, negatable: true
+
+          # Type constraint
+          value_option :type, inline: true
+
+          # Output modifiers
+          flag_option :show_origin
+          flag_option :show_scope
+          flag_option %i[null z]
+          flag_option :name_only
+
+          # Operands
+          end_of_options
+          operand :name_regex, required: true
+          operand :value_regex
+        end
+
+        # git config --get-regexp exits 1 when no match is found (not an error)
+        allow_exit_status 0..1
+
+        # @overload call(name_regex, value_regex = nil, **options)
+        #
+        #     Execute the `git config --get-regexp` command
+        #
+        #     @param name_regex [String] regex pattern to match config key names
+        #
+        #     @param value_regex [String, nil] optional regex to filter values
+        #
+        #     @param options [Hash] command options
+        #
+        #     @option options [Boolean, nil] :global (nil) read from global config (`~/.gitconfig`)
+        #
+        #     @option options [Boolean, nil] :system (nil) read from system config
+        #
+        #     @option options [Boolean, nil] :local (nil) read from repository config (`.git/config`)
+        #
+        #     @option options [Boolean, nil] :worktree (nil) read from worktree config
+        #
+        #     @option options [String] :file (nil) read from the specified file
+        #
+        #       Alias: :f
+        #
+        #     @option options [String] :blob (nil) read from the specified blob
+        #
+        #     @option options [Boolean, nil] :includes (nil) respect include directives in
+        #       config files (`--includes`)
+        #
+        #     @option options [Boolean, nil] :no_includes (nil) ignore include directives in
+        #       config files (`--no-includes`)
+        #
+        #     @option options [String] :type (nil) ensure values conform to the given type
+        #
+        #     @option options [Boolean, nil] :show_origin (nil) show the origin of each config entry
+        #
+        #     @option options [Boolean, nil] :show_scope (nil) show the scope of each config entry
+        #
+        #     @option options [Boolean, nil] :null (nil) terminate values with NUL byte instead of newline
+        #
+        #       Alias: :z
+        #
+        #     @option options [Boolean, nil] :name_only (nil) output only the names of config keys
+        #
+        #     @return [Git::CommandLine::Result] the result of calling `git config --get-regexp`
+        #
+        #     @raise [ArgumentError] if unsupported options are provided
+        #
+        #     @raise [Git::FailedError] if git exits outside the allowed range (exit code > 1)
+        #
+        #     @api public
+        #
+        def call(*, **)
+          super
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require 'git/commands/base'
+
+module Git
+  module Commands
+    module ConfigOptionSyntax
+      # Retrieve config values matching a URL
+      #
+      # Wraps `git config --get-urlmatch` to return config entries whose
+      # key name matches the given name and whose URL pattern matches the
+      # given URL.
+      #
+      # @example Get URL-matched config
+      #   cmd = Git::Commands::ConfigOptionSyntax::GetUrlmatch.new(lib)
+      #   cmd.call('http', 'https://example.com')
+      #
+      # @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
+      #
+      # @api private
+      #
+      class GetUrlmatch < Git::Commands::Base
+        arguments do
+          literal 'config'
+          literal '--get-urlmatch'
+
+          # File-scope options
+          flag_option :global
+          flag_option :system
+          flag_option :local
+          flag_option :worktree
+          value_option %i[file f]
+          value_option :blob
+
+          # Type constraint
+          value_option :type, inline: true
+
+          # Output modifier
+          flag_option %i[null z]
+
+          # General read options
+          flag_option :includes, negatable: true
+
+          # Output modifiers
+          flag_option :show_scope
+
+          # Operands
+          end_of_options
+          operand :name, required: true
+          operand :url, required: true
+        end
+
+        # git config --get-urlmatch exits 1 when no match is found (not an error)
+        allow_exit_status 0..1
+
+        # @overload call(name, url, **options)
+        #
+        #     Execute the `git config --get-urlmatch` command
+        #
+        #     @param name [String] the config key name (or section prefix) to look up
+        #
+        #     @param url [String] the URL to match against
+        #
+        #     @param options [Hash] command options
+        #
+        #     @option options [Boolean, nil] :global (nil) read from global config (`~/.gitconfig`)
+        #
+        #     @option options [Boolean, nil] :system (nil) read from system config
+        #
+        #     @option options [Boolean, nil] :local (nil) read from repository config (`.git/config`)
+        #
+        #     @option options [Boolean, nil] :worktree (nil) read from worktree config
+        #
+        #     @option options [String] :file (nil) read from the specified file
+        #
+        #       Alias: :f
+        #
+        #     @option options [String] :blob (nil) read from the specified blob
+        #
+        #     @option options [String] :type (nil) ensure values conform to the given type
+        #
+        #     @option options [Boolean, nil] :null (nil) terminate values with NUL byte instead of newline
+        #
+        #       Alias: :z
+        #
+        #     @option options [Boolean, nil] :includes (nil) respect include directives in config files (`--includes`)
+        #
+        #     @option options [Boolean, nil] :no_includes (nil) disable include directives
+        #       in config files (`--no-includes`)
+        #
+        #     @option options [Boolean, nil] :show_scope (nil) show the scope of each config entry
+        #
+        #     @return [Git::CommandLine::Result] the result of calling `git config --get-urlmatch`
+        #
+        #     @raise [ArgumentError] if unsupported options are provided
+        #
+        #     @raise [Git::FailedError] if git exits outside the allowed range (exit code > 1)
+        #
+        #     @api public
+        #
+        def call(*, **)
+          super
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require 'git/commands/base'
+
+module Git
+  module Commands
+    module ConfigOptionSyntax
+      # List all config entries
+      #
+      # Wraps `git config --list` to output all config entries visible
+      # from the current scope.
+      #
+      # @example List all config entries
+      #   cmd = Git::Commands::ConfigOptionSyntax::List.new(lib)
+      #   cmd.call
+      #
+      # @example List global config entries
+      #   cmd = Git::Commands::ConfigOptionSyntax::List.new(lib)
+      #   cmd.call(global: true)
+      #
+      # @example List entries from a specific file
+      #   cmd = Git::Commands::ConfigOptionSyntax::List.new(lib)
+      #   cmd.call(file: '/path/to/config')
+      #
+      # @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
+      #
+      # @api private
+      #
+      class List < Git::Commands::Base
+        arguments do
+          literal 'config'
+          literal '--list'
+
+          # File-scope options
+          flag_option :global
+          flag_option :system
+          flag_option :local
+          flag_option :worktree
+          value_option %i[file f]
+          value_option :blob
+
+          # General read options
+          flag_option :includes, negatable: true
+
+          # Output modifiers
+          flag_option :show_origin
+          flag_option :show_scope
+          flag_option %i[null z]
+          flag_option :name_only
+
+          # Type constraint
+          value_option :type, inline: true
+        end
+
+        # @overload call(**options)
+        #
+        #     Execute the `git config --list` command
+        #
+        #     @param options [Hash] command options
+        #
+        #     @option options [Boolean, nil] :global (nil) list only global config entries
+        #
+        #     @option options [Boolean, nil] :system (nil) list only system config entries
+        #
+        #     @option options [Boolean, nil] :local (nil) list only repository config entries
+        #
+        #     @option options [Boolean, nil] :worktree (nil) list only worktree config entries
+        #
+        #     @option options [String] :file (nil) list entries from the specified file
+        #
+        #       Alias: :f
+        #
+        #     @option options [String] :blob (nil) list entries from the specified blob
+        #
+        #     @option options [Boolean, nil] :includes (nil) respect include directives in config files
+        #       (`--includes`)
+        #
+        #     @option options [Boolean, nil] :no_includes (nil) suppress include directive processing
+        #       (`--no-includes`)
+        #
+        #     @option options [Boolean, nil] :show_origin (nil) show the origin of each config entry
+        #
+        #     @option options [Boolean, nil] :show_scope (nil) show the scope of each config entry
+        #
+        #     @option options [Boolean, nil] :null (nil) terminate values with NUL byte instead of newline
+        #
+        #       Alias: :z
+        #
+        #     @option options [Boolean, nil] :name_only (nil) output only the names of config keys
+        #
+        #     @option options [String] :type (nil) ensure values conform to the given type
+        #
+        #     @return [Git::CommandLine::Result] the result of calling `git config --list`
+        #
+        #     @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
+end

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

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require 'git/commands/base'
+
+module Git
+  module Commands
+    module ConfigOptionSyntax
+      # Remove a config section
+      #
+      # Wraps `git config --remove-section` to remove an entire section
+      # from the config file.
+      #
+      # @example Remove a section
+      #   cmd = Git::Commands::ConfigOptionSyntax::RemoveSection.new(lib)
+      #   cmd.call('old-section')
+      #
+      # @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
+      #
+      # @api private
+      class RemoveSection < Git::Commands::Base
+        arguments do
+          literal 'config'
+          literal '--remove-section'
+
+          # File-scope options
+          flag_option :global
+          flag_option :system
+          flag_option :local
+          flag_option :worktree
+          value_option %i[file f]
+          value_option :blob
+
+          # Operands
+          end_of_options
+          operand :name, required: true
+        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, **options)
+        #
+        #     Execute the `git config --remove-section` command
+        #
+        #     @param name [String] the section name 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
+        #
+        #     @return [Git::CommandLine::Result] the result of calling `git config --remove-section`
+        #
+        #     @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/rename_section.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require 'git/commands/base'
+
+module Git
+  module Commands
+    module ConfigOptionSyntax
+      # Rename a config section
+      #
+      # Wraps `git config --rename-section` to rename a section in the
+      # config file.
+      #
+      # @example Rename a section
+      #   cmd = Git::Commands::ConfigOptionSyntax::RenameSection.new(lib)
+      #   cmd.call('old-section', 'new-section')
+      #
+      # @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
+      #
+      # @api private
+      #
+      class RenameSection < Git::Commands::Base
+        arguments do
+          literal 'config'
+          literal '--rename-section'
+
+          # File-scope options
+          flag_option :global
+          flag_option :system
+          flag_option :local
+          flag_option :worktree
+          value_option %i[file f]
+          value_option :blob
+
+          # Operands
+          end_of_options
+          operand :old_name, required: true
+          operand :new_name, required: true
+        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(old_name, new_name, **options)
+        #
+        #     Execute the `git config --rename-section` command
+        #
+        #     @param old_name [String] the current section name
+        #
+        #     @param new_name [String] the new section name
+        #
+        #     @param options [Hash] command options
+        #
+        #     @option options [Boolean, nil] :global (nil) operate on global config (`~/.gitconfig`)
+        #
+        #     @option options [Boolean, nil] :system (nil) operate on system config
+        #
+        #     @option options [Boolean, nil] :local (nil) operate on repository config (`.git/config`)
+        #
+        #     @option options [Boolean, nil] :worktree (nil) operate on worktree config
+        #
+        #     @option options [String] :file (nil) operate on the specified file
+        #
+        #       Alias: :f
+        #
+        #     @option options [String] :blob (nil) read from the specified blob
+        #
+        #     @return [Git::CommandLine::Result] the result of calling `git config --rename-section`
+        #
+        #     @raise [ArgumentError] if unsupported options are provided
+        #
+        #     @raise [Git::FailedError] if git exits with a non-zero exit status
+      end
+    end
+  end
+end