Module: RightConf::Configurator

Includes:
ProgressReporter
Included in:
BuildConfigurator, BundlerConfigurator, CassandraConfigurator, ExecuteConfigurator, GitRepoConfigurator, MercurialConfigurator, PackagesConfigurator, PassengerConfigurator, RubyConfigurator
Defined in:
lib/rconf/configurator.rb

Overview

Configurator mixin, defines DSL and common validation method

Defined Under Namespace

Modules: ClassMethods

Class Method Summary collapse

Instance Method Summary collapse

Methods included from ProgressReporter

report_to_file, report_to_stdout

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(meth, *args) ⇒ Object (protected)

DSL implementation, set settings value if arguments, get it otherwise.

Parameters

meth(Symbol)

Method symbol

args(Array)

List of arguments

Return

res(Object)

Configuration setting value or setter return value if arguments



180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
 
# File 'lib/rconf/configurator.rb', line 180

def method_missing(meth, *args)
  num_args = args.length
  res = nil
  if num_args > 0
    meth = $1.to_sym unless (meth.to_s =~ /(.+)=$/).nil?
    value = num_args == 1 ? args[0] : args
    method_name = meth.id2name
    if self.public_methods.include?("#{method_name}=")
      res = self.send("#{method_name}=", value)
    else
      res = @settings_values[meth.to_s] = value
    end
  end
  res || @settings_values[meth.to_s]
end

Class Method Details

.included(base) ⇒ Object

Extend base class with ClassMethods module methods

Parameters

base(Object)

Object including module



81
82
83
 
# File 'lib/rconf/configurator.rb', line 81

def self.included(base)
  base.__send__(:extend, ClassMethods)
end

Instance Method Details

#[](config_option) ⇒ Object

Get value of configuration option

Parameters

config_option(Symbol)

Configuration option to return

Returns

value

Value of configuration option if there is one

nil

Otherwise



165
166
167
 
# File 'lib/rconf/configurator.rb', line 165

def [](config_option)
  @settings_values[config_option.to_s]
end

#check ⇒ Object

Check system to determine whether configurator needs to run

Return

true

If configurator needs to run

false

Otherwise



114
115
116
 
# File 'lib/rconf/configurator.rb', line 114

def check
  Platform.dispatch { :check }
end

#post_process ⇒ Object

Called even if configuration is already done for steps that must always happen, do nothing by default

Return

true

Always return true



143
144
145
 
# File 'lib/rconf/configurator.rb', line 143

def post_process
  true
end

#run(*args) ⇒ Object

Run configurator for current platform

Parameters

args

Pass-through arguments, given to platform specific implementation

Return

true

Always return true



125
126
127
128
129
130
131
132
133
134
135
136
 
# File 'lib/rconf/configurator.rb', line 125

def run(*args)
    key = "#{self.class.key}-#{@index}"
    sha = Profile.configurator_signature(key)
    sig = signature
    must_configure = Profile.force_reconfigure?
    if !must_configure && (only_if.nil? || instance_eval(only_if))
      must_configure = (Profile.force_check? || sha != sig) && !check
    end
    Platform.dispatch(*args) { :run } if must_configure
    Profile.set_configurator_signature(key, sig) unless aborting
  true
end

#signature ⇒ Object

Calculate unique SHA for current settings

Return

sha(String)

SHA for current settings



151
152
153
154
155
 
# File 'lib/rconf/configurator.rb', line 151

def signature
  blob = VERSION
  blob = @settings_values.inject(blob) { |b, (k, v)| b += "#{k}:#{v};" } if @settings_values
  sha = Digest::SHA1.hexdigest(blob)
end

#validate ⇒ Object

Check whether configurator has values for all required settings

Return

nil

If settings are valid for this configurator

error(String)

Error message otherwise



90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/rconf/configurator.rb', line 90

def validate
  @settings_values.merge!(OverridesLanguage.overrides_for(self.class.key.to_s))
  if e = OverridesLanguage.parse_error
    error = "Could not load overrides file '#{OverridesLanguage::OVERRIDES_FILE}' (#{e.message})"
  else
    required = self.class.all_settings.select { |s| s[:options][:required] }.map { |s| s[:name] }
    return nil unless required
    missing = required.select { |s| !@settings_values.include?(s) }
    error = case missing.size
            when 0 then nil
            when 1 then "Required setting #{missing.first} is "
            else
              "Required settings #{missing.join(', ')} are "
            end
    error += "missing for configuration section '#{self.class.key}'" if error
  end
  error
end