module Innate::Traited
Traited helps you doing configuration similar to class variables.
It's built on a simple Hash, where keys are objects and the values the configuration. By using {Traited#ancestral_trait} you will get nicely inherited configuration, where keys later in the ancestors will take precedence.
@example usage
class Foo include Innate::Traited trait :hello => 'Hello' def initialize trait :hello => 'World!' end def show [class_trait[:hello], trait[:hello], ancestral_trait[:hello]] end end Foo.trait[:hello] # => "Hello" foo = Foo.new foo.trait[:hello] # => "World!" foo.show # => ["Hello", "World!", "World!"]
Constants
- ANCESTRAL_VALUES
Public Class Methods
included(into)
click to toggle source
# File lib/innate/traited.rb, line 31 def self.included(into) into.extend(self) end
Public Instance Methods
ancestral_trait()
click to toggle source
Builds a trait from all the ancestors, closer ancestors overwrite distant ancestors
@example
class Foo include Innate::Traited trait :one => :eins, :first => :erstes end class Bar < Foo trait :two => :zwei end class Foobar < Bar trait :three => :drei, :first => :overwritten end Foobar.ancestral_trait # => { :three => :drei, :two => :zwei, :one => :eins, :first => :overwritten }
# File lib/innate/traited.rb, line 67 def ancestral_trait klass = self.kind_of?(Module) ? self : self.class ANCESTRAL_TRAITS[klass] ||= each_ancestral_trait({}){|hash, trait| hash.update(trait) } end
ancestral_trait_values(key)
click to toggle source
# File lib/innate/traited.rb, line 73 def ancestral_trait_values(key) klass = self.kind_of?(Module) ? self : self.class cache = ANCESTRAL_VALUES[klass] ||= {} cache[key] ||= each_ancestral_trait([]){|array, trait| array << trait[key] if trait.key?(key) } end
class_trait()
click to toggle source
trait for self.class if we are an instance
# File lib/innate/traited.rb, line 88 def class_trait respond_to?(:ancestors) ? trait : self.class.trait end
each_ancestral_trait(obj) { |obj, TRAITS| ... }
click to toggle source
# File lib/innate/traited.rb, line 80 def each_ancestral_trait(obj) ancs = respond_to?(:ancestors) ? ancestors : self.class.ancestors ancs.unshift(self) ancs.reverse_each{|anc| yield(obj, TRAITS[anc]) if TRAITS.key?(anc) } obj end
trait(hash = nil)
click to toggle source
# File lib/innate/traited.rb, line 35 def trait(hash = nil) if hash TRAITS[self] ||= {} result = TRAITS[self].merge!(hash) ANCESTRAL_VALUES.clear ANCESTRAL_TRAITS.clear result else TRAITS[self] || {} end end