Class: R10K::Git::Rugged::WorkingRepository

Inherits:
BaseRepository show all
Defined in:
lib/r10k/git/rugged/working_repository.rb

Direct Known Subclasses

ThinRepository

Constant Summary

Constants included from Logging

Logging::LOG_LEVELS

Instance Attribute Summary

Attributes inherited from BaseRepository

#path

Instance Method Summary collapse

Methods inherited from BaseRepository

#branches, #ref_type, #resolve, #tags

Methods included from Logging

debug_formatter, default_formatter, default_outputter, #logger, #logger_name, parse_level

Constructor Details

#initialize(basedir, dirname) ⇒ WorkingRepository

Returns a new instance of WorkingRepository.

Parameters:

  • basedir (String) —

    The base directory of the Git repository

  • dirname (String) —

    The directory name of the Git repository



14
15
16
 
# File 'lib/r10k/git/rugged/working_repository.rb', line 14

def initialize(basedir, dirname)
  @path = Pathname.new(File.join(basedir, dirname))
end

Instance Method Details

#alternates ⇒ Object 



91
92
93
 
# File 'lib/r10k/git/rugged/working_repository.rb', line 91

def alternates
  R10K::Git::Alternates.new(git_dir)
end

#checkout(ref) ⇒ void

This method returns an undefined value.

Check out the given Git ref

Parameters:

  • ref (String) —

    The git reference to check out



58
59
60
61
62
63
64
65
66
67
68
69
70
71
 
# 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 = {}) ⇒ void

This method returns an undefined value.

Clone this git repository

Parameters:

  • remote (String) —

    The Git remote to clone

  • opts (Hash) (defaults to: {}) 


27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
# 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? ⇒ Boolean

Returns:

  • (Boolean) 


83
84
85
 
# File 'lib/r10k/git/rugged/working_repository.rb', line 83

def exist?
  @path.exist?
end

#fetch(remote = 'origin') ⇒ Object 



73
74
75
76
77
78
79
80
81
 
# 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 ⇒ Pathname

Returns The path to the Git repository inside of this directory.

Returns:

  • (Pathname) —

    The path to the Git repository inside of this directory



8
9
10
 
# File 'lib/r10k/git/rugged/working_repository.rb', line 8

def git_dir
  @path + '.git'
end

#head ⇒ Object 



87
88
89
 
# File 'lib/r10k/git/rugged/working_repository.rb', line 87

def head
  resolve('HEAD')
end

#origin ⇒ Object 



95
96
97
 
# File 'lib/r10k/git/rugged/working_repository.rb', line 95

def origin
  with_repo { |repo| repo.config['remote.origin.url'] }
end