git 5.0.0.beta.4 → 5.0.0.beta.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24512a581eb9da75ed5026f0579869d4ae549a3c028d94a4d97edb5b5b063ac5
-  data.tar.gz: 86ce5ddca8a1bb92802afbb61e84e7b186a782222f8ff8fa7e6ee14d57020779
+  metadata.gz: dd627f8c88fec64de6a0bd1f809fec1415ec503b3e2a79cf0701d7dcea27f7af
+  data.tar.gz: 9d40f48b1b9fc7b9fee24b8092d540e32221b9cf8f63e01f8c600141b39382f1
 SHA512:
-  metadata.gz: fff5622c9a132467a43459c4ea2c5ad059d8e50a18ac7d45b2a7af37abfd37c0ed2e8cc834b654f2cabd99e6a53330a47f0b8e626cbf0e67433ff42f376bf8e0
-  data.tar.gz: 927adb62c1023e826cf76da5522fc7b5fb5c182bfec637e0c3d191967ad148b1b134403f7151a2f66460536bcf0ba4383c9daf40d2cc3a730e4aecb2fa97555a
+  metadata.gz: 9feb3e0cecb9bf51472690c3824719da82e66711466a83e5a3328d209c4a1bdebb134c5ed7a26c023097dfca6d78234b835f2abab08e6a07d714699c79e608e8
+  data.tar.gz: fa8013e041f2e7d73d73c1ddc18bb9e9d5b59e5d960154e1af1da759401782c288cce90646bf3fa4914738415611ee07dcdbcd7b314958bf85ba06c1fe190cb4

data/README.md

@@ -31,6 +31,7 @@ Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?log
   - [Ruby Version Support Policy](#ruby-version-support-policy)
   - [Git Version Support Policy](#git-version-support-policy)
 - [📢 Project Announcements 📢](#-project-announcements-)
+  - [2026-07-13: v5.0.0.beta.5 Released](#2026-07-13-v500beta5-released)
   - [2026-07-11: v5.0.0.beta.4 Released](#2026-07-11-v500beta4-released)
   - [2026-06-26: v5.0.0.beta.3 Released](#2026-06-26-v500beta3-released)
   - [2026-06-25: v5.0.0.beta.2 Released](#2026-06-25-v500beta2-released)
@@ -664,6 +665,37 @@ notes.
 
 ## 📢 Project Announcements 📢
 
+### 2026-07-13: v5.0.0.beta.5 Released
+
+We have published
+[`git v5.0.0.beta.5`](https://rubygems.org/gems/git/versions/5.0.0.beta.5) as our
+fifth pre-release.
+
+The main user-visible change is a temporary compatibility shim for users who
+monkeypatch `Git::Base`. In v5.0.0, `Git::Base` has been replaced by
+`Git::Repository`; the shim forwards methods defined on `Git::Base` to repository
+instances and emits deprecation warnings so applications can migrate those patches
+to `Git::Repository` before v6.0.0.
+
+**To try the beta**, add the pre-release version to your `Gemfile`:
+
+```ruby
+gem 'git', '~> 5.0.0.beta'
+```
+
+Or install it directly:
+
+```sh
+gem install git --pre
+```
+
+The intent is full backward compatibility with v4.x, but given the size and scope of
+the redesign, some incompatibilities may exist. Please give the latest beta a try and
+[open an issue](https://github.com/ruby-git/ruby-git/issues) if you hit anything
+unexpected — your feedback helps us ship a solid v5.0.0.
+
+See [UPGRADING.md](UPGRADING.md) for a full list of deprecations and breaking changes.
+
 ### 2026-07-11: v5.0.0.beta.4 Released
 
 The architectural redesign is **feature complete** and we have published

data/UPGRADING.md

@@ -9,7 +9,9 @@ to update your code when upgrading from the preceding major version.
   - [Breaking changes](#breaking-changes)
     - [`Git::Base` removed](#gitbase-removed)
     - [Return type of `Git.open`, `Git.clone`, `Git.init`, `Git.bare`](#return-type-of-gitopen-gitclone-gitinit-gitbare)
+    - [Unsupported options raise `ArgumentError`](#unsupported-options-raise-argumenterror)
     - [`Git::Lib` removed](#gitlib-removed)
+    - [`Git::Log#object` is not a path limiter](#gitlogobject-is-not-a-path-limiter)
     - [`Git::CommandLineResult` deprecated](#gitcommandlineresult-deprecated)
   - [Deprecated methods](#deprecated-methods)
     - [Facade method renames](#facade-method-renames)
@@ -45,6 +47,8 @@ For information on how to suppress or configure deprecation warnings, see the
 | `Git::Base` removed | Hard break | High for code that references it by name | Replace with `Git::Repository` (returned by `Git.open` etc.) |
 | `Git::Lib` removed | Hard break | High for `.lib.*` callers | Use the equivalent method directly on the repo object (see table below) |
 | `Git.open` etc. return `Git::Repository` (not `Git::Base`) | Hard break | Low for most callers; breaks `is_a?(Git::Base)` | Update type checks and update `be_a(Git::Base)` in tests |
+| Unsupported options now raise `ArgumentError` | Behavior change | Medium for code passing unknown or misspelled options | Check option names against the documented API |
+| `Git::Log#object` is not a path limiter | Behavior change | Medium for code that used `object(path)` to filter logs by path | Use `Git::Log#path` for path filtering |
 | `Git::CommandLineResult` deprecated | Deprecation (removed in v6.0.0) | Low; only affects code that references the constant by name | Use `Git::CommandLine::Result` instead |
 
 ---
@@ -114,6 +118,27 @@ construct a repository object.
 
 ---
 
+#### Unsupported options raise `ArgumentError`
+
+v5.x validates options more strictly for factory methods and command APIs.
+Unknown options that were silently ignored in v4.x may now raise
+`ArgumentError`. Check option names against the documented API when upgrading,
+especially for calls that pass keyword options through helper methods or shared
+option hashes.
+
+For example, `Git.clone` supports `log:`, not `logger:`. A misspelled or
+unsupported option that v4.x ignored must be corrected:
+
+```ruby
+# v4.x — silently ignored; did not configure clone logging
+Git.clone(url, path, logger: logger)
+
+# v5.x — use the documented option name
+Git.clone(url, path, log: logger)
+```
+
+---
+
 #### `Git::Lib` removed
 
 The object returned by `Git.open`, `Git.clone`, `Git.init`, and `Git.bare` previously
@@ -211,6 +236,30 @@ helpers with no plausible external use. They have no replacement in v5.0.0:
 
 ---
 
+#### `Git::Log#object` is not a path limiter
+
+In previous 4.x releases, some uses of `Git::Log#object(path)` could appear to
+filter log output by path when combined with `#between` or other revision range
+options. This relied on ambiguous `git log` argument handling and was not the
+intended API for path filtering.
+
+In v5.x, `Git::Log#object` should be treated as a revision expression. When both
+`#object` and `#between` are specified, `#between` takes precedence. Code that
+used `#object` to limit commits to a path should use `#path` instead.
+
+```ruby
+# v4.x — ambiguous; could appear to filter commits touching this path
+git.log(500).object('cookbooks/mycookbook').between('1.0.0', 'HEAD').execute
+
+# v5.x — use #path for path filtering
+git.log(500).path('cookbooks/mycookbook').between('1.0.0', 'HEAD').execute
+
+# #object remains appropriate for revision expressions
+git.log.object('HEAD~10..HEAD').execute
+```
+
+---
+
 #### `Git::CommandLineResult` deprecated
 
 `Git::CommandLineResult` was an alias for `Git::CommandLine::Result` introduced

data/lib/git/version.rb

@@ -4,7 +4,7 @@ module Git
   # The current gem version
   #
   # @return [String] the current gem version
-  VERSION = '5.0.0.beta.4'
+  VERSION = '5.0.0.beta.5'
 
   # Represents a git version with major, minor, and patch components
   #

data/lib/git.rb

@@ -110,6 +110,43 @@ module Git
   #
   MINIMUM_GIT_VERSION = Version.parse('2.28.0')
 
+  # Compatibility shim for code that monkeypatches the `Git::Base` class from
+  # versions prior to 5.0.0.
+  #
+  # `Git::Base` is a module included in {Git::Repository}, so any instance
+  # methods added to `Git::Base` are automatically available on
+  # {Git::Repository} instances. A deprecation warning is emitted for each
+  # method added, encouraging migration to {Git::Repository}.
+  #
+  # @example Monkeypatching Git::Base (deprecated)
+  #   module Git::Base
+  #     def my_helper = "hello"
+  #   end
+  #   Git.open('.').my_helper  # => "hello"
+  #
+  # @deprecated Define instance methods on {Git::Repository} instead.
+  #
+  # @api public
+  Base = Module.new do
+    # Emit a deprecation warning each time a method is defined in Git::Base so
+    # that authors of monkeypatches are nudged toward Git::Repository.
+    def self.method_added(method_name)
+      Git::Deprecation.warn(
+        'Monkeypatching Git::Base is deprecated and will be removed in v6.0.0. ' \
+        "Define #{method_name} in Git::Repository instead."
+      )
+      super
+    end
+
+    # Raise a clear error when legacy code calls Git::Base.new directly.
+    def self.new(...)
+      raise NoMethodError,
+            'Git::Base.new is not supported. Use Git.open, Git.clone, or Git.init instead.'
+    end
+  end
+
+  Repository.include(Base)
+
   # Intercept the first lookup of the deprecated `Git::CommandLineResult` constant
   #
   # When `name` is `:CommandLineResult`, caches and returns {Git::CommandLine::Result}

data/redesign/reverse_dependencies.sql

@@ -0,0 +1,44 @@
+WITH matching_dependencies AS (
+  SELECT
+    dependent_gem.name AS dependent_gem_name,
+    dependent_version.number AS dependent_version_number,
+    dependent_version.canonical_number AS dependent_version_canonical_number,
+    COALESCE(dependent_version.built_at, dependent_version.created_at) AS dependent_version_released_at,
+    dependencies.requirements,
+    COALESCE(linksets.code, linksets.home) AS url
+  FROM rubygems target_gem
+  JOIN dependencies
+    ON dependencies.rubygem_id = target_gem.id
+  JOIN versions dependent_version
+    ON dependent_version.id = dependencies.version_id
+  JOIN rubygems dependent_gem
+    ON dependent_gem.id = dependent_version.rubygem_id
+  LEFT JOIN linksets
+    ON linksets.rubygem_id = dependent_gem.id
+  WHERE target_gem.name = 'git'
+    AND (
+      dependencies.requirements LIKE '~> 4.%'
+      OR dependencies.requirements LIKE '>= %'
+    )
+),
+latest_dependencies AS (
+  SELECT DISTINCT ON (dependent_gem_name)
+    dependent_gem_name,
+    dependent_version_number,
+    dependent_version_released_at,
+    requirements,
+    url
+  FROM matching_dependencies
+  ORDER BY
+    dependent_gem_name,
+    dependent_version_canonical_number DESC NULLS LAST,
+    dependent_version_number DESC
+)
+SELECT
+  dependent_gem_name,
+  dependent_version_number,
+  dependent_version_released_at,
+  requirements,
+  url
+FROM latest_dependencies
+ORDER BY dependent_version_released_at DESC;

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: git
 version: !ruby/object:Gem::Version
-  version: 5.0.0.beta.4
+  version: 5.0.0.beta.5
 platform: ruby
 authors:
 - Scott Chacon and others
@@ -607,6 +607,7 @@ files:
 - redesign/config_design.rb
 - redesign/index.md
 - redesign/phase-4-step-b-test-audit.tsv
+- redesign/reverse_dependencies.sql
 - tasks/gem_tasks.rake
 - tasks/npm_tasks.rake
 - tasks/rspec.rake
@@ -619,8 +620,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/5.0.0.beta.4/file/CHANGELOG.md
-  documentation_uri: https://rubydoc.info/gems/git/5.0.0.beta.4
+  changelog_uri: https://rubydoc.info/gems/git/5.0.0.beta.5/file/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/git/5.0.0.beta.5
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: