class R10K::Git::Rugged::WorkingRepository

Public Class Methods

new(basedir, dirname) click to toggle source

@param basedir [String] The base directory of the Git repository @param dirname [String] The directory name of the Git repository

# File lib/r10k/git/rugged/working_repository.rb, line 14
def initialize(basedir, dirname)
  @path = Pathname.new(File.join(basedir, dirname))
end

Public Instance Methods

alternates() click to toggle source
# File lib/r10k/git/rugged/working_repository.rb, line 91
def alternates
  R10K::Git::Alternates.new(git_dir)
end
checkout(ref) click to toggle source

Check out the given Git ref

@param ref [String] The git reference to check out @return [void]

# File lib/r10k/git/rugged/working_repository.rb, line 58
def checkout(ref)
  sha = resolve(ref)

  if sha
    logger.debug2 { "Checking out ref '#{ref}' (resolved to SHA '#{sha}') in repository #{@path}" }
  else
    raise R10K::Git::GitError.new("Unable to check out unresolvable ref '#{ref}'", git_dir: git_dir)
  end

  with_repo do |repo|
    repo.checkout(sha)
    repo.reset(sha, :hard)
  end
end
clone(remote, opts = {}) click to toggle source

Clone this git repository

@param remote [String] The Git remote to clone @param opts [Hash]

@options opts [String] :ref The git ref to check out on clone @options opts [String] :reference A Git repository to use as an alternate object database

@return [void]

# File lib/r10k/git/rugged/working_repository.rb, line 27
def clone(remote, opts = {})
  logger.debug1 { "Cloning '#{remote}' into #{@path}" }

  # libgit2/rugged doesn't support cloning a repository and providing an
  # alternate object database, making the handling of :alternates a noop.
  # Unfortunately this means that this method can't really use alternates
  # and running the clone will duplicate all objects in the specified
  # repository. However alternate databases can be handled when an existing
  # repository is loaded, so loading a cloned repo will correctly use
  # alternate object database.
  options = {:credentials => credentials}
  options.merge!(:alternates => [File.join(opts[:reference], 'objects')]) if opts[:reference]
  @_rugged_repo = ::Rugged::Repository.clone_at(remote, @path.to_s, options)

  if opts[:reference]
    alternates << File.join(opts[:reference], 'objects')
  end

  if opts[:ref]
    # todo:  always check out something; since we're fetching a repository we
    # won't populate the working directory.
    checkout(opts[:ref])
  end
rescue Rugged::SshError, Rugged::NetworkError => e
  raise R10K::Git::GitError.new(e.message, :git_dir => git_dir, :backtrace => e.backtrace)
end
exist?() click to toggle source
# File lib/r10k/git/rugged/working_repository.rb, line 83
def exist?
  @path.exist?
end
fetch(remote = 'origin') click to toggle source
# File lib/r10k/git/rugged/working_repository.rb, line 73
def fetch(remote = 'origin')
  logger.debug1 { "Fetching remote '#{remote}' at #{@path}" }
  options = {:credentials => credentials}
  refspecs = ["+refs/heads/*:refs/remotes/#{remote}/*"]
  results = with_repo { |repo| repo.fetch(remote, refspecs, options) }
  report_transfer(results, remote)
rescue Rugged::SshError, Rugged::NetworkError => e
  raise R10K::Git::GitError.new(e.message, :git_dir => git_dir, :backtrace => e.backtrace)
end
git_dir() click to toggle source

@return [Pathname] The path to the Git repository inside of this directory

# File lib/r10k/git/rugged/working_repository.rb, line 8
def git_dir
  @path + '.git'
end
head() click to toggle source
# File lib/r10k/git/rugged/working_repository.rb, line 87
def head
  resolve('HEAD')
end
origin() click to toggle source
# File lib/r10k/git/rugged/working_repository.rb, line 95
def origin
  with_repo { |repo| repo.config['remote.origin.url'] }
end

Private Instance Methods

setup_rugged_repo() click to toggle source
# File lib/r10k/git/rugged/working_repository.rb, line 108
def setup_rugged_repo
  @_rugged_repo = ::Rugged::Repository.new(@path.to_s, :alternates => alternates.to_a)
end
with_repo() click to toggle source
# File lib/r10k/git/rugged/working_repository.rb, line 101
def with_repo
  if @_rugged_repo.nil? && git_dir.exist?
    setup_rugged_repo
  end
  super
end