Module: BuildBox::Config::Options

Included in:
BuildBox::Config
Defined in:
lib/build_box/options/option.rb

Overview

Encapsulates logic for setting options.

Instance Method Summary collapse

Instance Method Details

#defaults ⇒ Hash

Get the defaults or initialize a new empty hash.

Examples:

Get the defaults.

options.defaults

Returns:

  • (Hash) —

    The default options.



14
15
16
 
# File 'lib/build_box/options/option.rb', line 14

def defaults
  @defaults ||= {}
end

#option(name, options = {}) ⇒ Object

Define a configuration option with a default.

Examples:

Define the option.

Options.option(:persist_in_safe_mode, :default => false)

Parameters:

  • name (Symbol) —

    The name of the configuration option.

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

    Extras for the option.

Options Hash (options):

  • :default (Object) —

    The default value.



27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
 
# File 'lib/build_box/options/option.rb', line 27

def option(name, options = {})
  defaults[name] = settings[name] = options[:default]

  class_eval "    def \#{name}\n      settings[\#{name.inspect}]\n    end\n\n    def \#{name}=(value)\n      settings[\#{name.inspect}] = value\n    end\n\n    def \#{name}?\n      \#{name}\n    end\n    \n    def reset_\#{name}\n      settings[\#{name.inspect}] = defaults[\#{name.inspect}]\n    end\n  RUBY\nend\n"

#reset ⇒ Hash

Reset the configuration options to the defaults.

Examples:

Reset the configuration options.

config.reset

Returns:

  • (Hash) —

    The defaults.



55
56
57
 
# File 'lib/build_box/options/option.rb', line 55

def reset
  settings.replace(defaults)
end

#settings ⇒ Hash

Get the settings or initialize a new empty hash.

Examples:

Get the settings.

options.settings

Returns:

  • (Hash) —

    The setting options.



65
66
67
 
# File 'lib/build_box/options/option.rb', line 65

def settings
  @settings ||= {}
end