Module: Ox::HasAttrs

Included in:
Element, Instruct
Defined in:
lib/ox/hasattrs.rb

Overview

An Object that includes the HasAttrs module can have attributes which are a Hash of String values and either String or Symbol keys.

To access the attributes there are several options. One is to walk the attributes. The easiest for simple regularly formatted XML is to reference the attributes simply by name.

Instance Method Summary collapse

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(id, *args, &block) ⇒ Object

Handles the ‘easy’ API that allows navigating a simple XML by referencing attributes by name.

  • id [Symbol] element or attribute name

return [String|nil] the attribute value raise [NoMethodError] if no match is found

Raises:

  • (NoMethodError) 


38
39
40
41
42
43
44
45
 
# File 'lib/ox/hasattrs.rb', line 38

def method_missing(id, *args, &block)
  ids = id.to_s
  if instance_variable_defined?(:@attributes)
    return @attributes[id] if @attributes.has_key?(id)
    return @attributes[ids] if @attributes.has_key?(ids)
  end
  raise NoMethodError.new("#{ids} not found", name)
end

Instance Method Details

#[](attr) ⇒ Object

Returns the value of an attribute.

  • attr [Symbol|String] attribute name or key to return the value for



19
20
21
22
 
# File 'lib/ox/hasattrs.rb', line 19

def [](attr)
  return nil unless instance_variable_defined?(:@attributes) and @attributes.is_a?(Hash)
  @attributes[attr] or (attr.is_a?(String) ? @attributes[attr.to_sym] : @attributes[attr.to_s])
end

#[]=(attr, value) ⇒ Object

Adds or set an attribute of the Instruct.

  • attr [Symbol|String] attribute name or key

  • value [Object] value for the attribute



27
28
29
30
31
 
# File 'lib/ox/hasattrs.rb', line 27

def []=(attr, value)
  raise "argument to [] must be a Symbol or a String." unless attr.is_a?(Symbol) or attr.is_a?(String)
  @attributes = { } if !instance_variable_defined?(:@attributes) or @attributes.nil?
  @attributes[attr] = value.to_s
end

#attributes ⇒ Object

Returns all the attributes of the Instruct as a Hash. return [Hash] all attributes and attribute values.



12
13
14
15
 
# File 'lib/ox/hasattrs.rb', line 12

def attributes
  @attributes = { } if !instance_variable_defined?(:@attributes) or @attributes.nil?
  @attributes
end