git 4.4.5 → 4.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01ae4a6ba318c6ceb9d57b9983b80cd5c29eff80cdf0e4d78f488708ca0edda6
-  data.tar.gz: 1b83fd22774a10710da2a49251456c072a9373e9132ed31386c11563da83b8c9
+  metadata.gz: 92cc763ef58f6b7edb58f8212de310dfd064d66572ccdabbdf24342b78c47401
+  data.tar.gz: d3ae3f122e97723ad9ef1179314a155d3b3e3d22467c31f6fe7bef44e1fb9aaf
 SHA512:
-  metadata.gz: ab9bbd4f588bd753df94ecd7020f66d1ebb4f051c534aaa4aefc0fcf04b0f7842e5dcf6175dc4fa28485f8d9023643470e7b0a8bdd52e4ccca5a296a25550228
-  data.tar.gz: '0328e67227ad50a6f7fdeabcd6c3e36f5adf2d7a5946d52948218385cc19f4131cdcdd873748b6edc69b2929df11b63a6a0c177922efc51b8edd2a6c4ec97788'
+  metadata.gz: 2eb8c6a72e815cae09980035295fb0fe5435f8406e4d4deb023ade5ee4e375cbafc286e262589546725a6b62e383def83c6e24a64e34573539bf7d21b621bbde
+  data.tar.gz: 70e29c8086669ac54c92704f528d0e8220fcfe7a94596a4ff419bcf398a6ee7acb00fb7817f3e6d652940ade929e435e7ff438ce2ffc355b228b1e30a6e1b023

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.4.5"
+  ".": "4.4.6"
 }

data/CHANGELOG.md

@@ -5,6 +5,13 @@
 
 # Change Log
 
+## [4.4.6](https://github.com/ruby-git/ruby-git/compare/v4.4.5...v4.4.6) (2026-09-16)
+
+
+### Other Changes
+
+* **errors:** Document that filesystem and gzip errors can escape unconverted ([87d270f](https://github.com/ruby-git/ruby-git/commit/87d270f4f3a81c08c9727cc5106248d32b856c75)), closes [#1809](https://github.com/ruby-git/ruby-git/issues/1809)
+
 ## [4.4.5](https://github.com/ruby-git/ruby-git/compare/v4.4.4...v4.4.5) (2026-09-10)
 
 

data/README.md

@@ -507,6 +507,19 @@ end
 The git gem will only raise an `ArgumentError` or an error that is a subclass of
 `Git::Error`. It does not explicitly raise any other types of errors.
 
+The gem's own filesystem operations, such as reading a `.git` pointer file,
+creating a temporary file, or changing directory, do not convert operating system
+errors. These can be raised as a bare `SystemCallError` (for example `Errno::ENOENT`
+or `Errno::EACCES`) rather than `Git::Error`. Gzip compression in `archive` can
+likewise raise a `Zlib::Error`. Rescue `SystemCallError` and `Zlib::Error` alongside
+`Git::Error` if your code needs to handle them. Any method that captures git
+output can also raise `Encoding::ConverterNotFoundError` when the output contains
+a line whose detected encoding, such as UTF-7, has no Ruby converter.
+
+Starting with v6.0.0, the filesystem and gzip errors are raised as `Git::Error`
+with the original error available through `cause`, and lines with no Ruby
+converter are scrubbed instead of raising.
+
 It is recommended to rescue `Git::Error` to catch any runtime error raised by this
 gem unless you need more specific error handling.
 

data/lib/git/errors.rb

@@ -8,6 +8,16 @@ module Git
   # The git gem will only raise an `ArgumentError` or an error that is a subclass of
   # `Git::Error`. It does not explicitly raise any other types of errors.
   #
+  # The gem's own filesystem operations, such as reading a `.git` pointer file,
+  # creating a temporary file, or changing directory, do not convert operating
+  # system errors. These can be raised as a bare `SystemCallError` (for example
+  # `Errno::ENOENT` or `Errno::EACCES`) rather than `Git::Error`. Gzip compression
+  # in `archive` can likewise raise a `Zlib::Error`. Rescue `SystemCallError` and
+  # `Zlib::Error` alongside `Git::Error` if your code needs to handle them. Any
+  # method that captures git output can also raise
+  # `Encoding::ConverterNotFoundError` when a line's detected encoding has no Ruby
+  # converter.
+  #
   # It is recommended to rescue `Git::Error` to catch any runtime error raised by
   # this gem unless you need more specific error handling.
   #

data/lib/git/version.rb

@@ -3,5 +3,5 @@
 module Git
   # The current gem version
   # @return [String] the current gem version.
-  VERSION = '4.4.5'
+  VERSION = '4.4.6'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: git
 version: !ruby/object:Gem::Version
-  version: 4.4.5
+  version: 4.4.6
 platform: ruby
 authors:
 - Scott Chacon and others
@@ -310,8 +310,8 @@ licenses:
 metadata:
   homepage_uri: http://github.com/ruby-git/ruby-git
   source_code_uri: http://github.com/ruby-git/ruby-git
-  changelog_uri: https://rubydoc.info/gems/git/4.4.5/file/CHANGELOG.md
-  documentation_uri: https://rubydoc.info/gems/git/4.4.5
+  changelog_uri: https://rubydoc.info/gems/git/4.4.6/file/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/git/4.4.6
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
@@ -328,7 +328,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - git 2.28.0 or greater
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: An API to create, read, and manipulate Git repositories
 test_files: []