module Git::Repository::Diffing::Private

Builds a single file-info hash for {#parse_diff_files_output}

@param path [String] the file path

@param parts [Array<String>] the whitespace-split fields from the info

portion of the diff-files line: `[mode_src, mode_dest, sha_src,
sha_dest, type]`

@return [Hash] entry hash with keys ‘:mode_index`, `:mode_repo`, `:path`,

`:sha_repo`, `:sha_index`, `:type`

Builds the ‘:files` sub-hash for {#parse_numstat_output}

@param file_stats [Array<Hash>] per-file stats from {#parse_numstat_line}

@return [Hash{String => Hash}] per-file insertion and deletion counts

Builds the ‘:total` sub-hash for {#parse_numstat_output}

@param file_stats [Array<Hash>] per-file stats from {#parse_numstat_line}

@return [Hash] aggregate totals

`{ insertions: Integer, deletions: Integer, lines: Integer, files: Integer }`

Runs git-diff with ‘–raw` format options and returns the result

@param execution_context [Git::ExecutionContext] the execution context

used to run git commands

@param from [String] first ref

@param to [String, nil] second ref

@param pathspecs [Array<String>, nil] path limiters

@return [Git::CommandLine::Result] the result of calling ‘git diff`

Extracts name-status data from ‘–raw` diff output lines

Raw lines have the format:

:old_mode new_mode old_sha new_sha status\tpath

or for renames/copies:

:old_mode new_mode old_sha new_sha Rxx\told_path\tnew_path

@param output [String] raw diff output

@return [Hash{String => String}] mapping of file paths to status tokens

Filters raw numstat+shortstat output to only the numstat lines

@param output [String] combined command output

@return [Array<String>] only the numstat lines (no empties, no shortstat line)

Extracts only the patch text from combined diff command output

When {Git::Commands::Diff} is called with ‘patch: true, numstat: true, shortstat: true`, the stdout contains numstat lines, a shortstat summary line, and then the unified patch text starting at `“diff –git ”`. This method strips the leading numstat/shortstat lines and returns only the patch portion.

@param output [String] combined command output

@return [String] only the patch text (may be empty when there are no

changes)

Normalizes path specifications for Git commands

@param pathspecs [String, Pathname, Array<String, Pathname>, nil]

the path(s) to normalize

@param arg_name [String] the argument name used in error messages

@return [Array<String>, nil] the normalized paths, or ‘nil` if none are valid

@raise [ArgumentError] if any path is not a ‘String` or `Pathname`

Parses a single raw ‘git diff-files` output line into a path/entry pair

@param line [String] a single non-empty line containing a tab character

@param tab_pos [Integer] the index of the first tab in the line

@return [Array(String, Hash)] two-element array of ‘[path, entry_hash]`

Parses raw ‘git diff-files` output into a file-keyed hash

Each output line has the format:

`:old_mode new_mode old_sha new_sha status\tpath`

The leading colon on ‘old_mode` is stripped when building the `:mode_repo` value.

@param stdout [String] raw stdout from {Git::Commands::DiffFiles#call}

@return [Hash{String => Hash}] a hash keyed by file path where each

value has keys `:mode_index`, `:mode_repo`, `:path`, `:sha_repo`,
`:sha_index`, and `:type`

Parses a single ‘–numstat` line into a stats hash

Numstat lines have the format ‘<insertions>t<deletions>t<path>`. Quoted paths (containing non-ASCII or special characters) are unescaped.

@param line [String] a single numstat output line

@return [Hash] ‘{ filename: String, insertions: Integer, deletions: Integer }`

Parses combined ‘–numstat –shortstat` output into an insertions/deletions hash

Strips the trailing shortstat summary line and empty lines, parses the remaining numstat lines, and returns a structured hash with per-file stats and aggregated totals.

@param output [String] raw stdout from ‘git diff –numstat –shortstat`

@return [Hash] per-file insertion and deletion counts plus aggregate totals

```
{
  total: { insertions: Integer, deletions: Integer, lines: Integer, files: Integer },
  files: { "path/to/file" => { insertions: Integer, deletions: Integer } }
}
```

Resolves the effective path limiter from the options hash

When ‘:path_limiter` is present it is used directly and no warning is emitted. When only `:path` is present a deprecation warning is emitted and its value is used. Returns `nil` when neither key is present.

@param opts [Hash] the options hash from {#diff_path_status}

@option opts [String, Pathname, Array<String, Pathname>, nil] :path_limiter (nil)

primary path limiter value used as-is when present

@option opts [String, Pathname, Array<String, Pathname>, nil] :path (nil)

**deprecated** — fallback path limiter when `:path_limiter` is not provided

@return [String, Pathname, Array<String, Pathname>, nil]

the effective path limiter

Unescapes a git-quoted path (e.g. ‘“quoted_file_\342\230\240”`)

Git quotes paths that contain non-ASCII or special characters by wrapping them in double-quotes and octal-escaping each byte. This method strips the surrounding quotes and delegates unescaping to {Git::EscapedPath}.

@param path [String] the path as it appears in git output

@return [String] the unescaped path

Raises an error if any element of ‘pathspecs` is not a `String` or `Pathname`

@param pathspecs [Array] the path elements to validate

@param arg_name [String] the argument name used in error messages

@return [void]

@raise [ArgumentError] if any element is not a ‘String` or `Pathname`