Class: Aruba::BasicConfiguration

Inherits:
Object
  • Object
show all
Includes:
Contracts
Defined in:
lib/aruba/basic_configuration.rb,
lib/aruba/basic_configuration/option.rb

Overview

Basic Configuration

Direct Known Subclasses

Configuration

Defined Under Namespace

Classes: Option

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initializeBasicConfiguration

Create configuration



80
81
82
# File 'lib/aruba/basic_configuration.rb', line 80

def initialize
  initialize_configuration
end

Class Method Details

.known_optionsObject



14
15
16
# File 'lib/aruba/basic_configuration.rb', line 14

def known_options
  @known_options ||= {}
end

.option_accessor(name, type:, default: nil) ⇒ Object

Define an option reader and writer

Parameters:

  • name (Symbol)

    The name of the reader

  • [Class, (Hash)

    a customizable set of options

  • [Object] (Hash)

    a customizable set of options

Raises:

  • (ArgumentError)


48
49
50
51
52
53
54
55
56
57
58
59
# File 'lib/aruba/basic_configuration.rb', line 48

def option_accessor(name, type:, default: nil)
  raise ArgumentError, "Either use block or default value" if block_given? && default

  # Add writer
  add_option(name, block_given? ? yield(InConfigWrapper.new(known_options)) : default)

  Contract type => type
  define_method("#{name}=") { |v| find_option(name).value = v }

  # Add reader
  option_reader name, type: type
end

.option_reader(name, type:, default: nil) ⇒ Object

Define an option reader

Parameters:

  • name (Symbol)

    The name of the reader

  • [Class, (Hash)

    a customizable set of options

  • [Object] (Hash)

    a customizable set of options

Raises:

  • (ArgumentError)


28
29
30
31
32
33
34
35
# File 'lib/aruba/basic_configuration.rb', line 28

def option_reader(name, type:, default: nil)
  raise ArgumentError, "Either use block or default value" if block_given? && default

  add_option(name, block_given? ? yield(InConfigWrapper.new(known_options)) : default)

  Contract None => type
  define_method(name) { find_option(name).value }
end

Instance Method Details

#==(other) ⇒ Object



177
178
179
# File 'lib/aruba/basic_configuration.rb', line 177

def ==(other)
  local_options.values.map(&:value) == other.local_options.values.map(&:value)
end

#after(name) { ... } ⇒ Object

Define after-hook

Parameters:

  • name (Symbol, String)

    The name of the hook

Yields:

  • The code block which should be run. This is a configure time only option

Raises:

  • (ArgumentError)


144
145
146
147
148
149
150
151
# File 'lib/aruba/basic_configuration.rb', line 144

def after(name, &block)
  name = format("%s_%s", "after_", name.to_s).to_sym
  raise ArgumentError, "A block is required" unless block

  @hooks.append(name, block)

  self
end

#before(name) { ... } ⇒ Object

Define before-hook

Parameters:

  • name (Symbol, String)

    The name of the hook

Yields:

  • The code block which should be run. This is a configure time only option

Raises:

  • (ArgumentError)


112
113
114
115
116
117
118
119
# File 'lib/aruba/basic_configuration.rb', line 112

def before(name, &block)
  name = format("%s_%s", "before_", name.to_s).to_sym
  raise ArgumentError, "A block is required" unless block

  @hooks.append(name, block)

  self
end

#configure {|Configuration| ... } ⇒ Object

Yields:



87
88
89
# File 'lib/aruba/basic_configuration.rb', line 87

def configure
  yield self if block_given?
end

#make_copyObject

Make deep dup copy of configuration



97
98
99
100
101
102
103
# File 'lib/aruba/basic_configuration.rb', line 97

def make_copy
  obj = dup
  obj.local_options = Marshal.load(Marshal.dump(local_options))
  obj.hooks         = @hooks

  obj
end

#option?(name) ⇒ Boolean

Check if <name> is option

Parameters:

  • name (String, Symbol)

    The name of the option

Returns:

  • (Boolean)


173
174
175
# File 'lib/aruba/basic_configuration.rb', line 173

def option?(name)
  local_options.any? { |_, v| v.name == name.to_sym }
end

#resetObject

Reset configuration



92
93
94
# File 'lib/aruba/basic_configuration.rb', line 92

def reset
  initialize_configuration
end

#run_after_hook(name, context, *args) ⇒ Object

Run after-hook

Parameters:

  • name (Symbol, String)

    The name of the hook

  • context (Proc)

    The context a hook should run in

  • args (Array)

    Arguments for the run of hook



163
164
165
166
167
# File 'lib/aruba/basic_configuration.rb', line 163

def run_after_hook(name, context, *args)
  name = format("%s_%s", "after_", name.to_s).to_sym

  @hooks.execute(name, context, *args)
end

#run_before_hook(name, context, *args) ⇒ Object

Run before-hook

Parameters:

  • name (Symbol, String)

    The name of the hook

  • context (Proc)

    The context a hook should run in

  • args (Array)

    Arguments for the run of hook



131
132
133
134
135
# File 'lib/aruba/basic_configuration.rb', line 131

def run_before_hook(name, context, *args)
  name = format("%s_%s", "before_", name.to_s).to_sym

  @hooks.execute(name, context, *args)
end

#set_if_option(name, *args) ⇒ Object

Set if name is option



182
183
184
# File 'lib/aruba/basic_configuration.rb', line 182

def set_if_option(name, *args)
  public_send("#{name}=".to_sym, *args) if option? name
end