git 3.1.1 → 4.0.1

data/lib/git/diff_path_status.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Git
+  # The files and their status (e.g., added, modified, deleted) between two commits
+  class DiffPathStatus
+    include Enumerable
+
+    # @private
+    def initialize(base, from, to, path_limiter = nil)
+      # Eagerly check for invalid arguments
+      [from, to].compact.each do |arg|
+        raise ArgumentError, "Invalid argument: '#{arg}'" if arg.start_with?('-')
+      end
+
+      @base = base
+      @from = from
+      @to = to
+      @path_limiter = path_limiter
+      @path_status = nil
+    end
+
+    # Iterates over each file's status.
+    #
+    # @yield [path, status]
+    def each(&)
+      fetch_path_status.each(&)
+    end
+
+    # Returns the name-status report as a Hash.
+    #
+    # @return [Hash<String, String>] A hash where keys are file paths
+    #   and values are their status codes.
+    def to_h
+      fetch_path_status
+    end
+
+    private
+
+    # Lazily fetches and caches the path status from the git lib.
+    def fetch_path_status
+      @fetch_path_status ||= @base.lib.diff_path_status(
+        @from, @to, { path: @path_limiter }
+      )
+    end
+  end
+end

data/lib/git/diff_stats.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Git
+  # Provides access to the statistics of a diff between two commits,
+  # including insertions, deletions, and file-level details.
+  class DiffStats
+    # @private
+    def initialize(base, from, to, path_limiter = nil)
+      # Eagerly check for invalid arguments
+      [from, to].compact.each do |arg|
+        raise ArgumentError, "Invalid argument: '#{arg}'" if arg.start_with?('-')
+      end
+
+      @base = base
+      @from = from
+      @to = to
+      @path_limiter = path_limiter
+      @stats = nil
+    end
+
+    # Returns the total number of lines deleted.
+    def deletions
+      fetch_stats[:total][:deletions]
+    end
+
+    # Returns the total number of lines inserted.
+    def insertions
+      fetch_stats[:total][:insertions]
+    end
+
+    # Returns the total number of lines changed (insertions + deletions).
+    def lines
+      fetch_stats[:total][:lines]
+    end
+
+    # Returns a hash of statistics for each file in the diff.
+    #
+    # @return [Hash<String, {insertions: Integer, deletions: Integer}>]
+    def files
+      fetch_stats[:files]
+    end
+
+    # Returns a hash of the total statistics for the diff.
+    #
+    # @return [{insertions: Integer, deletions: Integer, lines: Integer, files: Integer}]
+    def total
+      fetch_stats[:total]
+    end
+
+    private
+
+    # Lazily fetches and caches the stats from the git lib.
+    def fetch_stats
+      @fetch_stats ||= @base.lib.diff_stats(
+        @from, @to, { path_limiter: @path_limiter }
+      )
+    end
+  end
+end

data/lib/git/errors.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 module Git
+  # rubocop:disable Layout/LineLength
+
   # Base class for all custom git module errors
   #
   # The git gem will only raise an `ArgumentError` or an error that is a subclass of
@@ -60,6 +62,8 @@ module Git
   #
   class Error < StandardError; end
 
+  # rubocop:enable Layout/LineLength
+
   # An alias for Git::Error
   #
   # Git::GitExecuteError error class is an alias for Git::Error for backwards
@@ -155,7 +159,8 @@ module Git
     #   status = ProcessExecuter.spawn(*command, timeout: timeout_duration)
     #   result = Git::CommandLineResult.new(command, status, 'stdout', 'err output')
     #   error = Git::TimeoutError.new(result, timeout_duration)
-    #   error.error_message #=> '["sleep", "10"], status: pid 70144 SIGKILL (signal 9), stderr: "err output", timed out after 1s'
+    #   error.error_message
+    #   #=> '["sleep", "10"], status: pid 70144 SIGKILL (signal 9), stderr: "err output", timed out after 1s'
     #
     # @param result [Git::CommandLineResult] the result of the git command including
     #   the git command, status, stdout, and stderr
@@ -171,7 +176,8 @@ module Git
     # The human readable representation of this error
     #
     # @example
-    #   error.error_message #=> '["sleep", "10"], status: pid 88811 SIGKILL (signal 9), stderr: "err output", timed out after 1s'
+    #   error.error_message
+    #   #=> '["sleep", "10"], status: pid 88811 SIGKILL (signal 9), stderr: "err output", timed out after 1s'
     #
     # @return [String]
     #

data/lib/git/escaped_path.rb

@@ -42,7 +42,7 @@ module Git
     private
 
     def extract_octal(path, index)
-      [path[index + 1..index + 3].to_i(8), 4]
+      [path[(index + 1)..(index + 3)].to_i(8), 4]
     end
 
     def extract_escape(path, index)