Class: Safe::SafeHash
- Inherits:
-
Object
- Object
- Safe::SafeHash
- Extended by:
- Forwardable
- Defined in:
- lib/safestruct/safe_hash.rb
Class Method Summary collapse
-
.build_class(klass_key, klass_value) ⇒ Object
note: need to create new class!! for every safe hash make klass_key class and klass_value class into class instance variables that can get used by zero self.new returns a Hash.new/SafeHash.new like object.
- .debug=(value) ⇒ Object
- .debug? ⇒ Boolean
-
.klass_name ⇒ Object
let’s you configure the class name used for auto-generation class constants e.g.
- .klass_name=(value) ⇒ Object
- .new_zero ⇒ Object
- .zero ⇒ Object
Instance Method Summary collapse
- #==(other) ⇒ Object (also: #eql?)
- #[](key) ⇒ Object
- #[]=(key, value) ⇒ Object
- #freeze ⇒ Object
-
#initialize ⇒ SafeHash
constructor
A new instance of SafeHash.
- #zero? ⇒ Boolean
Constructor Details
#initialize ⇒ SafeHash
Returns a new instance of SafeHash.
102 103 104 105 |
# File 'lib/safestruct/safe_hash.rb', line 102 def initialize ## todo/check: if hash works if value is a (nested) hash @table = {} end |
Class Method Details
.build_class(klass_key, klass_value) ⇒ Object
note: need to create new class!! for every safe hash
make klass_key class and
klass_value class into class instance variables
that can get used by zero
self.new returns a Hash.new/SafeHash.new like object
26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 |
# File 'lib/safestruct/safe_hash.rb', line 26 def self.build_class( klass_key, klass_value ) ## note: care for now only about value type / class ## note: keep a class cache cache = @@cache ||= {} cache_all_values = cache[ klass_key ] ||= {} klass = cache_all_values[ klass_value ] if debug? puts "[debug] SafeHash - build_class( klass_key, klass_value ):" pp klass_key pp klass_key.to_s ## note: for "anonymous" class something like #<Class:> pp klass_value pp klass_value.to_s ## note: for "anonymous" class something like #<Class:> end if klass.nil? if debug? puts "[debug] SafeHash - build_class new class (no cache hit)" end klass = Class.new( SafeHash ) klass.define_singleton_method( :klass_key ) do @klass_key ||= klass_key end klass.define_singleton_method( :klass_value ) do @klass_value ||= klass_value end ### was: - NOT working for "anonymous" classes e.g. klass_value.to_s starting with #<Class:> # klass.class_eval( <<RUBY ) # def self.klass_key # @klass_key ||= #{klass_key} # end # def self.klass_value # @klass_value ||= #{klass_value} # end # RUBY ## add to cache for later (re)use cache[ klass_key ][ klass_value ] = klass ## note: also add a Constant to Safe for easy debugging and (re)use - will "auto"name class class_name = "#{klass_name}" key_name = klass_key.name key_name = key_name.sub( /\bSafe::/, '' ) ## remove safe module from name if present key_name = key_name.gsub( '::', '' ) ## remove module separator if present value_name = klass_value.name value_name = value_name.sub( /\bSafe::/, '' ) ## remove safe module from name if present value_name = value_name.gsub( '::', '' ) ## remove module separator if present class_name << "‹#{key_name}→#{value_name}›" if debug? puts "[debug] SafeHash - class_name >#{class_name}<" end Safe.const_set( class_name, klass ) else if debug? puts "[debug] SafeHash - build_class bingo!! (re)use cached class:" pp klass end end klass end |
.debug=(value) ⇒ Object
8 |
# File 'lib/safestruct/safe_hash.rb', line 8 def self.debug=(value) @debug = value; end |
.debug? ⇒ Boolean
7 |
# File 'lib/safestruct/safe_hash.rb', line 7 def self.debug?() @debug ||= false; end |
.klass_name ⇒ Object
let’s you configure the class name used for auto-generation class constants
e.g. use SafeHash.klass_name = 'Mapping' to rename from (default) 'Hash'
12 |
# File 'lib/safestruct/safe_hash.rb', line 12 def self.klass_name() @@klass_name ||= 'Hash'; end |
.klass_name=(value) ⇒ Object
13 |
# File 'lib/safestruct/safe_hash.rb', line 13 def self.klass_name=(value) @@klass_name = value; end |
.new_zero ⇒ Object
96 |
# File 'lib/safestruct/safe_hash.rb', line 96 def self.new_zero() new; end |
.zero ⇒ Object
97 |
# File 'lib/safestruct/safe_hash.rb', line 97 def self.zero() @zero ||= new_zero.freeze; end |
Instance Method Details
#==(other) ⇒ Object Also known as: eql?
113 114 115 116 117 118 119 |
# File 'lib/safestruct/safe_hash.rb', line 113 def ==( other ) if other.is_a?( self.class ) ## note: must be same hash (table) class @table == other.instance_variable_get( '@table' ) ## compare "wrapped" hash else false end end |
#[](key) ⇒ Object
129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 |
# File 'lib/safestruct/safe_hash.rb', line 129 def [](key) item = @table[ key ] if item.nil? ## pp self.class.klass_value ## pp self.class.klass_value.zero ##### # todo/check: # add zero to hash on lookup (increases size/length) # why? why not? if self.class.klass_value.respond_to?( :new_zero ) ## note: use a dup(licated) unfrozen copy of the zero object ## changes to the object MUST be possible (new "empty" modifable object expected) item = @table[ key ] = self.class.klass_value.new_zero else # assume value semantics e.g. Integer, Bool, etc. zero values gets replaced ## puts "use value semantics" item = @table[ key ] = self.class.klass_value.zero end end item end |
#[]=(key, value) ⇒ Object
125 126 127 |
# File 'lib/safestruct/safe_hash.rb', line 125 def []=(key, value) @table[key] = value end |
#freeze ⇒ Object
107 108 109 110 111 |
# File 'lib/safestruct/safe_hash.rb', line 107 def freeze super @table.freeze ## note: pass on freeze to "wrapped" hash self # return reference to self end |
#zero? ⇒ Boolean
99 |
# File 'lib/safestruct/safe_hash.rb', line 99 def zero?() self == self.class.zero; end |