iotas 0.0.2

data/spec/particle_spec.rb

@@ -0,0 +1,240 @@
+#! /usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+#
+
+require 'spec_helper'
+#
+describe Iotas::Particle do
+    #
+    it "payload manipulation" do
+        p = Iotas::Particle.new
+        #
+        p['key']=666
+        p['key'].should eql 666
+        p.data('key').should eql 666
+        p.get_data('key').should eql 666
+        #
+        p.set_data 'key', 69
+        p['key'].should eql 69
+        p.data('key').should eql 69
+        p.get_data('key').should eql 69
+    end
+    #
+    it "payload clone" do
+        p = Iotas::Particle.new
+        p['k00'] = { 'k0'=>0,'k1'=>1}
+        p['k11'] = [1,2,3]
+        o = Iotas::Particle.new
+        o.clone_data p
+        p['k00']=nil
+        p['k00'].should be_nil
+        o['k00']['k0'].should eql 0
+        o['k00']['k1'].should eql 1
+        p['k11']=nil
+        p['k11'].should be_nil
+        o['k11'][0].should eql 1
+        o['k11'][1].should eql 2
+        o['k11'][2].should eql 3
+    end
+    #
+    it "particle merge" do
+        p = Iotas::Particle.new
+        q = Iotas::Particle.new
+        o = Iotas::Particle.new
+        p.merge! q
+        p.merge! o
+        p.merged(0).should be q
+        p.merged(1).should be o
+        p.merged(2).should be_nil
+        p.merged_shift.should be q
+        p.merged(0).should be o
+        p.merged(1).should be_nil
+        p.merged_shift.should be o
+        p.merged(0).should be_nil
+        p.merge! q
+        p.merge! o
+        p.merged(0).should be q
+        p.merged(1).should be o
+        p.clear_merged!
+        p.merged(0).should be_nil
+    end
+    #
+    it "routing: add_dsts, next_dst and dst_routed!" do
+        p = Iotas::Particle.new
+        d0 = Iotas::Door.new 'door0', nil
+        d1 = Iotas::Door.new 'door1', nil
+        p.dst.should be_nil
+        p.next_dst.should be_nil
+        p.add_dsts 'some?where,room0/room1/door?action,room/door,door'
+        p.next_dst.should eql 'some?where'
+        p.dst_routed! d0
+        p.dst.should be d0
+        p.next_dst.should eql 'room0/room1/door?action'
+        p.dst_routed! d1
+        p.dst.should be d1
+        p.next_dst.should eql 'room/door'
+        p.dst_routed! nil
+        p.dst.should be_nil
+        p.next_dst.should eql 'door'
+    end
+    #
+    it "wrong path should raise exeption" do
+        p = Iotas::Particle.new
+        lambda { p.set_dst! 'action', '/room' }.should raise_error(Iotas::Exception)
+        lambda { p.set_dst! 'action', 'room/' }.should raise_error(Iotas::Exception)
+        lambda { p.set_dst! '', 'room/' }.should raise_error(Iotas::Exception)
+        lambda { p.set_dst! 'action', 'room//door' }.should raise_error(Iotas::Exception)
+        lambda { p.set_dst! ' ' }.should raise_error(Iotas::Exception)
+        lambda { p.set_dst! ' ', '' }.should raise_error(Iotas::Exception)
+        lambda { p.set_dst! 'f f' }.should raise_error(Iotas::Exception)
+        lambda { p.set_dst! '', ' d' }.should raise_error(Iotas::Exception)
+        lambda { p.set_dst! '' }.should raise_error(Iotas::Exception)
+        lambda { p.set_dst! '', '' }.should raise_error(Iotas::Exception)
+        lambda { p.set_dst! nil }.should raise_error(TypeError)
+        lambda { p.set_dst! 'action', nil }.should raise_error(NoMethodError)
+    end
+    #
+    it "routing: set_dst! and split_dst!" do
+        p = Iotas::Particle.new
+        d0 = Iotas::Door.new 'door0', nil 
+        #
+        p.set_dst! 'action', 'room0/room1/door'
+        p.split_dst!
+        p.room.should eql 'room0/room1'
+        p.door.should eql 'door'
+        p.action.should eql 'action'
+        #
+        p.set_dst! 'action', 'room/door'
+        p.split_dst!
+        p.room.should eql 'room'
+        p.door.should eql 'door'
+        p.action.should eql 'action'
+        #
+        p.set_dst! 'action', ''
+        p.split_dst!
+        p.room.should eql nil
+        p.door.should eql nil
+        p.action.should eql 'action'
+        #
+        p.set_dst! 'action'
+        p.split_dst!
+        p.room.should eql nil
+        p.door.should eql nil
+        p.action.should eql 'action'
+        #
+        p.clear_dsts!
+        p.add_dsts 'door?action,?action'
+        p.split_dst!
+        p.room.should eql nil
+        p.door.should eql 'door'
+        p.action.should eql 'action'
+        #
+        p.dst_routed! d0
+        #
+        p.dst.should be d0
+        p.split_dst!
+        p.room.should eql nil
+        p.door.should eql nil
+        p.action.should eql 'action'
+        #
+    end
+    #
+    it "routing: error!" do
+        p = Iotas::Particle.new
+        d = Iotas::Door.new 'door', nil
+        p.src = d
+        p.add_dsts 'door?action,?action'
+        p.next_dst.should eql 'door?action'
+        p.error! 'err_msg'
+        p[Iotas::FIELD_ERROR_MSG].should eql 'err_msg'
+        p.action.should eq Iotas::ACT_ERROR
+        p.dst.should be d
+    end
+    #
+    it "link fields and link value" do
+        p = Iotas::Particle.new
+        p['k0'] = 'v0'
+        p['k1'] = 'v1'
+        p['k2'] = 'v2'
+        p.set_link_fields 'k0,k2'
+        p.link_value.should eql 'v0v2'
+        p.set_link_fields 'k1,k0'
+        p.link_value.should eql 'v1v0'
+        p['k0']='vx'
+        p.link_value.should eql 'v1vx'
+    end
+    #
+    it "apply_link!" do
+        p = Iotas::Particle.new
+        p['k0'] = 'v0'
+        p['k1'] = 'v1'
+        p['k2'] = 'v2'
+        p.set_link_fields 'k0,k2'
+        p.add_dsts 'door?action,?action'
+        p.src.should be_nil
+        p.link_value.should eql 'v0v2'
+        p.next_dst.should eql 'door?action'
+        lnk = Iotas::Link.new('door0', 'door1?get,door2', 'k1', 'f0,f1', 'v0v1')
+        f = Fake.new 'fake', nil
+        lnk.door = f
+        p.apply_link! lnk
+        p.src.should be f
+        p.next_dst.should eql 'door1?get'
+        p.link_value.should eql 'v1'
+    end
+    #
+    it "particle->json->particle" do
+        s0 = Iotas::Spin.new 'top'
+        s1 = Iotas::Room.new 'room0', s0
+        s2 = Iotas::Room.new 'room1', s1
+        s3 = Iotas::Door.new 'doora', s2
+        s4 = Iotas::Door.new 'doorb', s1
+        p0 = Iotas::Particle.new
+        p0['k0'] = 'v0'
+        p0['k1'] = 'v1'
+        p0['k2'] = 'v2'
+        p0.src = s3
+        p0.set_link_fields 'k0,k2'
+        p0.add_dsts 'room0/room1/room2/doorX?myaction,door?action,?action'
+        p0.split_dst!
+        p1 = Iotas::Particle.new
+        p1['k3'] = 'v6'
+        p1['k4'] = 'v7'
+        p1['k5'] = 'v8'
+        p1.src = s3
+        p1.dst_routed! s4
+        p1.set_link_fields 'k5,k4,k3'
+        p1.add_dsts 'room0/room1/door?action,output?action'
+        p0.merge! p1
+        o = JSON.load( JSON.generate(p0) )
+        o['spin'] = s0
+        px = Iotas::Particle.json_create( o )
+        ((px.ts-p0.ts)<0.5).should be_true
+        px.src.should be s3
+        px.dst.should be_nil
+        px.room.should eql 'room0/room1/room2'
+        px.door.should eql 'doorX'
+        px.action.should eql 'myaction'
+        px.next_dst.should eql 'room0/room1/room2/doorX?myaction'
+        px.link_value.should eql 'v0v2'
+        px['k0'].should eql 'v0'
+        px['k1'].should eql 'v1'
+        px['k2'].should eql 'v2'
+        py = px.merged(0)
+        ((py.ts-p1.ts)<0.5).should be_true
+        py.src.should be s3
+        py.dst.should be s4
+        py.room.should be_nil
+        py.door.should be_nil
+        py.action.should be_nil
+        py.next_dst.should eql 'room0/room1/door?action'
+        py.link_value.should eql 'v8v7v6'
+        py['k3'].should eql 'v6'
+        py['k4'].should eql 'v7'
+        py['k5'].should eql 'v8'
+        JSON.generate(p0).should eql JSON.generate(px)
+    end
+    #
+end
+#
+# EOF

data/spec/room_spec.rb

@@ -0,0 +1,304 @@
+#! /usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+#
+
+require 'spec_helper'
+#
+describe Iotas::Room do
+    #
+    before (:all) do
+        @spin = Iotas::Spin.new 'dom0'
+    end
+    #
+    before(:each) do
+        @spin.clear!
+    end
+    #
+    it "add_iota and add_link correctly" do
+        r0 = Iotas::Room.new 'room0', @spin
+        d0 = Iotas::Door.new 'door0', r0
+        lambda { Iotas::Door.new('door0', r0) }.should raise_error(Iotas::Exception)
+        lambda { r0.add_iota Iotas::Door.new('door1', r0) }.should raise_error(Iotas::Exception)
+        r0.add_link Iotas::Link.new 'door0', 'somewhere'
+        lambda { r0.add_link(Iotas::Link.new('nowhere', 'somewhere')) }.should raise_error(Iotas::Exception)
+    end
+    #
+    it "start! and stop! should work" do
+        r0 = Iotas::Room.new 'room0', @spin
+        d0 = Fake.new 'fake', r0
+        d0.start.should be_nil
+        d0.stop.should be_nil
+        r0.start!
+        d0.start.should be_true
+        d0.stop.should be_nil
+        r0.stop!
+        d0.start.should be_true
+        d0.stop.should be_true
+    end
+    #
+    it "parent, spin and search_down should be ok" do
+        r0 = Iotas::Room.new 'r0', @spin
+        r1 = Iotas::Room.new 'r1', r0
+        r2 = Iotas::Room.new 'r2', r1
+        r3 = Iotas::Room.new 'r3', @spin
+        r4 = Iotas::Room.new 'r4', r3
+        r2.parent.should be r1
+        r1.parent.should be r0
+        r0.parent.should be @spin
+        r0.spin.should be @spin
+        r1.spin.should be @spin
+        r2.spin.should be @spin
+        r3.spin.should be @spin
+        @spin.search_down('dom0/r0/r1/r2').should be r2
+        r0.search_down('dom0/r0/r1/r2').should be r2
+        r1.search_down('dom0/r0/r1/r2').should be r2
+        r2.search_down('dom0/r0/r1/r2').should be r2
+        r1.search_down('dom0/r0/r1/r9').should be nil
+        r3.search_down('dom0/r0/r1/r2').should be nil
+        r4.search_down('dom0/r0/r1/r2').should be nil
+    end
+    #
+    it "route error: no source" do
+        room = Iotas::Room.new 'room', @spin
+        p = @spin.require_p Iotas::Particle
+        p.set_dst! 'get', 'room/door'
+        room.send_p p
+        p.action.should eql Iotas::ACT_ERROR
+        p[Iotas::FIELD_ERROR_MSG].should eql Iotas::ERROR_ROUTE_NS
+        p.dst.should be room.spin
+    end
+    #
+    it "route error: no destination no links" do
+        room = Iotas::Room.new 'room', @spin
+        p = @spin.require_p Iotas::Particle
+        p.src = Fake.new 'fake', @spin
+        room.send_p p
+        p.action.should eql Iotas::ACT_ERROR
+        p[Iotas::FIELD_ERROR_MSG].should eql Iotas::ERROR_ROUTE_NDNL
+        p.dst.should be p.src
+    end
+    #
+    it "route error: top room, wrong room" do
+        room0 = Iotas::Room.new 'room0', @spin
+        room1 = Iotas::Room.new 'room1', room0
+        p = @spin.require_p Iotas::Particle
+        p.src = Fake.new 'fake', @spin
+        p.set_dst! 'get', 'noroom/door'
+        room1.send_p p
+        p.action.should eql Iotas::ACT_ERROR
+        p[Iotas::FIELD_ERROR_MSG].should eql Iotas::ERROR_ROUTE_TRWR
+        p.dst.should be p.src
+    end
+    #
+    it "route error: right room, wrong door" do
+        room = Iotas::Room.new 'room', @spin
+        p = @spin.require_p Iotas::Particle
+        p.src = Fake.new 'fake', @spin
+        p.set_dst! 'get', 'dom0/room/nodoor'
+        room.send_p p
+        p.action.should eql Iotas::ACT_ERROR
+        p[Iotas::FIELD_ERROR_MSG].should eql Iotas::ERROR_ROUTE_RRWD
+        p.dst.should be p.src
+    end
+    #
+    it "route error: right room, wrong door (bubble up)" do
+        room0 = Iotas::Room.new 'room0', @spin
+        room1 = Iotas::Room.new 'room1', room0
+        p = @spin.require_p Iotas::Particle
+        p.src = Fake.new 'fake', @spin
+        p.set_dst! 'get', 'dom0/room0/nodoor'
+        room1.send_p p
+        p.action.should eql Iotas::ACT_ERROR
+        p[Iotas::FIELD_ERROR_MSG].should eql Iotas::ERROR_ROUTE_RRWD
+        p.dst.should be p.src
+    end
+    #
+    it "routing success (direct)" do
+        room0 = Iotas::Room.new 'room0', @spin
+        door0 = Iotas::Door.new 'door0', room0
+        p = @spin.require_p Iotas::Particle
+        p.src = Fake.new 'fake', @spin
+        p.set_dst! 'get', 'door0'
+        room0.send_p p
+        p.action.should eql 'get'
+        p.dst.should be door0
+    end
+    #
+    it "routing success (bubble up the direct door)" do
+        room0 = Iotas::Room.new 'room0', @spin
+        room1 = Iotas::Room.new 'room1', room0
+        door0 = Iotas::Door.new 'door0', room0
+        p = @spin.require_p Iotas::Particle
+        p.src = Fake.new 'fake', @spin
+        p.set_dst! 'get', 'dom0/room0/door0'
+        room1.send_p p
+        p.action.should eql 'get'
+        p.dst.should be door0
+    end
+    #
+    it "route success: bubble up x2, drill down x3" do
+        room00 = Iotas::Room.new 'room00', @spin
+        room01 = Iotas::Room.new 'room01', room00
+        room02 = Iotas::Room.new 'room02', room01
+        door000 = Iotas::Door.new 'door000', room02
+        room10 = Iotas::Room.new 'room10', @spin
+        room11 = Iotas::Room.new 'room11', room10
+        p = @spin.require_p Iotas::Particle
+        p.src = Fake.new 'fake', @spin
+        p.set_dst! 'get', 'dom0/room00/room01/room02/door000'
+        room11.send_p p
+        p.action.should eql 'get'
+        p.dst.should be door000
+    end
+    #
+    it "route error: bubble up x2 drill down x2" do
+        room00 = Iotas::Room.new 'room00', @spin
+        room01 = Iotas::Room.new 'room01', room00
+        room02 = Iotas::Room.new 'room02', room01
+        door000 = Iotas::Door.new 'door000', room02
+        room10 = Iotas::Room.new 'room10', @spin
+        room11 = Iotas::Room.new 'room11', room10
+        p = @spin.require_p Iotas::Particle
+        p.src = Fake.new 'fake', @spin
+        p.set_dst! 'get', 'dom0/room00/room01/wrong/door000'
+        room11.send_p p
+        p.action.should eql Iotas::ACT_ERROR
+        p[Iotas::FIELD_ERROR_MSG].should eql Iotas::ERROR_ROUTE_DDWR
+        p.dst.should be p.src
+    end
+    #
+    it "routing success: no door name -> src" do
+        room0 = Iotas::Room.new 'room0', @spin
+        door0 = Iotas::Door.new 'door0', room0
+        p = @spin.require_p Iotas::Particle
+        p.src = door0
+        p.set_dst! 'get'
+        room0.send_p p
+        p.action.should eql 'get'
+        p.dst.should be door0
+    end
+    #
+    it "routing success: unconditional link" do
+        room0 = Iotas::Room.new 'room0', @spin
+        door0 = Iotas::Door.new 'door0', room0
+        door1 = Iotas::Door.new 'door1', room0
+        room0.add_link Iotas::Link.new('door0', 'door1')
+        p = @spin.require_p Iotas::Particle
+        door0.send_p p
+        p.action.should be_nil
+        p.dst.should be door1
+    end
+    #
+    it "routing success: conditional link" do
+        room0 = Iotas::Room.new 'room0', @spin
+        door0 = Iotas::Door.new 'door0', room0
+        door1 = Iotas::Door.new 'door1', room0
+        room0.add_link Iotas::Link.new('door0', 'door1', 'fields', 'f0,f1', 'v0v1')
+        p = @spin.require_p Iotas::Particle
+        p['f0']='v0'
+        p['f1']='v1'
+        door0.send_p p
+        p.action.should be_nil
+        p.src.should be door0
+        p.dst.should be door1
+    end
+    #
+    it "routing success: more then one matching link" do
+        room0 = Iotas::Room.new 'room0', @spin
+        door0 = Iotas::Door.new 'door0', room0
+        class Out < Iotas::Door
+            attr_reader :ps
+            def receive_p p
+                @ps||=[]
+                @ps << p
+            end
+        end
+        door1 = Out.new 'door1', room0
+        room0.add_link Iotas::Link.new('door0', 'door1')
+        room0.add_link Iotas::Link.new('door0', 'door1', 'fields', 'f0,f1', 'v0v1')
+        p = @spin.require_p Iotas::Particle
+        p['f0']='v0'
+        p['f1']='v1'
+        door0.send_p p
+        @spin.spin!
+        door1.ps.length.should eql 2
+        p0 = door1.ps[0]
+        p0.action.should be_nil
+        p0.src.should be door0
+        p0.dst.should be door1
+        p1 = door1.ps[1]
+        p1.action.should be_nil
+        p1.src.should be door0
+        p1.dst.should be door1
+        p1.should be p
+    end
+    #
+    it "system route error: system no destination" do
+        room0 = Iotas::Room.new 'room0', @spin
+        p = @spin.require_p Iotas::Particle
+        room0.send_sys_p p
+        p.action.should eql Iotas::ACT_ERROR
+        p[Iotas::FIELD_ERROR_MSG].should eql Iotas::ERROR_ROUTE_SND
+    end
+    #
+    it "system routing success: action only" do
+        room0 = Iotas::Room.new 'room0', @spin
+        p = @spin.require_p Iotas::Particle
+        p.set_dst! Iotas::SYS_ACT_ADD_LINK
+        room0.send_sys_p p
+        p.action.should eql Iotas::SYS_ACT_ADD_LINK
+        p.dst.should be room0.spin
+    end
+    #
+    it "system routing success" do
+        room0 = Iotas::Room.new 'room0', @spin
+        door0 = Iotas::Door.new 'door0', room0
+        p = @spin.require_p Iotas::Particle
+        p.set_dst! Iotas::SYS_ACT_ADD_LINK, 'dom0/room0/door0'
+        room0.send_sys_p p
+        p.action.should eql Iotas::SYS_ACT_ADD_LINK
+        p.dst.should be door0
+    end
+    #
+    it "SYS_ACT_ADD_LINK" do
+        room0 = Iotas::Room.new 'room0', @spin
+        door0 = Iotas::Door.new 'door0', room0
+        door1 = Iotas::Door.new 'door1', room0
+        p0 = @spin.require_p Iotas::Particle
+        p0.set_data Iotas::LNK_SRC, 'door0'
+        p0.set_data Iotas::LNK_DSTS, 'door1'
+        p0.set_data Iotas::LNK_FIELDS, 'fields'
+        p0.set_data Iotas::LNK_CONDF, 'f0,f1'
+        p0.set_data Iotas::LNK_CONDV, 'v0v1'
+        p0.set_dst! Iotas::SYS_ACT_ADD_LINK, room0.path
+        room0.send_sys_p p0
+        @spin.spin!
+        p = @spin.require_p Iotas::Particle
+        p['f0']='v0'
+        p['f1']='v1'
+        door0.send_p p
+        p.action.should be_nil
+        p.src.should be door0
+        p.dst.should be door1
+    end
+    #
+    it "room->json->room" do
+        r0 = Iotas::Room.new 'r0', @spin
+        r1 = Iotas::Room.new 'r1', r0
+        r2 = Iotas::Room.new 'r2', r1
+        r3 = Iotas::Room.new 'r3', r1
+        r4 = Iotas::Room.new 'r4', r3
+        d0 = Iotas::Door.new 'd0', r1
+        d1 = Iotas::Door.new 'd1', r1
+        d2 = Iotas::Door.new 'd2', r2
+        r1.add_link Iotas::Link.new('d0', 'd1', 'fields', 'f0,f1', 'v0v1')
+        r1.add_link Iotas::Link.new('d0', 'd2')
+        r1.add_link Iotas::Link.new('d1', 'd0')
+        r2.add_link Iotas::Link.new('d2', 'd1', 'fies', 'f5,f1', 'v9v1')
+        rx = Iotas::Room.json_create( JSON.load( JSON.generate(r0) ) )
+        JSON.generate(r0).should eql JSON.generate(rx)
+    end#
+    #
+end
+#
+# EOF

data/spec/spec_helper.rb

@@ -0,0 +1,38 @@
+#! /usr/bin/env ruby
+# -*- coding: UTF-8 -*-
+#
+begin
+    require 'simplecov'
+    SimpleCov.start do
+        add_filter 'spec'
+    end
+rescue LoadError
+end
+#
+require 'iotas'
+#
+class Fake < Iotas::Iota
+    attr_reader :p, :sp, :start, :stop
+    def process_p p
+        @p = p
+    end
+    def process_sys_p p
+        @sp = p
+    end
+    def send_p p
+        @p = p
+    end
+    def send_sys_p p
+        @sp = p
+    end
+    def add_iota p
+    end
+    def start!
+        @start=true
+    end
+    def stop!
+        @stop=true
+    end
+end
+#
+# EOF