Class: R10K::Environment::Git

Inherits:
WithModules show all
Includes:
Logging, Util::Purgeable
Defined in:
lib/r10k/environment/git.rb

Overview

This class implements an environment based on a Git branch.

Since:

  • 1.3.0

Constant Summary

Constants included from Logging

Logging::LOG_LEVELS

Instance Attribute Summary collapse

Attributes inherited from WithModules

#moduledir

Attributes inherited from Base

#basedir, #dirname, #name, #path, #puppetfile, #puppetfile_name

Instance Method Summary collapse

Methods included from Util::Purgeable

#current_contents, #logger, #managed_directories, #pending_contents, #purge!, #stale_contents

Methods included from Logging

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

Methods inherited from WithModules

#accept, #add_module, #load_modules, #managed_directories, #modules, #purge_exclusions, #validate_no_module_conflicts

Methods inherited from Base

#accept, #generate_types!, #info, #modules, #purge_exclusions, #whitelist

Constructor Details

#initialize(name, basedir, dirname, options = {}) ⇒ Git

Initialize the given Git environment.

Parameters:

  • name (String) —

    The unique name describing this environment.

  • basedir (String) —

    The base directory where this environment will be created.

  • dirname (String) —

    The directory name for this environment.

  • options (Hash) (defaults to: {}) —

    An additional set of options for this environment.

  • options (String) (defaults to: {}) —

    :remote The URL to the remote git repository

  • options (String) (defaults to: {}) —

    :ref The git reference to use for this environment

Since:

  • 1.3.0



39
40
41
42
43
44
45
 
# File 'lib/r10k/environment/git.rb', line 39

def initialize(name, basedir, dirname, options = {})
  super
  @remote = options[:remote]
  @ref    = options[:ref]

  @repo = R10K::Git::StatefulRepository.new(@remote, @basedir, @dirname)
end

Instance Attribute Details

#ref ⇒ Object (readonly)

Since:

  • 1.3.0



23
24
25
 
# File 'lib/r10k/environment/git.rb', line 23

def ref
  @ref
end

#remote ⇒ Object (readonly)

Since:

  • 1.3.0



19
20
21
 
# File 'lib/r10k/environment/git.rb', line 19

def remote
  @remote
end

#repo ⇒ Object (readonly)

Since:

  • 1.3.0



28
29
30
 
# File 'lib/r10k/environment/git.rb', line 28

def repo
  @repo
end

Instance Method Details

#desired_contents ⇒ Array<String>

Note:

This implements a required method for the Purgeable mixin

Returns an array of the full paths to all the content being managed.

Returns:

  • (Array<String>)

Since:

  • 1.3.0



76
77
78
79
80
 
# File 'lib/r10k/environment/git.rb', line 76

def desired_contents
  desired = [File.join(@full_path, '.git')]
  desired += @repo.tracked_paths.map { |entry| File.join(@full_path, entry) }
  desired += super
end

#signature ⇒ String

Return a sting which uniquely identifies (per source) the current state of the environment.

Returns:

  • (String)

Since:

  • 1.3.0



67
68
69
 
# File 'lib/r10k/environment/git.rb', line 67

def signature
  @repo.head
end

#status ⇒ Object

Since:

  • 1.3.0



58
59
60
 
# File 'lib/r10k/environment/git.rb', line 58

def status
  @repo.status(@ref)
end

#sync ⇒ void

This method returns an undefined value.

Clone or update the given Git environment.

If the environment is being created for the first time, it will automatically update all modules to ensure that the environment is complete.

Since:

  • 1.3.0



54
55
56
 
# File 'lib/r10k/environment/git.rb', line 54

def sync
  @repo.sync(@ref)
end