Class: R10K::Source::SVN

Inherits:
Base
  • Object
show all
Includes:
Logging, Util::Setopts
Defined in:
lib/r10k/source/svn.rb

Overview

This class implements a source for SVN environments.

An SVN source generates environments by enumerating the branches and trunk for a given SVN remote. SVN repositories must conform to the conventional SVN repository structure with the directories trunk/, branches/, and optionally tags/ in the root of the repository. The trunk/ directory is specifically mapped to the production environment, branches are created as environments with the name of the given branch.

See Also:

Since:

  • 1.3.0

Constant Summary

Constants included from Logging

Logging::LOG_LEVELS

Instance Attribute Summary collapse

Attributes inherited from Base

#basedir, #name, #prefix

Instance Method Summary collapse

Methods included from Logging

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

Methods inherited from Base

#accept, #preload!

Constructor Details

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

Initialize the given source.

Parameters:

  • name (String) —

    The identifier for this source.

  • basedir (String) —

    The base directory where the generated environments will be created.

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

    An additional set of options for this source.

Options Hash (options):

  • :prefix (Boolean) —

    Whether to prefix the source name to the environment directory names. Defaults to false.

  • :remote (String) —

    The URL to the base directory of the SVN repository

  • :username (String) —

    The SVN username

  • :password (String) —

    The SVN password

Since:

  • 1.3.0



53
54
55
56
57
58
59
 
# File 'lib/r10k/source/svn.rb', line 53

def initialize(name, basedir, options = {})
  super

  setopts(options, {:remote => :self, :username => :self, :password => :self})
  @environments = []
  @svn_remote = R10K::SVN::Remote.new(@remote, :username => @username, :password => @password)
end

Instance Attribute Details

#password ⇒ Object (readonly)

Since:

  • 1.3.0



38
39
40
 
# File 'lib/r10k/source/svn.rb', line 38

def password
  @password
end

#remote ⇒ Object (readonly)

Since:

  • 1.3.0



23
24
25
 
# File 'lib/r10k/source/svn.rb', line 23

def remote
  @remote
end

#svn_remote ⇒ Object (readonly)

Since:

  • 1.3.0



28
29
30
 
# File 'lib/r10k/source/svn.rb', line 28

def svn_remote
  @svn_remote
end

#username ⇒ Object (readonly)

Since:

  • 1.3.0



33
34
35
 
# File 'lib/r10k/source/svn.rb', line 33

def username
  @username
end

Instance Method Details

#desired_contents ⇒ Array<String>

Note:

This is required by Util::Basedir

List all environments that should exist in the basedir for this source

Returns:

  • (Array<String>)

Since:

  • 1.3.0



94
95
96
 
# File 'lib/r10k/source/svn.rb', line 94

def desired_contents
  @environments.map {|env| env.dirname }
end

#environments ⇒ Array<R10K::Environment::SVN>

Enumerate the environments associated with this SVN source.

Returns:

Since:

  • 1.3.0



65
66
67
68
69
70
71
 
# File 'lib/r10k/source/svn.rb', line 65

def environments
  if @environments.empty?
    @environments = generate_environments()
  end

  @environments
end

#generate_environments ⇒ Array<R10K::Environment::SVN>

TODO:

respect environment name corrections

Generate a list of currently available SVN environments

Returns:

Since:

  • 1.3.0



80
81
82
83
84
85
86
87
88
89
 
# File 'lib/r10k/source/svn.rb', line 80

def generate_environments
  names_and_paths.map do |(branch, path)|
    options = {
      :remote   => path,
      :username => @username,
      :password => @password
    }
    R10K::Environment::SVN.new(branch.name, @basedir, branch.dirname, options)
  end
end