class Hashery::OpenCascade

OpenCascade is subclass of OpenHash. It differs in a few significant ways. The reason this class is called “cascade” is that every internal Hash is transformed into an OpenCascade dynamically upon access. This makes it easy to create “cascading” references.

h = { :x => { :y => { :z => 1 } } }
c = OpenCascade[h]
c.x.y.z  #=> 1

As soon as you access a node it automatically becomes an OpenCascade.

c = OpenCascade.new   #=> #<OpenCascade:0x7fac3680ccf0 {}>
c.r                   #=> #<OpenCascade:0x7fac368084c0 {}>
c.a.b                 #=> #<OpenCascade:0x7fac3680a4f0 {}>

But if you set a node, then that will be that value.

c.a.b = 4             #=> 4

To query a node without causing the auto-creation of an OpenCasade instance, use the ‘?`-mark.

c.a.z?                #=> nil

OpenCascade also transforms Hashes within Arrays.

h = { :x=>[ {:a=>1}, {:a=>2} ], :y=>1 }
c = OpenCascade[h]
c.x.first.a.assert == 1
c.x.last.a.assert  == 2

Finally, you can set call a private method via bang methods using the ‘!`-mark.

c = OpenCascade.new   #=> #<OpenCascade:0x7fac3680ccf0 {}>
c.each = 4
c.each! do |k,v|
  ...
end

c.x!(4).y!(3)         #=> #<OpenCascade:0x7fac3680ccf0 {:x=>4, :y=>3}>

Subclassing OpenCascade with cause the new subclass to become the class that is auto-created. If this is not the behavior desired, consider using delegation instead of subclassing.