Class: Bundler::Source::Git::GitProxy
Relationships & Source Files | |
Inherits: | Object |
Defined in: | lib/bundler/source/git/git_proxy.rb |
Overview
The GitProxy is responsible to interact with git repositories. All actions required by the ::Bundler::Source::Git
source is encapsulated in this object.
Class Method Summary
Instance Attribute Summary
- #branch rw
- #explicit_ref rw
- #path rw
- #ref rw
- #revision rw
- #revision=(value) rw
- #tag rw
- #uri rw
- #allow? ⇒ Boolean readonly private
- #clone_needs_extra_fetch? ⇒ Boolean readonly private
- #clone_needs_unshallow? ⇒ Boolean readonly private
- #full_clone? ⇒ Boolean readonly private
- #has_revision_cached? ⇒ Boolean readonly private
- #not_pinned? ⇒ Boolean readonly private
- #pinned_to_full_sha? ⇒ Boolean readonly private
- #supports_cloning_with_no_tags? ⇒ Boolean readonly private
- #supports_fetching_unreachable_refs? ⇒ Boolean readonly private
- #supports_minus_c? ⇒ Boolean readonly private
Instance Method Summary
- #checkout
- #contains?(commit) ⇒ Boolean
- #copy_to(destination, submodules = false)
- #current_branch
- #full_version
- #version
- #allowed_with_path private
- #capture(cmd, dir, ignore_err: false) private
- #capture3_args_for(cmd, dir) private
- #check_allowed(command) private
- #commit private
-
#configured_uri
private
Adds credentials to the
::Bundler::URI
. -
#credential_filtered_uri
private
Removes credentials from the
::Bundler::URI
. - #depth private
- #depth_args private
- #extra_clone_args private
- #extra_fetch_args private
- #extra_ref private
- #find_local_revision private
- #find_revision_for(reference) private
- #fully_qualified_ref private
- #git(*command, dir: nil) private
- #git_local(*command, dir: nil) private
- #git_null(*command, dir: nil) private
- #git_remote_fetch(args) private
- #git_retry(*command, dir: nil) private
- #head_revision private
- #redact_and_check_presence(command) private
- #refspec private
- #run_command(*command, dir: nil) private
- #verify(reference) private
- #with_path(&blk) private
Constructor Details
.new(path, uri, options = {}, revision = nil, git = nil) ⇒ GitProxy
Instance Attribute Details
#allow? ⇒ Boolean
(readonly, private)
# File 'lib/bundler/source/git/git_proxy.rb', line 314
def allow? allowed = @git ? @git.allow_git_ops? : true raise GitNotInstalledError.new if allowed && !Bundler.git_present? allowed end
#branch (rw)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 50
attr_accessor :path, :uri, :branch, :tag, :ref, :explicit_ref
#clone_needs_extra_fetch? ⇒ Boolean
(readonly, private)
[ GitHub ]
# File 'lib/bundler/source/git/git_proxy.rb', line 151
def clone_needs_extra_fetch? return true if path.exist? SharedHelpers.filesystem_access(path.dirname) do |p| FileUtils.mkdir_p(p) end command = ["clone", "--bare", "--no-hardlinks", "--quiet", *extra_clone_args, "--", configured_uri, path.to_s] command_with_no_credentials = check_allowed(command) Bundler::Retry.new("`#{command_with_no_credentials}`", [MissingGitRevisionError]).attempts do _, err, status = capture(command, nil) return extra_ref if status.success? if err.include?("Could not find remote branch") raise MissingGitRevisionError.new(command_with_no_credentials, nil, explicit_ref, credential_filtered_uri) else raise GitCommandError.new(command_with_no_credentials, path, err) end end end
#clone_needs_unshallow? ⇒ Boolean
(readonly, private)
[ GitHub ]
# File 'lib/bundler/source/git/git_proxy.rb', line 173
def clone_needs_unshallow? return false unless path.join("shallow").exist? return true if full_clone? @revision && @revision != head_revision end
#explicit_ref (rw)
[ GitHub ]
#full_clone? ⇒ Boolean
(readonly, private)
[ GitHub ]
# File 'lib/bundler/source/git/git_proxy.rb', line 408
def full_clone? depth.nil? end
#has_revision_cached? ⇒ Boolean
(readonly, private)
[ GitHub ]
#not_pinned? ⇒ Boolean
(readonly, private)
[ GitHub ]
#path (rw)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 50
attr_accessor :path, :uri, :branch, :tag, :ref, :explicit_ref
#pinned_to_full_sha? ⇒ Boolean
(readonly, private)
[ GitHub ]
# File 'lib/bundler/source/git/git_proxy.rb', line 237
def pinned_to_full_sha? ref =~ /\A\h{40}\z/ end
#ref (rw)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 50
attr_accessor :path, :uri, :branch, :tag, :ref, :explicit_ref
#revision (rw)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 65
def revision @revision ||= allowed_with_path { find_local_revision } end
#revision=(value) (rw)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 51
attr_writer :revision
#supports_cloning_with_no_tags? ⇒ Boolean
(readonly, private)
[ GitHub ]
#supports_fetching_unreachable_refs? ⇒ Boolean
(readonly, private)
[ GitHub ]
#supports_minus_c? ⇒ Boolean
(readonly, private)
[ GitHub ]
#tag (rw)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 50
attr_accessor :path, :uri, :branch, :tag, :ref, :explicit_ref
#uri (rw)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 50
attr_accessor :path, :uri, :branch, :tag, :ref, :explicit_ref
Instance Method Details
#allowed_with_path (private)
#capture(cmd, dir, ignore_err: false) (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 357
def capture(cmd, dir, ignore_err: false) SharedHelpers.with_clean_git_env do require "open3" out, err, status = Open3.capture3(*capture3_args_for(cmd, dir)) filtered_out = URICredentialsFilter.credential_filtered_string(out, uri) return [filtered_out, status] if ignore_err filtered_err = URICredentialsFilter.credential_filtered_string(err, uri) [filtered_out, filtered_err, status] end end
#capture3_args_for(cmd, dir) (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 370
def capture3_args_for(cmd, dir) return ["git", *cmd] unless dir if Bundler.feature_flag.bundler_3_mode? || supports_minus_c? ["git", "-C", dir.to_s, *cmd] else ["git", *cmd, { :chdir => dir.to_s }] end end
#check_allowed(command) (private)
# File 'lib/bundler/source/git/git_proxy.rb', line 332
def check_allowed(command) command_with_no_credentials = redact_and_check_presence(command) raise GitNotAllowedError.new(command_with_no_credentials) unless allow? command_with_no_credentials end
#checkout
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 90
def checkout return if has_revision_cached? Bundler.ui.info "Fetching #{credential_filtered_uri}" extra_fetch_needed = clone_needs_extra_fetch? unshallow_needed = clone_needs_unshallow? return unless extra_fetch_needed || unshallow_needed git_remote_fetch(unshallow_needed ? ["--unshallow"] : depth_args) end
#commit (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 219
def commit @commit ||= pinned_to_full_sha? ? ref : @revision end
#configured_uri (private)
Adds credentials to the ::Bundler::URI
# File 'lib/bundler/source/git/git_proxy.rb', line 296
def configured_uri if /https?:/.match?(uri) remote = Bundler::URI(uri) config_auth = Bundler.settings[remote.to_s] || Bundler.settings[remote.host] remote.userinfo ||= config_auth remote.to_s elsif File.exist?(uri) "file://#{uri}" else uri.to_s end end
#contains?(commit) ⇒ Boolean
# File 'lib/bundler/source/git/git_proxy.rb', line 75
def contains?(commit) allowed_with_path do result, status = git_null("branch", "--contains", commit, :dir => path) status.success? && result =~ /^\* (.*)$/ end end
#copy_to(destination, submodules = false)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 102
def copy_to(destination, submodules = false) unless File.exist?(destination.join(".git")) begin SharedHelpers.filesystem_access(destination.dirname) do |p| FileUtils.mkdir_p(p) end SharedHelpers.filesystem_access(destination) do |p| FileUtils.rm_rf(p) end git "clone", "--no-checkout", "--quiet", path.to_s, destination.to_s File.chmod(((File.stat(destination).mode | 0o777) & ~File.umask), destination) rescue Errno::EEXIST => e file_path = e. [%r{.*?((?:[a-zA-Z]:)?/.*)}, 1] raise GitError, "Bundler could not install a gem because it needs to " \ "create a directory, but a file exists - #{file_path}. Please delete " \ "this file and try again." end end git "fetch", "--force", "--quiet", *extra_fetch_args, :dir => destination if @commit_ref git "reset", "--hard", @revision, :dir => destination if submodules git_retry "submodule", "update", "--init", "--recursive", :dir => destination elsif Gem::Version.create(version) >= Gem::Version.create("2.9.0") inner_command = "git -C $toplevel submodule deinit --force $sm_path" git_retry "submodule", "foreach", "--quiet", inner_command, :dir => destination end end
#credential_filtered_uri (private)
Removes credentials from the ::Bundler::URI
# File 'lib/bundler/source/git/git_proxy.rb', line 310
def credential_filtered_uri URICredentialsFilter.credential_filtered_uri(uri) end
#current_branch
[ GitHub ]#depth (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 187
def depth return @depth if defined?(@depth) @depth = if !supports_fetching_unreachable_refs? nil elsif not_pinned? || pinned_to_full_sha? 1 elsif ref.include?("~") parsed_depth = ref.split("~").last parsed_depth.to_i + 1 end end
#depth_args (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 396
def depth_args return [] if full_clone? ["--depth", depth.to_s] end
#extra_clone_args (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 380
def extra_clone_args args = depth_args return [] if args.empty? args += ["--single-branch"] args.unshift("--no-tags") if # If there's a locked revision, no need to clone any specific branch # or tag, since we will end up checking out that locked revision # anyways. return args if @revision args += ["--branch", branch || tag] if branch || tag args end
#extra_fetch_args (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 402
def extra_fetch_args extra_args = [path.to_s, *depth_args] extra_args.push(@commit_ref) extra_args end
#extra_ref (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 180
def extra_ref return false if not_pinned? return true unless full_clone? ref.start_with?("refs/") end
#find_local_revision (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 275
def find_local_revision return head_revision if explicit_ref.nil? find_revision_for(explicit_ref) end
#find_revision_for(reference) (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 285
def find_revision_for(reference) verify(reference) rescue GitCommandError => e raise MissingGitRevisionError.new(e.command, path, reference, credential_filtered_uri) end
#full_version
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 86
def full_version @full_version ||= git_local("--version").sub(/git version\s*/, "").strip end
#fully_qualified_ref (private)
[ GitHub ]#git(*command, dir: nil) (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 255
def git(*command, dir: nil) run_command(*command, :dir => dir) do |unredacted_command| check_allowed(unredacted_command) end end
#git_local(*command, dir: nil) (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 261
def git_local(*command, dir: nil) run_command(*command, :dir => dir) do |unredacted_command| redact_and_check_presence(unredacted_command) end end
#git_null(*command, dir: nil) (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 241
def git_null(*command, dir: nil) check_allowed(command) capture(command, dir, :ignore_err => true) end
#git_remote_fetch(args) (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 135
def git_remote_fetch(args) command = ["fetch", "--force", "--quiet", "--no-tags", *args, "--", configured_uri, refspec].compact command_with_no_credentials = check_allowed(command) Bundler::Retry.new("`#{command_with_no_credentials}` at #{path}", [MissingGitRevisionError]).attempts do out, err, status = capture(command, path) return out if status.success? if err.include?("couldn't find remote ref") || err.include?("not our ref") raise MissingGitRevisionError.new(command_with_no_credentials, path, commit || explicit_ref, credential_filtered_uri) else raise GitCommandError.new(command_with_no_credentials, path, err) end end end
#git_retry(*command, dir: nil) (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 247
def git_retry(*command, dir: nil) command_with_no_credentials = check_allowed(command) Bundler::Retry.new("`#{command_with_no_credentials}` at #{dir || SharedHelpers.pwd}").attempts do git(*command, :dir => dir) end end
#head_revision (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 281
def head_revision verify("HEAD") end
#redact_and_check_presence(command) (private)
# File 'lib/bundler/source/git/git_proxy.rb', line 338
def redact_and_check_presence(command) raise GitNotInstalledError.new unless Bundler.git_present? require "shellwords" URICredentialsFilter.credential_filtered_string("git #{command.shelljoin}", uri) end
#refspec (private)
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 200
def refspec if commit @commit_ref = "refs/#{commit}-sha" return "#{commit}:#{@commit_ref}" end reference = fully_qualified_ref reference ||= if ref.include?("~") ref.split("~").first elsif ref.start_with?("refs/") ref else "refs/*" end "#{reference}:#{reference}" end
#run_command(*command, dir: nil) (private)
# File 'lib/bundler/source/git/git_proxy.rb', line 345
def run_command(*command, dir: nil) command_with_no_credentials = yield(command) out, err, status = capture(command, dir) raise GitCommandError.new(command_with_no_credentials, dir || SharedHelpers.pwd, err) unless status.success? Bundler.ui.warn err unless err.empty? out end
#verify(reference) (private)
[ GitHub ]#version
[ GitHub ]# File 'lib/bundler/source/git/git_proxy.rb', line 82
def version @version ||= full_version.match(/((\.?\d)).*/)[1] end