class Bundler::Source::Git::GitProxy

The GitProxy is responsible to iteract with git repositories. All actions required by the Git source is encapsualted in this object.

Attributes

path[RW]
ref[RW]
revision[W]
uri[RW]

Public Class Methods

new(path, uri, ref, revision=nil, &allow) click to toggle source
# File lib/bundler/source/git/git_proxy.rb, line 12
def initialize(path, uri, ref, revision=nil, &allow)
  @path     = path
  @uri      = uri
  @ref      = ref
  @revision = revision
  @allow    = allow || Proc.new { true }
end

Public Instance Methods

branch() click to toggle source
# File lib/bundler/source/git/git_proxy.rb, line 24
def branch
  @branch ||= allowed_in_path do
    git("branch") =~ /^\* (.*)$/ && $1.strip
  end
end
checkout() click to toggle source
# File lib/bundler/source/git/git_proxy.rb, line 37
def checkout
  if path.exist?
    return if has_revision_cached?
    Bundler.ui.info "Updating #{uri}"
    in_path do
      git %Qfetch --force --quiet --tags #{uri_escaped} "refs/heads/*:refs/heads/*"|
    end
  else
    Bundler.ui.info "Fetching #{uri}"
    FileUtils.mkdir_p(path.dirname)
    clone_command = %Qclone #{uri_escaped} "#{path}" --bare --no-hardlinks|
    clone_command = "#{clone_command} --quiet" if Bundler.ui.quiet?
    git clone_command
  end
end
contains?(commit) click to toggle source
# File lib/bundler/source/git/git_proxy.rb, line 30
def contains?(commit)
  allowed_in_path do
    result = git_null("branch --contains #{commit}")
    $? == 0 && result =~ /^\* (.*)$/
  end
end
copy_to(destination, submodules=false) click to toggle source
# File lib/bundler/source/git/git_proxy.rb, line 53
def copy_to(destination, submodules=false)
  unless File.exist?(destination.join(".git"))
    FileUtils.mkdir_p(destination.dirname)
    FileUtils.rm_rf(destination)
    git %Qclone --no-checkout "#{path}" "#{destination}"|
    File.chmod((0777 & ~File.umask), destination)
  end

  Dir.chdir(destination) do
    git %Qfetch --force --quiet --tags "#{path}"|
    git "reset --hard #{@revision}"

    if submodules
      git "submodule update --init --recursive"
    end
  end
end
revision() click to toggle source
# File lib/bundler/source/git/git_proxy.rb, line 20
def revision
  @revision ||= allowed_in_path { git("rev-parse #{ref}").strip }
end

Private Instance Methods

allow?() click to toggle source
# File lib/bundler/source/git/git_proxy.rb, line 124
def allow?
  @allow.call
end
allowed_in_path() { || ... } click to toggle source
# File lib/bundler/source/git/git_proxy.rb, line 133
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
git(command, check_errors=true) click to toggle source
# File lib/bundler/source/git/git_proxy.rb, line 86
def git(command, check_errors=true)
  if allow?
    out = %x{git #{command}}

    if check_errors && $?.exitstatus != 0
      msg = "Git error: command `git #{command}` in directory #{Dir.pwd} has failed."
      msg << "\nIf this error persists you could try removing the cache directory '#{path}'" if path.exist?
      raise GitError, msg
    end
    out
  else
    raise GitError, "Bundler is trying to run a `git #{command}` at runtime. You probably need to run `bundle install`. However, "                              "this error message could probably be more useful. Please submit a ticket at http://github.com/carlhuda/bundler/issues "                              "with steps to reproduce as well as the following\n\nCALLER: #{caller.join("\n")}"
  end
end
git_null(command) click to toggle source

TODO: Do not rely on /dev/null. Given that open3 is not cross platform until Ruby 1.9.3, the best solution is to pipe to /dev/null if it exists. If it doesn't, everything will work fine, but the user will get the $stderr messages as well.

# File lib/bundler/source/git/git_proxy.rb, line 78
def git_null(command)
  if !Bundler::WINDOWS && File.exist?("/dev/null")
    git("#{command} 2>/dev/null", false)
  else
    git(command, false)
  end
end
has_revision_cached?() click to toggle source
# File lib/bundler/source/git/git_proxy.rb, line 103
def has_revision_cached?
  return unless @revision
  in_path { git("cat-file -e #{@revision}") }
  true
rescue GitError
  false
end
in_path(&blk) click to toggle source
# File lib/bundler/source/git/git_proxy.rb, line 128
def in_path(&blk)
  checkout unless path.exist?
  Dir.chdir(path, &blk)
end
uri_escaped() click to toggle source

Escape the URI for git commands

# File lib/bundler/source/git/git_proxy.rb, line 112
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