ruby_git 0.3.6 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7bcb191c36fedc350022fcc895d95c33ae96903e3154acc4d289b0cdb01b8078
-  data.tar.gz: af5e459bce99053a239d1fb6da6376fc4df3609c8e95f9059d490a578716e84c
+  metadata.gz: 51c942c1d3e14a3d22755da43c9ea15bb80ddd92b31e40b53c008eee0a47de42
+  data.tar.gz: 3194cd1143c85ed1c532189c4ca010bbf2fad93aa9fe95293c3861a62feb665b
 SHA512:
-  metadata.gz: baa4727ff238bd5efdc70f95919e203dd9552c7109f1398193ee1a909788516ead998eb03d72bd0131ae7fde44b681650386aba68627c018bf39c5dc140f8792
-  data.tar.gz: 0dd9357dd4521393b3e4e947162f6d53eb96d6e44d833a1f8e17878507f14bf3c7f70e8516eabdc64b72ee7974f6495e0ae454f8d8e6a3a6fa11090a205a5af0
+  metadata.gz: 18c2c2af28e5a23aa74786e1a9addc9d11d2ede3d968e76db11bdef609a4b8eff52c52b9d65b8a6ee6ce286f73eeb59adbad0f784d54d01d74568813b335b736
+  data.tar.gz: 73a8c700ef019fab3e63df64d26a9919c3789d3094180c759e4262de4fe9ec67100aa1a399003f542b2c668e67fa58428603e946e134526536e64917da35b020

data/.commitlintrc.yml

@@ -15,6 +15,23 @@ rules:
   # Run `npx commitlint --print-config` to see the current setting for all
   # rules.
   #
-  body-leading-blank:    [2, always]
-  footer-leading-blank:  [2, always]
-  type-enum:             [2, always, [build, ci, chore, docs, feat, fix, perf, refactor, revert, style, test]]
+  header-max-length:      [2, always, 100]        # Header can not exceed 100 chars
+
+  type-case:              [2, always, lower-case] # Type must be lower case
+  type-empty:             [2, never]              # Type must not be empty
+
+  # Supported conventional commit types
+  type-enum:              [2, always, [build, ci, chore, docs, feat, fix, perf, refactor, revert, style, test]]
+
+  scope-case:             [2, always, lower-case] # Scope must be lower case
+
+  # Error if subject is one of these cases (encourages lower-case)
+  subject-case:           [2, never, [sentence-case, start-case, pascal-case, upper-case]]
+  subject-empty:          [2, never]              # Subject must not be empty
+  subject-full-stop:      [2, never, "."]         # Subject must not end with a period
+
+  body-leading-blank:     [2, always]             # Body must have a blank line before it
+  body-max-line-length:   [2, always, 100]        # Body lines can not exceed 100 chars
+
+  footer-leading-blank:   [2, always]             # Footer must have a blank line before it
+  footer-max-line-length: [2, always, 100]        # Footer lines can not exceed 100 chars

data/.github/workflows/enforce_conventional_commits.yml

@@ -1,25 +1,30 @@
-name: Conventional Commits
+---
+  name: Conventional Commits
 
-on:
-  pull_request:
-    branches:
-      - main
+  permissions:
+    contents: read
 
-jobs:
-  commit-lint:
-    name: Verify Conventional Commits
+  on:
+    pull_request:
+      branches:
+        - main
 
-    if: >-
-      github.event_name == 'workflow_dispatch' ||
-      (github.event_name == 'pull_request' && !startsWith(github.event.pull_request.head.ref, 'release-please--'))
+  jobs:
+    commit-lint:
+      name: Verify Conventional Commits
 
-    runs-on: ubuntu-latest
+      # Skip this job if this is a release PR
+      if: >-
+        github.event_name == 'workflow_dispatch' ||
+        (github.event_name == 'pull_request' && !startsWith(github.event.pull_request.head.ref, 'release-please--'))
 
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with: { fetch-depth: 0 }
+      runs-on: ubuntu-latest
 
-      - name: Check Commit Messages
-        uses: wagoid/commitlint-github-action@v6
-        with: { configFile: .commitlintrc.yml }
+      steps:
+        - name: Checkout
+          uses: actions/checkout@v4
+          with: { fetch-depth: 0 }
+
+        - name: Check Commit Messages
+          uses: wagoid/commitlint-github-action@v6
+          with: { configFile: .commitlintrc.yml }

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.3.6"
+  ".": "0.4.0"
 }

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Change Log
 
+## [0.4.0](https://github.com/main-branch/ruby_git/compare/v0.3.6...v0.4.0) (2025-06-06)
+
+
+### ⚠ BREAKING CHANGES
+
+* this gem now raises `RubyGit::ArgumentError` where before it raised
+
+### Features
+
+* Upgrade process_executer dependency to 4.x ([86d94cd](https://github.com/main-branch/ruby_git/commit/86d94cd1e4291c99ac910996b0e0c03e2e2d2d3d))
+
+
+### Other Changes
+
+* Configure release-please to includes all changes in the CHANGELOG ([7b08f32](https://github.com/main-branch/ruby_git/commit/7b08f320a0968bae33aa5cd80d15b8a3cd598cc0))
+* Move EncodingNormalizer from RubyGit to RubyGit::CommandLine ([9110533](https://github.com/main-branch/ruby_git/commit/911053333665a6add6a5081737febd8b10cda304))
+
 ## [0.3.6](https://github.com/main-branch/ruby_git/compare/v0.3.5...v0.3.6) (2025-04-17)
 
 

data/Gemfile

@@ -2,5 +2,4 @@
 
 source 'https://rubygems.org'
 
-# Specify your gem's dependencies in ruby_git.gemspec
 gemspec

data/lib/ruby_git/command_line/encoding_normalizer.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'rchardet'
+
+module RubyGit
+  module CommandLine
+    # Utility to normalize string encoding
+    # @api public
+    module EncodingNormalizer
+      # Detects the character encoding used to create a string or binary data
+      #
+      # Detects the encoding of a string or return binary if it cannot be detected
+      #
+      # @example
+      #   EncodingNormalizer.detect_encoding("Hello, world!") #=> "ascii"
+      #   EncodingNormalizer.detect_encoding("\xCB\xEF\xF1\xE5\xEC") #=> "ISO-8859-7"
+      #   EncodingNormalizer.detect_encoding("\xC0\xCC\xB0\xCD\xC0\xBA") #=> "EUC-KR"
+      #
+      # @param str [String] the string to detect the encoding of
+      # @return [String] the detected encoding
+      #
+      def self.detect_encoding(str)
+        CharDet.detect(str)&.dig('encoding') || Encoding::BINARY.name
+      end
+
+      # Normalizes the encoding to normalize_to
+      #
+      # @example
+      #   EncodingNormalizer.normalize("Hello, world!") #=> "Hello, world!"
+      #   EncodingNormalizer.normalize("\xCB\xEF\xF1\xE5\xEC") #=> "Λορεμ"
+      #   EncodingNormalizer.normalize("\xC0\xCC\xB0\xCD\xC0\xBA") #=> "이것은"
+      #
+      # @param str [String] the string to normalize
+      # @param normalize_to [String] the name of the encoding to normalize to
+      #
+      # @return [String] the string with encoding converted to normalize_to
+      #
+      # @raise [Encoding::UndefinedConversionError] if the string cannot be converted to the default encoding
+      #
+      def self.normalize(str, normalize_to: Encoding::UTF_8.name)
+        encoding_options = { invalid: :replace, undef: :replace }
+
+        detected_encoding = detect_encoding(str)
+
+        return str if str.valid_encoding? && detected_encoding == normalize_to
+
+        str.encode(normalize_to, detected_encoding, **encoding_options)
+      end
+    end
+  end
+end

data/lib/ruby_git/command_line/options.rb

@@ -9,14 +9,12 @@ module RubyGit
     #
     # @api public
     #
-    class Options < ProcessExecuter::Options::RunOptions
+    class Options < ProcessExecuter::Options::RunWithCaptureOptions
       # Alias for brevity
       OptionDefinition = ProcessExecuter::Options::OptionDefinition
 
       private
 
-      # :nocov: SimpleCov on JRuby reports the last with the last argument line is not covered
-
       # The options allowed for objects of this class
       # @return [Array<OptionDefinition>]
       # @api private
@@ -24,25 +22,24 @@ module RubyGit
         [
           *super,
           OptionDefinition.new(:normalize_encoding, default: false, validator: method(:validate_normalize_encoding)),
-          OptionDefinition.new(:chomp, default: false, validator: method(:validate_chomp)),
-          OptionDefinition.new(:raise_git_errors, default: true, validator: method(:validate_raise_git_errors))
+          OptionDefinition.new(:chomp, default: false, validator: method(:validate_chomp))
         ].freeze
       end
-      # :nocov:
 
-      # Validate the raise_git_errors option value
-      # @return [String, nil] the error message if the value is not valid
+      # Wrap ProcessExecuter::ArgumentError in a RubyGit::ArgumentError
+      # @return [void]
+      # @raise [RubyGit::ArgumentError] if the options are invalid
       # @api private
-      def validate_raise_git_errors
-        return if [true, false].include?(raise_git_errors)
-
-        errors << "raise_git_errors must be true or false but was #{raise_git_errors.inspect}"
+      def validate_options
+        super
+      rescue ProcessExecuter::ArgumentError => e
+        raise RubyGit::ArgumentError, e.message, cause: e
       end
 
       # Validate the normalize_encoding option value
       # @return [String, nil] the error message if the value is not valid
       # @api private
-      def validate_normalize_encoding
+      def validate_normalize_encoding(_key, _value)
         return if [true, false].include?(normalize_encoding)
 
         errors << "normalize_encoding must be true or false but was #{normalize_encoding.inspect}"
@@ -51,7 +48,7 @@ module RubyGit
       # Validate the chomp option value
       # @return [String, nil] the error message if the value is not valid
       # @api private
-      def validate_chomp
+      def validate_chomp(_key, _value)
         return if [true, false].include?(chomp)
 
         errors << "chomp must be true or false but was #{chomp.inspect}"

data/lib/ruby_git/command_line/result.rb

@@ -7,27 +7,30 @@ module RubyGit
   module CommandLine
     # The result of running a git command
     #
-    # Adds stdout and stderr processing to the `ProcessExecuter::Result` class.
+    # Adds stdout and stderr processing to the `ProcessExecuter::ResultWithCapture` class.
     #
     # @api public
     #
     class Result < SimpleDelegator
       # @!method initialize(result)
       #   Initialize a new result object
+      #
       #   @example
-      #     result = ProcessExecuter.run('echo hello')
+      #     result = Git::CommandLine.run_with_capture('git', 'status')
       #     RubyGit::CommandLine::Result.new(result)
-      #   @param [ProcessExecuter::Result] result The result of running the command
+      #
+      #   @param [ProcessExecuter::ResultWithCapture] result The result of running the command
+      #
       #   @return [RubyGit::CommandLine::Result]
+      #
       #   @api public
 
       # Return the processed stdout output (or original if it was not processed)
       #
-      # This output is only returned if a stdout redirection is a
-      # `ProcessExecuter::MonitoredPipe`.
-      #
       # @example
-      #   result = ProcessExecuter.run('echo hello': out: StringIO.new)
+      #   result = RubyGit::CommandLine::Result.new(
+      #     ProcessExecuter.run_with_capture('echo hello')
+      #   )
       #   result.stdout #=> "hello\n"
       #
       # @return [String, nil]
@@ -39,20 +42,25 @@ module RubyGit
       # Process the captured stdout output
       #
       # @example
-      #   result = ProcessExecuter.run('echo hello', out: StringIO.new)
+      #   result = RubyGit::CommandLine::Result.new(
+      #     ProcessExecuter.run_with_capture('echo hello')
+      #   )
       #   result.stdout #=> "hello\n"
       #   result.process_stdout { |stdout, _result| stdout.upcase }
       #   result.stdout #=> "HELLO\n"
       #   result.unprocessed_stdout #=> "hello\n"
       #
       # @example Chain processing
-      #   result = ProcessExecuter.run('echo hello', out: StringIO.new)
+      #   result = RubyGit::CommandLine::Result.new(
+      #     ProcessExecuter.run_with_capture('echo hello')
+      #   )
       #   result.stdout #=> "hello\n"
+      #   # Here is the chain processing:
       #   result.process_stdout { |s| s.upcase }.process_stdout { |s| s.reverse }
       #   result.stdout #=> "OLLEH\n"
       #   result.unprocessed_stdout #=> "hello\n"
       #
-      # @return [String, nil]
+      # @return [self]
       #
       # @yield [stdout, result] Yields the stdout output and the result object
       # @yieldparam stdout [String] The output to process
@@ -62,16 +70,19 @@ module RubyGit
       # @api public
       #
       def process_stdout(&block)
-        return if block.nil?
+        return self if block.nil?
 
         @processed_stdout = block.call(stdout, self)
+
         self
       end
 
       # Returns the original stdout output before it was processed
       #
       # @example
-      #   result = ProcessExecuter.run('echo hello', out: StringIO.new)
+      #   result = RubyGit::CommandLine::Result.new(
+      #     ProcessExecuter.run_with_capture('echo hello')
+      #   )
       #   result.stdout #=> "hello\n"
       #   result.unprocessed_stdout #=> "hello\n"
       #   result.process_stdout { |s| s.upcase }
@@ -92,7 +103,9 @@ module RubyGit
       # `ProcessExecuter::MonitoredPipe`.
       #
       # @example
-      #   result = ProcessExecuter.run('echo hello 1>&2': err: StringIO.new)
+      #   result = RubyGit::CommandLine::Result.new(
+      #     ProcessExecuter.run_with_capture('echo hello >&2')
+      #   )
       #   result.stderr #=> "hello\n"
       #
       # @return [String, nil]
@@ -104,20 +117,25 @@ module RubyGit
       # Process the captured stderr output
       #
       # @example
-      #   result = ProcessExecuter.run('echo hello 1>&2', err: StringIO.new)
+      #   result = RubyGit::CommandLine::Result.new(
+      #     ProcessExecuter.run_with_capture('echo hello >&2')
+      #   )
       #   result.stderr #=> "hello\n"
       #   result.process_stderr { |stderr, _result| stderr.upcase }
       #   result.stderr #=> "HELLO\n"
       #   result.unprocessed_stderr #=> "hello\n"
       #
       # @example Chain processing
-      #   result = ProcessExecuter.run('echo hello 1>&2', err: StringIO.new)
+      #   result = RubyGit::CommandLine::Result.new(
+      #     ProcessExecuter.run_with_capture('echo hello >&2')
+      #   )
       #   result.stderr #=> "hello\n"
+      #   # Here is the chain processing:
       #   result.process_stderr { |s| s.upcase }.process_stderr { |s| s.reverse }
       #   result.stderr #=> "OLLEH\n"
       #   result.unprocessed_stderr #=> "hello\n"
       #
-      # @return [String, nil]
+      # @return [self]
       #
       # @yield [stderr, result] Yields the stderr output and the result object
       # @yieldparam stderr [String] The output to process
@@ -127,16 +145,19 @@ module RubyGit
       # @api public
       #
       def process_stderr(&block)
-        return if block.nil?
+        return self if block.nil?
 
         @processed_stderr = block.call(stderr, self)
+
         self
       end
 
       # Returns the original stderr output before it was processed
       #
       # @example
-      #   result = ProcessExecuter.run('echo hello 1>&2', err: StringIO.new)
+      #   result = RubyGit::CommandLine::Result.new(
+      #     ProcessExecuter.run_with_capture('echo hello >&2')
+      #   )
       #   result.stderr #=> "hello\n"
       #   result.unprocessed_stderr #=> "hello\n"
       #   result.process_stderr { |stderr| stderr.upcase }

data/lib/ruby_git/command_line/runner.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+require_relative 'encoding_normalizer'
 require_relative 'result'
+
 require 'ruby_git/errors'
 
 module RubyGit
@@ -152,7 +154,7 @@ module RubyGit
       #
       # @return [RubyGit::CommandLine::Result] the result of the command
       #
-      # @raise [ArgumentError] if `args` or `options_hash` are not valid
+      # @raise [RubyGit::ArgumentError] if `args` or `options_hash` are not valid
       #
       # @raise [RubyGit::FailedError] if the command returned a non-zero exitstatus
       #
@@ -163,18 +165,27 @@ module RubyGit
       # @raise [RubyGit::ProcessIOError] if an exception was raised while collecting subprocess output
       #
       def call(*args, **options_hash)
-        options_hash[:raise_errors] = false
         options = RubyGit::CommandLine::Options.new(logger: logger, **options_hash)
-        begin
-          result = run_with_chdir([env, *build_git_cmd(args)], options)
+        result = run(*args, options)
+        process_result(result, options)
+      end
+
+      private
+
+      # Run the git command with the given arguments and options
+      # @return [ProcessExecuter::ResultWithCapture] the result of the command
+      # @api private
+      def run(*args, options)
+        # We don't want ProcessExecuter to raise an error if the command fails, but
+        # we want to preserve the value of the raise_errors option to use in
+        # process_result.
+        options.merge(raise_errors: false).then do |options|
+          run_with_chdir([env, *build_git_cmd(args)], options)
         rescue ProcessExecuter::ProcessIOError => e
           raise RubyGit::ProcessIOError.new(e.message), cause: e.exception.cause
         end
-        process_result(result)
       end
 
-      private
-
       # Run command with options with special handling for the `chdir` option on JRuby
       #
       # JRuby does not support the `chdir` option in `Process.spawn`. Note that this
@@ -183,7 +194,7 @@ module RubyGit
       # @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
+      # @return [ProcessExecuter::ResultWithCapture] the result of the command
       #
       # @api private
       #
@@ -195,7 +206,9 @@ module RubyGit
           Dir.chdir(options.chdir) do
             saved_chdir = options.chdir
             options.merge!(chdir: :not_set)
-            run_and_handle_spawn_error(args, options).tap do
+            begin
+              run_and_handle_spawn_error(args, options)
+            ensure
               options.merge!(chdir: saved_chdir)
             end
           end
@@ -210,14 +223,14 @@ module RubyGit
       # @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
+      # @return [ProcessExecuter::ResultWithCapture] the result of the command
       #
       # @api private
       #
       def run_and_handle_spawn_error(args, options)
-        ProcessExecuter.run_with_options(args, options)
+        ProcessExecuter.run_with_capture(*args, options)
       rescue ProcessExecuter::SpawnError => e
-        raise RubyGit::SpawnError, e.message
+        raise RubyGit::SpawnError, e.message, cause: e
       end
 
       # Returns true if running on JRuby
@@ -228,11 +241,15 @@ module RubyGit
       def jruby? = RUBY_ENGINE == 'jruby'
 
       # Build the git command line from the available sources to send to `Process.spawn`
+      #
+      # @raise [RubyGit::ArgumentError] if the args array contains an array
+      #
       # @return [Array<String>]
+      #
       # @api private
       #
       def build_git_cmd(args)
-        raise ArgumentError, 'The args array can not contain an array' if args.any? { |a| a.is_a?(Array) }
+        raise RubyGit::ArgumentError, 'The args array can not contain an array' if args.any? { |a| a.is_a?(Array) }
 
         [binary_path, *global_options, *args].map(&:to_s)
       end
@@ -248,18 +265,21 @@ module RubyGit
       # @return [RubyGit::CommandLineResult] the result of the command to return to the caller
       #
       # @raise [RubyGit::FailedError] if the command failed
+      #
       # @raise [RubyGit::SignaledError] if the command was signaled
+      #
       # @raise [RubyGit::TimeoutError] if the command times out
+      #
       # @raise [RubyGit::ProcessIOError] if an exception was raised while collecting subprocess output
       #
       # @api private
       #
-      def process_result(result)
+      def process_result(result, options)
         RubyGit::CommandLine::Result.new(result).tap do |processed_result|
-          raise_any_errors(processed_result) if processed_result.options.raise_git_errors
+          raise_any_errors(processed_result) if options.raise_errors
 
-          processed_result.process_stdout { |s, r| process_output(s, r) }
-          processed_result.process_stderr { |s, r| process_output(s, r) }
+          processed_result.process_stdout { |output, result| process_output(output, result) }
+          processed_result.process_stderr { |output, result| process_output(output, result) }
         end
       end
 
@@ -303,7 +323,7 @@ module RubyGit
 
         output =
           if result.options.normalize_encoding
-            output.lines.map { |l| RubyGit::EncodingNormalizer.normalize(l) }.join
+            output.lines.map { |l| EncodingNormalizer.normalize(l) }.join
           else
             output.dup
           end

data/lib/ruby_git/errors.rb

@@ -16,6 +16,7 @@ module RubyGit
   # ```text
   # StandardError
   # └─> RubyGit::Error
+  #     ├─> RubyGit::ArgumentError
   #     ├─> RubyGit::CommandLineError
   #     │   ├─> RubyGit::FailedError
   #     │   └─> RubyGit::SignaledError
@@ -28,6 +29,7 @@ module RubyGit
   # | Error Class | Description |
   # | --- | --- |
   # | `Error` | This catch-all error serves as the base class for other custom errors raised by the git gem. |
+  # | `ArgumentError` | Raised when an invalid argument is passed to a method. |
   # | `CommandLineError` | A subclass of this error is raised when there is a problem executing the git command line. |
   # | `FailedError` | This error is raised when the git command line exits with a non-zero status code that is not expected by the git gem. |
   # | `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. |
@@ -66,6 +68,19 @@ module RubyGit
 
   # rubocop:enable Layout/LineLength
 
+  # Raised when an invalid argument is passed to a method
+  #
+  # @example Raising RubyGit::ArgumentError due to invalid option value
+  #   begin
+  #     RubyGit::CommandLine.run('status', timeout_after: 'not_a_number')
+  #   rescue RubyGit::ArgumentError => e
+  #     e.message #=> 'timeout_after must be nil or a non-negative real number but was "not_a_number"'
+  #   end
+  #
+  # @api public
+  #
+  class ArgumentError < RubyGit::Error; end
+
   # Raised when a git command fails or exits because of an uncaught signal
   #
   # The git command executed, status, stdout, and stderr are available from this

data/lib/ruby_git/version.rb

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

data/lib/ruby_git.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 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'
@@ -161,9 +160,7 @@ module RubyGit
   #   or git was not found on the path.
   #
   def self.binary_version
-    command = %w[version]
-    options = { out: StringIO.new, err: StringIO.new }
-    version_string = RubyGit::CommandLine.run(*command, **options).stdout[/\d+\.\d+(\.\d+)+/]
+    version_string = RubyGit::CommandLine.run('version').stdout[/\d+\.\d+(\.\d+)+/]
     version_string.split('.').collect(&:to_i)
   end
 end

data/release-please-config.json

@@ -33,4 +33,4 @@
     }
   ],
   "$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.2'
+  spec.add_dependency 'process_executer', '~> 4.0'
   spec.add_dependency 'rchardet', '~> 1.9'
 
   spec.metadata['rubygems_mfa_required'] = 'true'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_git
 version: !ruby/object:Gem::Version
-  version: 0.3.6
+  version: 0.4.0
 platform: ruby
 authors:
 - James Couball
@@ -203,14 +203,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.2'
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.2'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: rchardet
   requirement: !ruby/object:Gem::Requirement
@@ -263,10 +263,10 @@ files:
 - bin/setup
 - lib/ruby_git.rb
 - lib/ruby_git/command_line.rb
+- lib/ruby_git/command_line/encoding_normalizer.rb
 - lib/ruby_git/command_line/options.rb
 - lib/ruby_git/command_line/result.rb
 - 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
@@ -295,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.6
-  changelog_uri: https://rubydoc.info/gems/ruby_git/0.3.6/file/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/ruby_git/0.4.0
+  changelog_uri: https://rubydoc.info/gems/ruby_git/0.4.0/file/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:

data/lib/ruby_git/encoding_normalizer.rb

@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-
-require 'rchardet'
-
-module RubyGit
-  # Utility to normalize string encoding
-  # @api public
-  module EncodingNormalizer
-    # Detects the character encoding used to create a string or binary data
-    #
-    # Detects the encoding of a string or return binary if it cannot be detected
-    #
-    # @example
-    #   RubyGit::EncodingNormalizer.detect_encoding("Hello, world!") #=> "ascii"
-    #   RubyGit::EncodingNormalizer.detect_encoding("\xCB\xEF\xF1\xE5\xEC") #=> "ISO-8859-7"
-    #   RubyGit::EncodingNormalizer.detect_encoding("\xC0\xCC\xB0\xCD\xC0\xBA") #=> "EUC-KR"
-    #
-    # @param str [String] the string to detect the encoding of
-    # @return [String] the detected encoding
-    #
-    def self.detect_encoding(str)
-      CharDet.detect(str)&.dig('encoding') || Encoding::BINARY.name
-    end
-
-    # Normalizes the encoding to normalize_to
-    #
-    # @example
-    #   RubyGit::EncodingNormalizer.normalize("Hello, world!") #=> "Hello, world!"
-    #   RubyGit::EncodingNormalizer.normalize("\xCB\xEF\xF1\xE5\xEC") #=> "Λορεμ"
-    #   RubyGit::EncodingNormalizer.normalize("\xC0\xCC\xB0\xCD\xC0\xBA") #=> "이것은"
-    #
-    # @param str [String] the string to normalize
-    # @param normalize_to [String] the name of the encoding to normalize to
-    #
-    # @return [String] the string with encoding converted to normalize_to
-    #
-    # @raise [Encoding::UndefinedConversionError] if the string cannot be converted to the default encoding
-    #
-    def self.normalize(str, normalize_to: Encoding::UTF_8.name)
-      encoding_options = { invalid: :replace, undef: :replace }
-
-      detected_encoding = detect_encoding(str)
-
-      return str if str.valid_encoding? && detected_encoding == normalize_to
-
-      str.encode(normalize_to, detected_encoding, **encoding_options)
-    end
-  end
-end