git 2.3.0 → 2.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e24e434e4639e6c31133234cee6d96708baf23d212c2f78cf4b94159810b090
-  data.tar.gz: 9fc37b011ac0cb0e87a0ee50b7993e751a7075a7496d6feb41431d2f3612e823
+  metadata.gz: b62df99d178044fd3fe000a27475819f27bcede65dd96bbc884e1a9eb766df86
+  data.tar.gz: 37330af1ce4f2b8f0ea372cbb36fe32991ab93f5243dbe91589a045f7c5073cf
 SHA512:
-  metadata.gz: 232624614200233e3f2ed308a4e73580345fef5be0a98e64f35992ecb222fa96c4163399b2f08afbfcdf69cd3b2f8f6c57c309fe9122f18a56e9bc31f827b301
-  data.tar.gz: 4ae699244e5ff9f679795279b8dbfeebe35ce8c9bfb7e5d9a18552b77b3d86b630f50bd9fedb4eec4f697269cfec6c90f72adfa2edeada25258ab457f3b5dad8
+  metadata.gz: 6a10a88c4cc04970184c9f5e1eda87dfc4778366498a867931be7196de1a0d882b5d9a7c552249d384ad46e7e1dee2c1077aff1d3ea31e5b53254dbe099e781b
+  data.tar.gz: 76d10cc88dfd8150daaf6f53f1af46077345fa35a64b71c8f6276e388503f1f15fee173dca322ae49c7fb511ebe5d44dc43dd84b15a9a234e2b06aea627e7032

data/CHANGELOG.md

@@ -5,6 +5,20 @@
 
 # Change Log
 
+## v2.3.1 (2024-10-23)
+
+[Full Changelog](https://github.com/ruby-git/ruby-git/compare/v2.3.0..v2.3.1)
+
+Changes since v2.3.0:
+
+* e236007 test: allow bin/test-in-docker to accept the test file(s) to run on command line
+* f4747e1 test: rename bin/tests to bin/test-in-docker
+* 51f781c test: remove duplicate test from test_stashes.rb
+* 2e79dbe Fixed "unbranched" stash message support:
+* da6fa6e Conatinerised the test suite with Docker:
+* 2e23d47 Update instructions for building a specific version of Git
+* 70565e3 Add Git.binary_version to return the version of the git command line
+
 ## v2.3.0 (2024-09-01)
 
 [Full Changelog](https://github.com/ruby-git/ruby-git/compare/v2.2.0..v2.3.0)

data/CONTRIBUTING.md

@@ -3,6 +3,9 @@
 # @title How To Contribute
 -->
 
+# Contributing to the git gem
+
+* [Summary](#summary)
 * [How to contribute](#how-to-contribute)
 * [How to report an issue or request a feature](#how-to-report-an-issue-or-request-a-feature)
 * [How to submit a code or documentation change](#how-to-submit-a-code-or-documentation-change)
@@ -18,10 +21,14 @@
   * [Unit tests](#unit-tests)
   * [Continuous integration](#continuous-integration)
   * [Documentation](#documentation)
+* [Building a specific version of the Git command-line](#building-a-specific-version-of-the-git-command-line)
+  * [Install pre-requisites](#install-pre-requisites)
+  * [Obtain Git source code](#obtain-git-source-code)
+  * [Build git](#build-git)
+  * [Use the new Git version](#use-the-new-git-version)
 * [Licensing](#licensing)
 
-
-# Contributing to the git gem
+## Summary
 
 Thank you for your interest in contributing to the `ruby-git` project.
 
@@ -172,22 +179,100 @@ $ bin/test test_object test_archive
 
 # run all unit tests:
 $ bin/test
+
+# run unit tests with a different version of the git command line:
+$ GIT_PATH=/Users/james/Downloads/git-2.30.2/bin-wrappers bin/test
 ```
 
 ### Continuous integration
 
-All tests must pass in the project's [GitHub Continuous Integration build](https://github.com/ruby-git/ruby-git/actions?query=workflow%3ACI) before the pull request will be merged.
+All tests must pass in the project's [GitHub Continuous Integration
+build](https://github.com/ruby-git/ruby-git/actions?query=workflow%3ACI) before the
+pull request will be merged.
 
-The [Continuous Integration workflow](https://github.com/ruby-git/ruby-git/blob/master/.github/workflows/continuous_integration.yml) runs both `bundle exec rake default` and `bundle exec rake test:gem` from the project's [Rakefile](https://github.com/ruby-git/ruby-git/blob/master/Rakefile).
+The [Continuous Integration
+workflow](https://github.com/ruby-git/ruby-git/blob/master/.github/workflows/continuous_integration.yml)
+runs both `bundle exec rake default` and `bundle exec rake test:gem` from the
+project's [Rakefile](https://github.com/ruby-git/ruby-git/blob/master/Rakefile).
 
 ### Documentation
 
-New and updated public methods must include [YARD](https://yardoc.org/) documentation.
+New and updated public methods must include [YARD](https://yardoc.org/)
+documentation.
+
+New and updated public-facing features should be documented in the project's
+[README.md](README.md).
+
+## Building a specific version of the Git command-line
+
+To test with a specific version of the Git command-line, you may need to build that
+version from source code. The following instructions are adapted from Atlassian’s
+[How to install Git](https://www.atlassian.com/git/tutorials/install-git) page for
+building Git on macOS.
+
+### Install pre-requisites
+
+Prerequisites only need to be installed if they are not already present.
+
+From your terminal, install Xcode’s Command Line Tools:
+
+```shell
+xcode-select --install
+```
+
+Install [Homebrew](http://brew.sh/) by following the instructions on the Homebrew
+page.
+
+Using Homebrew, install OpenSSL:
+
+```shell
+brew install openssl
+```
+
+### Obtain Git source code
+
+Download and extract the source tarball for the desired Git version from [this source
+code mirror](https://mirrors.edge.kernel.org/pub/software/scm/git/).
+
+### Build git
+
+From your terminal, change to the root directory of the extracted source code and run
+the build with following command:
+
+```shell
+NO_GETTEXT=1 make CFLAGS="-I/usr/local/opt/openssl/include" LDFLAGS="-L/usr/local/opt/openssl/lib"
+```
+
+The build script will place the newly compiled Git executables in the `bin-wrappers`
+directory (e.g., `bin-wrappers/git`).
+
+### Use the new Git version
+
+To configure programs that use the Git gem to utilize the newly built version, do the
+following:
+
+```ruby
+require 'git'
+
+# Set the binary path
+Git.configure { |c| c.binary_path = '/Users/james/Downloads/git-2.30.2/bin-wrappers/git' }
+
+# Validate the version (if desired)
+assert_equal([2, 30, 2], Git.binary_version)
+```
+
+Tests can be run using the newly built Git version as follows:
+
+```shell
+GIT_PATH=/Users/james/Downloads/git-2.30.2/bin-wrappers bin/test
+```
 
-New and updated public-facing features should be documented in the project's [README.md](README.md).
+Note: `GIT_PATH` refers to the directory containing the `git` executable.
 
 ## Licensing
 
-`ruby-git` uses [the MIT license](https://choosealicense.com/licenses/mit/) as declared in the [LICENSE](LICENSE) file.
+`ruby-git` uses [the MIT license](https://choosealicense.com/licenses/mit/) as
+declared in the [LICENSE](LICENSE) file.
 
-Licensing is critical to open-source projects as it ensures the software remains available under the terms desired by the author.
+Licensing is critical to open-source projects as it ensures the software remains
+available under the terms desired by the author.

data/lib/git/base.rb

@@ -36,6 +36,20 @@ module Git
       @@config ||= Config.new
     end
 
+    def self.binary_version(binary_path)
+      git_cmd = "#{binary_path} -c core.quotePath=true -c color.ui=false version 2>&1"
+      result, status = Open3.capture2(git_cmd)
+      result = result.chomp
+
+      if status.success?
+        version = result[/\d+(\.\d+)+/]
+        version_parts = version.split('.').collect { |i| i.to_i }
+        version_parts.fill(0, version_parts.length...3)
+      else
+        raise RuntimeError, "Failed to get git version: #{status}\n#{result}"
+      end
+    end
+
     # (see Git.init)
     def self.init(directory = '.', options = {})
       normalize_paths(options, default_working_directory: directory, default_repository: directory, bare: options[:bare])

data/lib/git/lib.rb

@@ -1134,8 +1134,10 @@ module Git
       if File.exist?(filename)
         File.open(filename) do |f|
           f.each_with_index do |line, i|
-            m = line.match(/:(.*)$/)
-            arr << [i, m[1].strip]
+            _, msg = line.split("\t")
+            # NOTE this logic may be removed/changed in 3.x
+            m = msg.match(/^[^:]+:(.*)$/)
+            arr << [i, (m ? m[1] : msg).strip]
           end
         end
       end

data/lib/git/version.rb

@@ -1,5 +1,5 @@
 module Git
   # The current gem version
   # @return [String] the current gem version.
-  VERSION='2.3.0'
+  VERSION='2.3.1'
 end

data/lib/git.rb

@@ -381,4 +381,15 @@ module Git
   def self.open(working_dir, options = {})
     Base.open(working_dir, options)
   end
+
+  # Return the version of the git binary
+  #
+  # @example
+  #  Git.binary_version # => [2, 46, 0]
+  #
+  # @return [Array<Integer>] the version of the git binary
+  #
+  def self.binary_version(binary_path = Git::Base.config.binary_path)
+    Base.binary_version(binary_path)
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: git
 version: !ruby/object:Gem::Version
-  version: 2.3.0
+  version: 2.3.1
 platform: ruby
 authors:
 - Scott Chacon and others
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-01 00:00:00.000000000 Z
+date: 2024-10-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -243,8 +243,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/2.3.0/file/CHANGELOG.md
-  documentation_uri: https://rubydoc.info/gems/git/2.3.0
+  changelog_uri: https://rubydoc.info/gems/git/2.3.1/file/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/git/2.3.1
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -261,7 +261,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - git 2.28.0 or greater
-rubygems_version: 3.5.9
+rubygems_version: 3.5.16
 signing_key:
 specification_version: 4
 summary: An API to create, read, and manipulate Git repositories