Ordered Options

OrderedOptions inherits from Hash and provides dynamic accessor methods.

With a Hash, key-value pairs are typically managed like this:

h = {}
h[:boy] = 'John'
h[:girl] = 'Mary'
h[:boy]  # => 'John'
h[:girl] # => 'Mary'
h[:dog]  # => nil

Using OrderedOptions, the above code can be written as:

h = ActiveSupport::OrderedOptions.new
h.boy = 'John'
h.girl = 'Mary'
h.boy  # => 'John'
h.girl # => 'Mary'
h.dog  # => nil

To raise an exception when the value is blank, append a bang to the key name, like:

h.dog! # => raises KeyError: :dog is blank

Methods

Instance Public methods

[](key)

Also aliased as: _get
📝 Source code
# File activesupport/lib/active_support/ordered_options.rb, line 41
    def [](key)
      super(key.to_sym)
    end
🔎 See on GitHub

[]=(key, value)

📝 Source code
# File activesupport/lib/active_support/ordered_options.rb, line 37
    def []=(key, value)
      super(key.to_sym, value)
    end
🔎 See on GitHub

_get(key)

Alias for: []

dig(key, *identifiers)

📝 Source code
# File activesupport/lib/active_support/ordered_options.rb, line 45
    def dig(key, *identifiers)
      super(key.to_sym, *identifiers)
    end
🔎 See on GitHub

extractable_options?()

📝 Source code
# File activesupport/lib/active_support/ordered_options.rb, line 68
    def extractable_options?
      true
    end
🔎 See on GitHub

inspect()

📝 Source code
# File activesupport/lib/active_support/ordered_options.rb, line 72
    def inspect
      "#<#{self.class.name} #{super}>"
    end
🔎 See on GitHub

method_missing(name, *args)

📝 Source code
# File activesupport/lib/active_support/ordered_options.rb, line 49
    def method_missing(name, *args)
      name_string = +name.to_s
      if name_string.chomp!("=")
        self[name_string] = args.first
      else
        bangs = name_string.chomp!("!")

        if bangs
          self[name_string].presence || raise(KeyError.new(":#{name_string} is blank"))
        else
          self[name_string]
        end
      end
    end
🔎 See on GitHub

respond_to_missing?(name, include_private)

📝 Source code
# File activesupport/lib/active_support/ordered_options.rb, line 64
    def respond_to_missing?(name, include_private)
      true
    end
🔎 See on GitHub