Class: R10K::Module::Forge
Constant Summary
Constants included
from Logging
Logging::LOG_LEVELS
Instance Attribute Summary collapse
Attributes inherited from Base
#dirname, #name, #owner, #path, #title
Class Method Summary
collapse
Instance Method Summary
collapse
Methods included from Logging
debug_formatter, default_formatter, default_outputter, #logger, #logger_name, parse_level
Methods inherited from Base
#accept, #full_path
Constructor Details
#initialize(title, dirname, expected_version, environment = nil) ⇒ Forge
Returns a new instance of Forge.
35
36
37
38
39
40
41
42
43
|
# File 'lib/r10k/module/forge.rb', line 35
def initialize(title, dirname, expected_version, environment=nil)
super
@metadata_file = R10K::Module::MetadataFile.new(path + 'metadata.json')
@metadata = @metadata_file.read
@expected_version = expected_version || current_version || :latest
@v3_module = PuppetForge::V3::Module.new(:slug => @title)
end
|
Instance Attribute Details
Returns the value of attribute metadata.
26
27
28
|
# File 'lib/r10k/module/forge.rb', line 26
def metadata
@metadata
end
|
#v3_module ⇒ Object
Returns the value of attribute v3_module.
31
32
33
|
# File 'lib/r10k/module/forge.rb', line 31
def v3_module
@v3_module
end
|
Class Method Details
.implement?(name, args) ⇒ Boolean
15
16
17
|
# File 'lib/r10k/module/forge.rb', line 15
def self.implement?(name, args)
!!(name.match %r[\w+[/-]\w+]) && valid_version?(args)
end
|
.valid_version?(expected_version) ⇒ Boolean
19
20
21
|
# File 'lib/r10k/module/forge.rb', line 19
def self.valid_version?(expected_version)
expected_version == :latest || expected_version.nil? || SemanticPuppet::Version.valid?(expected_version)
end
|
Instance Method Details
#current_version ⇒ String
Also known as:
version
Returns The version of the currently installed module.
81
82
83
|
# File 'lib/r10k/module/forge.rb', line 81
def current_version
@metadata ? @metadata.version : nil
end
|
#deprecated? ⇒ Boolean
95
96
97
98
99
100
101
|
# File 'lib/r10k/module/forge.rb', line 95
def deprecated?
begin
@v3_module.fetch && @v3_module.has_attribute?('deprecated_at') && !@v3_module.deprecated_at.nil?
rescue Faraday::ResourceNotFound => e
raise PuppetForge::ReleaseNotFound, _("The module %{title} does not exist on %{url}.") % {title: @title, url: PuppetForge::V3::Release.conn.url_prefix}, e.backtrace
end
end
|
#exist? ⇒ Boolean
87
88
89
|
# File 'lib/r10k/module/forge.rb', line 87
def exist?
path.exist?
end
|
#expected_version ⇒ String
Returns The expected version that the module.
69
70
71
72
73
74
75
76
77
78
|
# File 'lib/r10k/module/forge.rb', line 69
def expected_version
if @expected_version == :latest
begin
@expected_version = @v3_module.current_release.version
rescue Faraday::ResourceNotFound => e
raise PuppetForge::ReleaseNotFound, _("The module %{title} does not exist on %{url}.") % {title: @title, url: PuppetForge::V3::Release.conn.url_prefix}, e.backtrace
end
end
@expected_version
end
|
#install ⇒ Object
Also known as:
upgrade
143
144
145
146
147
148
149
150
|
# File 'lib/r10k/module/forge.rb', line 143
def install
parent_path = @path.parent
if !parent_path.exist?
parent_path.mkpath
end
module_release = R10K::Forge::ModuleRelease.new(@title, expected_version)
module_release.install(@path)
end
|
#insync? ⇒ Boolean
91
92
93
|
# File 'lib/r10k/module/forge.rb', line 91
def insync?
status == :insync
end
|
#properties ⇒ Object
60
61
62
63
64
65
66
|
# File 'lib/r10k/module/forge.rb', line 60
def properties
{
:expected => expected_version,
:actual => current_version,
:type => :forge,
}
end
|
#reinstall ⇒ Object
158
159
160
161
|
# File 'lib/r10k/module/forge.rb', line 158
def reinstall
uninstall
install
end
|
#status ⇒ Symbol
Determine the status of the forge module.
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
# File 'lib/r10k/module/forge.rb', line 111
def status
if not self.exist?
return :absent
elsif not File.exist?(@path + 'metadata.json')
return :mismatched
end
if File.directory?(@path + '.git')
return :mismatched
end
@metadata = @metadata_file.read(@path + 'metadata.json')
if not @title.tr('/','-') == @metadata.full_module_name.tr('/','-')
return :mismatched
end
if expected_version && (expected_version != @metadata.version)
return :outdated
end
return :insync
end
|
#sync(opts = {}) ⇒ Object
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
# File 'lib/r10k/module/forge.rb', line 45
def sync(opts={})
if deprecated?
logger.warn "Puppet Forge module '#{@v3_module.slug}' has been deprecated, visit https://forge.puppet.com/#{@v3_module.slug.tr('-','/')} for more information."
end
case status
when :absent
install
when :outdated
upgrade
when :mismatched
reinstall
end
end
|
#uninstall ⇒ Object
154
155
156
|
# File 'lib/r10k/module/forge.rb', line 154
def uninstall
FileUtils.rm_rf full_path
end
|