ruck 0.2.0 → 0.3.0
Sign up to get free protection for your applications and to get access to all the features.
- data/LICENSE +21 -0
- data/README.markdown +146 -0
- data/Rakefile +11 -0
- data/VERSION +1 -1
- data/examples/ex01.rb +27 -0
- data/examples/ex02.rb +31 -0
- data/examples/ex03.rb +75 -0
- data/examples/ex04.rb +33 -0
- data/examples/ex05.rb +33 -0
- data/examples/ex06.rb +110 -0
- data/examples/space/media/Beep.wav +0 -0
- data/examples/space/media/Space.png +0 -0
- data/examples/space/media/Star.png +0 -0
- data/examples/space/media/Starfighter.bmp +0 -0
- data/examples/space/space.rb +307 -0
- data/lib/ruck.rb +4 -4
- data/lib/ruck/clock.rb +137 -0
- data/lib/ruck/event_clock.rb +39 -0
- data/lib/ruck/shred.rb +135 -0
- data/lib/ruck/shreduler.rb +149 -0
- data/ruck.gemspec +45 -8
- data/spec/clock_spec.rb +218 -0
- data/spec/shred_spec.rb +116 -0
- data/spec/shreduler_spec.rb +200 -0
- metadata +58 -12
- data/README +0 -48
- data/lib/ruck/shreduling.rb +0 -135
data/lib/ruck/shreduling.rb
DELETED
|
@@ -1,135 +0,0 @@
|
|
|
1
|
-
|
|
2
|
-
module Ruck
|
|
3
|
-
|
|
4
|
-
class Shred
|
|
5
|
-
attr_accessor :now
|
|
6
|
-
attr_accessor :finished
|
|
7
|
-
attr_accessor :name
|
|
8
|
-
|
|
9
|
-
def initialize(shreduler, now, name, &block)
|
|
10
|
-
@shreduler = shreduler
|
|
11
|
-
@now = now
|
|
12
|
-
@name = name
|
|
13
|
-
@block = block
|
|
14
|
-
@finished = false
|
|
15
|
-
end
|
|
16
|
-
|
|
17
|
-
def go(resume)
|
|
18
|
-
@resume = resume
|
|
19
|
-
|
|
20
|
-
# TODO
|
|
21
|
-
# I don't think this is the right place to catch errors.
|
|
22
|
-
# I've read the strangest memory errors after an exception
|
|
23
|
-
# is caught here; I have a feeling exceptions ought to be
|
|
24
|
-
# caught within the continuation itself.
|
|
25
|
-
begin
|
|
26
|
-
@block.call self
|
|
27
|
-
rescue => e
|
|
28
|
-
LOG.error "#{self} exited uncleanly:\n#{e}\n#{e.backtrace}"
|
|
29
|
-
end
|
|
30
|
-
|
|
31
|
-
@finished = true
|
|
32
|
-
@shreduler.remove_shred self
|
|
33
|
-
end
|
|
34
|
-
|
|
35
|
-
def yield(samples)
|
|
36
|
-
LOG.debug "shred #{self} yielding #{samples}"
|
|
37
|
-
@now += samples
|
|
38
|
-
callcc do |cont|
|
|
39
|
-
@block = cont # save where we are
|
|
40
|
-
@resume.call # jump back to shreduler
|
|
41
|
-
end
|
|
42
|
-
samples
|
|
43
|
-
end
|
|
44
|
-
|
|
45
|
-
def finish
|
|
46
|
-
@finished = true
|
|
47
|
-
@shreduler.remove_shred self
|
|
48
|
-
|
|
49
|
-
if @shreduler.current_shred == self
|
|
50
|
-
@resume.call # last save point
|
|
51
|
-
end
|
|
52
|
-
end
|
|
53
|
-
|
|
54
|
-
# shreds sort in order of position in time
|
|
55
|
-
def <=>(shred)
|
|
56
|
-
@now <=> shred.now
|
|
57
|
-
end
|
|
58
|
-
|
|
59
|
-
def to_s
|
|
60
|
-
"<Shred: #{@name}>"
|
|
61
|
-
end
|
|
62
|
-
end
|
|
63
|
-
|
|
64
|
-
class Shreduler
|
|
65
|
-
attr_reader :running
|
|
66
|
-
attr_reader :current_shred
|
|
67
|
-
attr_reader :shreds
|
|
68
|
-
attr_reader :now
|
|
69
|
-
|
|
70
|
-
def initialize
|
|
71
|
-
@shreds = []
|
|
72
|
-
@now = 0
|
|
73
|
-
@running = false
|
|
74
|
-
end
|
|
75
|
-
|
|
76
|
-
def spork(name = "", &shred_block)
|
|
77
|
-
shred = Shred.new(self, @now, name, &shred_block)
|
|
78
|
-
LOG.debug "Adding shred \"#{shred.name}\" at #{@now}"
|
|
79
|
-
@shreds << shred
|
|
80
|
-
shred
|
|
81
|
-
end
|
|
82
|
-
|
|
83
|
-
def remove_shred(shred)
|
|
84
|
-
LOG.debug "Removing shred \"#{shred.name}\" at #{@now}"
|
|
85
|
-
@shreds.delete shred
|
|
86
|
-
end
|
|
87
|
-
|
|
88
|
-
def next_shred
|
|
89
|
-
@shreds.min # furthest behind (Shred#<=> uses Shred's current time)
|
|
90
|
-
end
|
|
91
|
-
|
|
92
|
-
# called when shreds allow time to pass
|
|
93
|
-
# a convenient method to override
|
|
94
|
-
def sim_to(new_now)
|
|
95
|
-
@now = new_now
|
|
96
|
-
end
|
|
97
|
-
|
|
98
|
-
def invoke_shred(shred)
|
|
99
|
-
# execute shred, saving this as the resume point
|
|
100
|
-
LOG.debug "resuming shred #{@current_shred} at #{now}"
|
|
101
|
-
@current_shred = shred
|
|
102
|
-
callcc { |cont| @current_shred.go(cont) }
|
|
103
|
-
LOG.debug "back to run loop"
|
|
104
|
-
end
|
|
105
|
-
|
|
106
|
-
# invokes the next shred, simulates to the new VM time, then returns
|
|
107
|
-
def run_one
|
|
108
|
-
shred = next_shred
|
|
109
|
-
|
|
110
|
-
sim_to(shred.now)
|
|
111
|
-
|
|
112
|
-
invoke_shred(shred)
|
|
113
|
-
|
|
114
|
-
if @current_shred.finished
|
|
115
|
-
LOG.debug "#{shred} finished"
|
|
116
|
-
remove_shred(shred)
|
|
117
|
-
end
|
|
118
|
-
end
|
|
119
|
-
|
|
120
|
-
# ruck main loop
|
|
121
|
-
# executes all shreds and synthesizes audio
|
|
122
|
-
# until all shreds exit
|
|
123
|
-
def run
|
|
124
|
-
LOG.debug "shreduler starting"
|
|
125
|
-
@running = true
|
|
126
|
-
|
|
127
|
-
while @shreds.length > 0
|
|
128
|
-
run_one
|
|
129
|
-
end
|
|
130
|
-
|
|
131
|
-
@running = false
|
|
132
|
-
end
|
|
133
|
-
end
|
|
134
|
-
|
|
135
|
-
end
|