class Bundler::Source::Git::GitProxy
object.
All actions required by the Git source is encapsualted in this
The GitProxy is responsible to iteract with git repositories.
def allow?
def allow? @allow.call end
def allowed_in_path
def allowed_in_path if allow? in_path { yield } else raise GitError, "The git source #{uri} is not yet checked out. Please run `bundle install` before trying to start your application" end end
def branch
def branch @branch ||= allowed_in_path do git("branch") =~ /^\* (.*)$/ && $1.strip end end
def checkout
def checkout if path.exist? return if has_revision_cached? Bundler.ui.info "Updating #{uri}" in_path do git %|fetch --force --quiet --tags #{uri_escaped} "refs/heads/*:refs/heads/*"| end else Bundler.ui.info "Fetching #{uri}" FileUtils.mkdir_p(path.dirname) clone_command = %|clone #{uri_escaped} "#{path}" --bare --no-hardlinks| clone_command = "#{clone_command} --quiet" if Bundler.ui.quiet? git clone_command end end
def contains?(commit)
def contains?(commit) allowed_in_path do result = git_null("branch --contains #{commit}") $? == 0 && result =~ /^\* (.*)$/ end end
def copy_to(destination, submodules=false)
def copy_to(destination, submodules=false) unless File.exist?(destination.join(".git")) FileUtils.mkdir_p(destination.dirname) FileUtils.rm_rf(destination) git %|clone --no-checkout "#{path}" "#{destination}"| File.chmod((0777 & ~File.umask), destination) end SharedHelpers.chdir(destination) do git %|fetch --force --quiet --tags "#{path}"| git "reset --hard #{@revision}" if submodules git "submodule update --init --recursive" end end end
def git(command, check_errors=true)
def git(command, check_errors=true) raise GitNotAllowedError.new(command) unless allow? raise GitNotInstalledError.new unless Bundler.git_present? Bundler::Retry.new("git #{command}").attempts do out = SharedHelpers.with_clean_git_env { %x{git #{command}} } raise GitCommandError.new(command, path) if check_errors && !$?.success? out end end
def git_null(command)
If it doesn't, everything will work fine, but the user
the best solution is to pipe to /dev/null if it exists.
Given that open3 is not cross platform until Ruby 1.9.3,
TODO: Do not rely on /dev/null.
def git_null(command) if !Bundler::WINDOWS && File.exist?("/dev/null") git("#{command} 2>/dev/null", false) else git(command, false) end end
def has_revision_cached?
def has_revision_cached? return unless @revision in_path { git("cat-file -e #{@revision}") } true rescue GitError false end
def in_path(&blk)
def in_path(&blk) checkout unless path.exist? SharedHelpers.chdir(path, &blk) end
def initialize(path, uri, ref, revision=nil, &allow)
def initialize(path, uri, ref, revision=nil, &allow) @path = path @uri = uri @ref = ref @revision = revision @allow = allow || Proc.new { true } end
def revision
def revision @revision ||= allowed_in_path { git("rev-parse #{ref}").strip } end
def uri_escaped
def uri_escaped if Bundler::WINDOWS # Windows quoting requires double quotes only, with double quotes # inside the string escaped by being doubled. '"' + uri.gsub('"') {|s| '""'} + '"' else # Bash requires single quoted strings, with the single quotes escaped # by ending the string, escaping the quote, and restarting the string. "'" + uri.gsub("'") {|s| "'\\''"} + "'" end end