git 1.16.0 → 1.17.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06d2809c51685e3171199f0eb8bce4c02a7970d61d12fabbde7bf2ab3850a86b
-  data.tar.gz: 439eac61b04b8fcdafa739f7f6f27cfc89f00d557aac52aacd6f71762bc8281e
+  metadata.gz: 6c893cd566fdfc36e3f6ea4fc742d7665b5daf14c299ff1acd19c40de49e3eb2
+  data.tar.gz: cc08038a56beb1ba3195600e80a666d66a7d58dd1abb16d4e5282718cd067bcd
 SHA512:
-  metadata.gz: 57db3b512e1d30130f1ab8bf9f77a701591c4c05c8c9fe35e9d047329cc7fe08b6e17c93d276bcfbfcb3e5c92a8dcb48cc571d513a7a981d69989eac7daea957
-  data.tar.gz: ee2b51658bda3767a01729888c60b677d79d69b75fadb8659a6d56144e82f51e21da817f7f310b1af0be9baedda37923315adac10ad7a65be1624b6ecb0628fb
+  metadata.gz: 82e6441de9ff798080bddc79ca411386a7c20b5d4208d584fa12925777bb66de1ddc3532d512087eb815c083184d30cf445ef097a47cc8a8089027b1498820c1
+  data.tar.gz: f0657f1ee3f3142612fdd904bc8649207e6bc1a115cbb3a969105c99a0fff15c0d1851b755c527351f06b462e6ff22b98e85ed4139acdcdcf949c434417becb2

data/CHANGELOG.md

@@ -5,6 +5,25 @@
 
 # Change Log
 
+## v1.17.1 (2023-03-06)
+
+[Full Changelog](https://github.com/ruby-git/ruby-git/compare/v1.17.0..v1.17.1)
+
+Changes since v1.17.0:
+
+* 774e Revert introduction of ActiveSupport dependency (#649)
+
+## v1.17.0 (2023-03-05)
+
+[Full Changelog](https://github.com/ruby-git/ruby-git/compare/v1.16.0..v1.17.0)
+
+Changes since v1.16.0:
+
+* 1311 Add deprecation mechanism (introduces runtime dependency on ActiveSupport) (#645)
+* 50b8 Add the push_option option for Git::Lib#push (#644)
+* a799 Make Git::Base#ls_tree handle commit objects (#643)
+* 6db3 Implememt Git.default_branch (#571)
+
 ## v1.16.0 (2023-03-03)
 
 [Full Changelog](https://github.com/ruby-git/ruby-git/compare/v1.15.0..v1.16.0)

data/README.md

@@ -197,6 +197,8 @@ g.show('v2.8', 'README.md')
 Git.ls_remote('https://github.com/ruby-git/ruby-git.git') # returns a hash containing the available references of the repo.
 Git.ls_remote('/path/to/local/repo')
 Git.ls_remote() # same as Git.ls_remote('.')
+
+Git.default_branch('https://github.com/ruby-git/ruby-git') #=> 'master'
 ```
 
 And here are the operations that will need to write to your git repository.

data/lib/git/base.rb

@@ -24,6 +24,11 @@ module Git
       new(new_options)
     end
 
+    # (see Git.default_branch)
+    def self.repository_default_branch(repository, options = {})
+      Git::Lib.new(nil, options[:log]).repository_default_branch(repository)
+    end
+
     # Returns (and initialize if needed) a Git::Config instance
     #
     # @return [Git::Config] the current config instance.
@@ -369,10 +374,23 @@ module Git
       self.lib.fetch(remote, opts)
     end
 
-    # pushes changes to a remote repository - easiest if this is a cloned repository,
-    # otherwise you may have to run something like this first to setup the push parameters:
+    # Push changes to a remote repository
+    #
+    # @overload push(remote = nil, branch = nil, options = {})
+    #   @param remote [String] the remote repository to push to
+    #   @param branch [String] the branch to push
+    #   @param options [Hash] options to pass to the push command
+    #
+    #   @option opts [Boolean] :mirror (false) Push all refs under refs/heads/, refs/tags/ and refs/remotes/
+    #   @option opts [Boolean] :delete (false) Delete refs that don't exist on the remote
+    #   @option opts [Boolean] :force (false) Force updates
+    #   @option opts [Boolean] :tags (false) Push all refs under refs/tags/
+    #   @option opts [Array, String] :push_options (nil) Push options to transmit
+    #
+    #   @return [Void]
     #
-    #  @git.config('remote.remote-name.push', 'refs/heads/master:refs/heads/master')
+    #   @raise [Git::FailedError] if the push fails
+    #   @raise [ArgumentError] if a branch is given without a remote
     #
     def push(*args, **options)
       self.lib.push(*args, **options)

data/lib/git/lib.rb

@@ -124,6 +124,24 @@ module Git
       base_opts
     end
 
+    # Returns the name of the default branch of the given repository
+    #
+    # @param repository [URI, Pathname, String] The (possibly remote) repository to clone from
+    #
+    # @return [String] the name of the default branch
+    #
+    def repository_default_branch(repository)
+      output = command('ls-remote', '--symref', '--', repository, 'HEAD')
+
+      match_data = output.match(%r{^ref: refs/remotes/origin/(?<default_branch>[^\t]+)\trefs/remotes/origin/HEAD$})
+      return match_data[:default_branch] if match_data
+
+      match_data = output.match(%r{^ref: refs/heads/(?<default_branch>[^\t]+)\tHEAD$})
+      return match_data[:default_branch] if match_data
+
+      raise 'Unable to determine the default branch'
+    end
+
     ## READ COMMANDS ##
 
     #
@@ -320,7 +338,7 @@ module Git
     end
 
     def ls_tree(sha)
-      data = {'blob' => {}, 'tree' => {}}
+      data = { 'blob' => {}, 'tree' => {}, 'commit' => {} }
 
       command_lines('ls-tree', sha).each do |line|
         (info, filenm) = line.split("\t")
@@ -964,6 +982,7 @@ module Git
       arr_opts << '--mirror'  if opts[:mirror]
       arr_opts << '--delete'  if opts[:delete]
       arr_opts << '--force'  if opts[:force] || opts[:f]
+      Array(opts[:push_option]).each { |o| arr_opts << '--push-option' << o } if opts[:push_option]
       arr_opts << remote if remote
       arr_opts_with_branch = arr_opts.dup
       arr_opts_with_branch << branch if branch

data/lib/git/version.rb

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

data/lib/git.rb

@@ -175,6 +175,46 @@ module Git
     Base.clone(repository_url, directory, options)
   end
 
+  # Returns the name of the default branch of the given repository
+  #
+  # @example with a URI string
+  #   Git.default_branch('https://github.com/ruby-git/ruby-git') # => 'master'
+  #   Git.default_branch('https://github.com/rspec/rspec-core') # => 'main'
+  #
+  # @example with a URI object
+  #   repository_uri = URI('https://github.com/ruby-git/ruby-git')
+  #   Git.default_branch(repository_uri) # => 'master'
+  #
+  # @example with a local repository
+  #   Git.default_branch('.') # => 'master'
+  #
+  # @example with a local repository Pathname
+  #   repository_path = Pathname('.')
+  #   Git.default_branch(repository_path) # => 'master'
+  #
+  # @example with the logging option
+  #   logger = Logger.new(STDOUT, level: Logger::INFO)
+  #   Git.default_branch('.', log: logger) # => 'master'
+  #   I, [2022-04-13T16:01:33.221596 #18415]  INFO -- : git '-c' 'core.quotePath=true' '-c' 'color.ui=false' ls-remote '--symref' '--' '.' 'HEAD'  2>&1
+  #
+  # @param repository [URI, Pathname, String] The (possibly remote) repository to get the default branch name for
+  #
+  #   See [GIT URLS](https://git-scm.com/docs/git-clone#_git_urls_a_id_urls_a)
+  #   for more information.
+  #
+  # @param [Hash] options The options for this command (see list of valid
+  #   options below)
+  #
+  # @option options [Logger] :log A logger to use for Git operations.  Git
+  #   commands are logged at the `:info` level.  Additional logging is done
+  #   at the `:debug` level.
+  #
+  # @return [String] the name of the default branch
+  #
+  def self.default_branch(repository, options = {})
+    Base.repository_default_branch(repository, options)
+  end
+
   # Export the current HEAD (or a branch, if <tt>options[:branch]</tt>
   # is specified) into the +name+ directory, then remove all traces of git from the
   # directory.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: git
 version: !ruby/object:Gem::Version
-  version: 1.16.0
+  version: 1.17.1
 platform: ruby
 authors:
 - Scott Chacon and others
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-03-04 00:00:00.000000000 Z
+date: 2023-03-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable