summaryrefslogtreecommitdiffstats
path: root/lib/evendoors/particle.rb
blob: 7bec0e4a9aa27cbe5766c68788e101bfc6ff751a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
#! /usr/bin/env ruby
# -*- coding: UTF-8 -*-

#
module EvenDoors
    #
    class Particle
        #
        def initialize
            @ts = Time.now      # creation time
            @src = nil          # Spot.path where it's originated from
            @room = nil
            @door = nil         # Door where it's currently heading to
            @action = nil       # action to perform on the Door
            @dsts = []          # fifo of Spot.path where to travel to
            @link_fields = []   # the fields used to generate the link value
            @link_value = nil   # the value computed with the link_fields values extracted from the payload
                                # used for pearing in Door and linking in routing process
            @payload = {}       # the actual data carried by this particle
            @merged = []        # list of merged particles
        end
        #
        def reset!
            @ts = Time.now
            @src = @room = @door = @action = @link_value = nil
            @dsts.clear
            @link_fields.clear
            @payload.clear
            @merged.clear
        end
        #
        attr_accessor :src
        attr_reader :ts, :room, :door, :action, :link_value, :payload
        #
        # routing
        #
        def dst
            @dsts[0]
        end
        #
        def split_dst!
            p, @action = @dsts[0].split EvenDoors::ACT_SEP
            i = p.rindex EvenDoors::PATH_SEP
            if i.nil?
                @room = nil
                door_name = p
            else
                @room = p[0..i-1]
                door_name = p[i+1..-1]
            end
            door_name
        end
        #
        def dst_done! door
            @dsts.shift
            @door = door
        end
        #
        def error! e
            @action = EvenDoors::ACT_ERROR
            @door = @src
            @payload[EvenDoors::ERROR_FIELD]=e
        end
        #
        def clear_dsts!
            @dsts.clear
        end
        #
        def add_dsts paths
            paths.split(EvenDoors::LINK_SEP).each do |path|
                @dsts << path
            end
        end
        #
        def set_dst a, l=nil
            @room = nil
            @door = nil
            @action = nil
            clear_dsts!
            @dsts << ( l ? l.to_str : '' )+EvenDoors::ACT_SEP+a.to_str
        end
        #
        # data manipulation
        #
        def set_data k, v
            @payload[k] = v
            compute_link_value! if @link_fields.include? k
        end
        #
        def get_data k
            @payload[k]
        end
        alias :data :get_data
        #
        def data k
            @payload[k]
        end
        #
        def clone_data p
            @payload = p.payload.clone
        end
        #
        # link value and fields
        #
        def set_link_fields *args
            @link_fields.clear if not @link_fields.empty?
            args.compact!
            args.each do |lfs|
                lfs.split(',').each do |lf|
                    @link_fields << lf
                end
            end
            compute_link_value!
        end
        #
        def compute_link_value!
            @link_value = @link_fields.inject('') { |s,lf| s+=@payload[lf].to_s if @payload[lf]; s }
        end
        #
        # merge particles management
        #
        def merge! p
            @merged << p
        end
        #
        def merged i
            @merged[i]
        end
        #
        def merged_shift
            @merged.shift
        end
        #
    end
    #
end
#
# EOF