Module: Test::Unit::Attribute::ClassMethods

Defined in:
lib/test/unit/attribute.rb,
lib/test/unit/attribute.rb

Constant Summary

@@attribute_observers =
StringifyKeyHash.new

Instance Method Summary collapse

Instance Method Details

#attribute(name, value) ⇒ void #attribute(name, value, *method_names) ⇒ void #attribute(name, value, options) ⇒ void #attribute(name, value, options, *method_names) ⇒ void

Set an attribute to test methods.

Overloads:

  • #attribute(name, value) ⇒ void

    This method returns an undefined value.

    Examples:

    attribute :speed, :slow
    def test_my_slow_method
      self[:speed] # => :slow
    end

    Parameters:

    • name (Object)

      the attribute name

    • value (Object)

      the attribute value

  • #attribute(name, value, *method_names) ⇒ void

    This method returns an undefined value.

    Examples:

    def test_my_slow_method1
      self[:speed] # => :slow
    end
    
    attribute :speed, :slow, :test_my_slow_method1, :test_my_slow_method2
    
    def test_my_slow_method2
      self[:speed] # => :slow
    end

    Parameters:

    • name (Object)

      the attribute name

    • value (Object)

      the attribute value

    • method_names (Array<Symbol, String>)

      the test method names set the attribute

  • #attribute(name, value, options) ⇒ void

    This method returns an undefined value.

    Examples:

    attribute :speed, :slow, keep: true
    def test_my_slow_method1
      self[:speed] # => :slow
    end
    
    def test_my_slow_method2
      self[:speed] # => :slow
    end

    Parameters:

    • name (Object)

      the attribute name

    • value (Object)

      the attribute value

    Options Hash (options):

    • :keep (Boolean)

      whether or not to set attribute to following test methods

  • #attribute(name, value, options, *method_names) ⇒ void

    This method returns an undefined value.

    Examples:

    def test_my_slow_method1
      self[:speed] # => :slow
    end
    
    # There are no valid options for now.
    attribute :speed, :slow, {}, :test_my_slow_method1
    
    def test_my_slow_method2
      self[:speed] # => nil
    end

    Parameters:

    • name (Object)

      the attribute name

    • value (Object)

      the attribute value

    • options (Hash)

      ignored

    • method_names (Array<Symbol, String>)

      the test method names set the attribute



116
117
118
119
120
121
122
123
124
125
126
127
128
# File 'lib/test/unit/attribute.rb', line 116

def attribute(name, value, options={}, *method_names)
  unless options.is_a?(Hash)
    method_names << options
    options = {}
  end
  if method_names.empty?
    current_attributes[name] = options.merge(:value => value)
  else
    method_names.each do |method_name|
      set_attributes(method_name, {name => value})
    end
  end
end

#attribute_observers(attribute_name) ⇒ Object



116
117
118
# File 'lib/test/unit/attribute.rb', line 116

def attribute_observers(attribute_name)
  @@attribute_observers[attribute_name]
end

#attributes(method_name) ⇒ Object



93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
# File 'lib/test/unit/attribute.rb', line 93

def attributes(method_name)
  attributes = attributes_table[method_name]
  ancestors.each do |ancestor|
    next if ancestor == self
    if ancestor.is_a?(Class) and ancestor < Test::Unit::Attribute
      parent_attributes = ancestor.attributes(method_name)
      if attributes
        attributes = (parent_attributes || {}).merge(attributes)
      else
        attributes = parent_attributes
      end
      break
    end
  end
  attributes || StringifyKeyHash.new
end

#attributes_tableObject



70
71
72
73
# File 'lib/test/unit/attribute.rb', line 70

def attributes_table
  @attributes_table ||= StringifyKeyHash.new
  super.merge(@attributes_table)
end

#current_attribute(name) ⇒ Object



66
67
68
# File 'lib/test/unit/attribute.rb', line 66

def current_attribute(name)
  current_attributes[name] || StringifyKeyHash.new
end

#current_attributesObject



62
63
64
# File 'lib/test/unit/attribute.rb', line 62

def current_attributes
  @current_attributes ||= StringifyKeyHash.new
end

#find_attribute(method_name, name, options = {}) ⇒ Object



114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
# File 'lib/test/unit/attribute.rb', line 114

def find_attribute(method_name, name)
  @attributes_table ||= StringifyKeyHash.new
  if @attributes_table.key?(method_name)
    attributes = @attributes_table[method_name]
    if attributes.key?(name)
      return attributes[name]
    end
  end

  return nil if self == TestCase

  @cached_parent_test_case ||= ancestors.find do |ancestor|
    ancestor != self and
      ancestor.is_a?(Class) and
      ancestor < Test::Unit::Attribute
  end

  @cached_parent_test_case.find_attribute(method_name, name)
end

#method_added(name) ⇒ Object



34
35
36
37
38
39
40
41
42
43
44
45
46
# File 'lib/test/unit/attribute.rb', line 34

def method_added(name)
  super
  return unless defined?(@current_attributes)

  attributes = {}
  kept_attributes = StringifyKeyHash.new
  @current_attributes.each do |attribute_name, attribute|
    attributes[attribute_name] = attribute[:value]
    kept_attributes[attribute_name] = attribute if attribute[:keep]
  end
  set_attributes(name, attributes)
  @current_attributes = kept_attributes
end

#register_attribute_observer(attribute_name, observer = Proc.new) ⇒ Object



111
112
113
114
# File 'lib/test/unit/attribute.rb', line 111

def register_attribute_observer(attribute_name, observer=Proc.new)
  @@attribute_observers[attribute_name] ||= []
  @@attribute_observers[attribute_name] << observer
end

#set_attributes(method_name, new_attributes) ⇒ Object



75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
# File 'lib/test/unit/attribute.rb', line 75

def set_attributes(method_name, new_attributes)
  return if new_attributes.empty?
  @attributes_table ||= StringifyKeyHash.new
  @attributes_table[method_name] ||= StringifyKeyHash.new
  current_attributes = @attributes_table[method_name]
  new_attributes.each do |key, value|
    observers = attribute_observers(key) || []
    observers.each do |observer|
      observer.call(self,
                    StringifyKeyHash.stringify(key),
                    (attributes(method_name) || {})[key],
                    value,
                    method_name)
    end
    current_attributes[key] = value
  end
end