Class: R10K::Source::SVN

Inherits:
Base
  • Object
show all
Includes:
Logging, Util::Purgeable, 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

Defined Under Namespace

Classes: BranchName

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

formatter, included, level, level=, levels, #logger, #logger_name, outputter, parse_level

Methods included from Util::Purgeable

#logger, #pending_contents, #purge!, #stale_contents

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



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

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



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

def password
  @password
end

#remote ⇒ Object (readonly)

Since:

  • 1.3.0



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

def remote
  @remote
end

#svn_remote ⇒ Object (readonly)

Since:

  • 1.3.0



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

def svn_remote
  @svn_remote
end

#username ⇒ Object (readonly)

Since:

  • 1.3.0



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

def username
  @username
end

Instance Method Details

#current_contents ⇒ Object

Since:

  • 1.3.0



99
100
101
102
103
 
# File 'lib/r10k/source/svn.rb', line 99

def current_contents
  Dir.glob(File.join(@basedir, '*')).map do |fname|
    File.basename fname
  end
end

#desired_contents ⇒ Array<String>

Note:

This implements a required method for the Purgeable mixin

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

Returns:

  • (Array<String>)

Since:

  • 1.3.0



108
109
110
 
# File 'lib/r10k/source/svn.rb', line 108

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



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

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



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

def generate_environments

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

#managed_directory ⇒ Object

Since:

  • 1.3.0



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

def managed_directory
  @basedir
end