eventmachine 1.0.0.beta.2-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (141) hide show
  1. data/.gitignore +16 -0
  2. data/Gemfile +1 -0
  3. data/README +81 -0
  4. data/Rakefile +11 -0
  5. data/docs/COPYING +60 -0
  6. data/docs/ChangeLog +211 -0
  7. data/docs/DEFERRABLES +246 -0
  8. data/docs/EPOLL +141 -0
  9. data/docs/GNU +281 -0
  10. data/docs/INSTALL +13 -0
  11. data/docs/KEYBOARD +42 -0
  12. data/docs/LEGAL +25 -0
  13. data/docs/LIGHTWEIGHT_CONCURRENCY +130 -0
  14. data/docs/PURE_RUBY +75 -0
  15. data/docs/RELEASE_NOTES +94 -0
  16. data/docs/SMTP +4 -0
  17. data/docs/SPAWNED_PROCESSES +148 -0
  18. data/docs/TODO +8 -0
  19. data/eventmachine.gemspec +33 -0
  20. data/examples/ex_channel.rb +43 -0
  21. data/examples/ex_queue.rb +2 -0
  22. data/examples/ex_tick_loop_array.rb +15 -0
  23. data/examples/ex_tick_loop_counter.rb +32 -0
  24. data/examples/helper.rb +2 -0
  25. data/ext/binder.cpp +124 -0
  26. data/ext/binder.h +46 -0
  27. data/ext/cmain.cpp +838 -0
  28. data/ext/ed.cpp +1884 -0
  29. data/ext/ed.h +418 -0
  30. data/ext/em.cpp +2348 -0
  31. data/ext/em.h +228 -0
  32. data/ext/eventmachine.h +123 -0
  33. data/ext/extconf.rb +157 -0
  34. data/ext/fastfilereader/extconf.rb +85 -0
  35. data/ext/fastfilereader/mapper.cpp +214 -0
  36. data/ext/fastfilereader/mapper.h +59 -0
  37. data/ext/fastfilereader/rubymain.cpp +127 -0
  38. data/ext/kb.cpp +79 -0
  39. data/ext/page.cpp +107 -0
  40. data/ext/page.h +51 -0
  41. data/ext/pipe.cpp +347 -0
  42. data/ext/project.h +155 -0
  43. data/ext/rubymain.cpp +1200 -0
  44. data/ext/ssl.cpp +460 -0
  45. data/ext/ssl.h +94 -0
  46. data/java/.classpath +8 -0
  47. data/java/.project +17 -0
  48. data/java/src/com/rubyeventmachine/EmReactor.java +571 -0
  49. data/java/src/com/rubyeventmachine/EmReactorException.java +40 -0
  50. data/java/src/com/rubyeventmachine/EventableChannel.java +69 -0
  51. data/java/src/com/rubyeventmachine/EventableDatagramChannel.java +189 -0
  52. data/java/src/com/rubyeventmachine/EventableSocketChannel.java +364 -0
  53. data/lib/em/buftok.rb +138 -0
  54. data/lib/em/callback.rb +26 -0
  55. data/lib/em/channel.rb +57 -0
  56. data/lib/em/connection.rb +569 -0
  57. data/lib/em/deferrable.rb +206 -0
  58. data/lib/em/file_watch.rb +54 -0
  59. data/lib/em/future.rb +61 -0
  60. data/lib/em/iterator.rb +270 -0
  61. data/lib/em/messages.rb +66 -0
  62. data/lib/em/process_watch.rb +44 -0
  63. data/lib/em/processes.rb +119 -0
  64. data/lib/em/protocols.rb +36 -0
  65. data/lib/em/protocols/header_and_content.rb +138 -0
  66. data/lib/em/protocols/httpclient.rb +268 -0
  67. data/lib/em/protocols/httpclient2.rb +590 -0
  68. data/lib/em/protocols/line_and_text.rb +125 -0
  69. data/lib/em/protocols/line_protocol.rb +28 -0
  70. data/lib/em/protocols/linetext2.rb +161 -0
  71. data/lib/em/protocols/memcache.rb +323 -0
  72. data/lib/em/protocols/object_protocol.rb +45 -0
  73. data/lib/em/protocols/postgres3.rb +247 -0
  74. data/lib/em/protocols/saslauth.rb +175 -0
  75. data/lib/em/protocols/smtpclient.rb +357 -0
  76. data/lib/em/protocols/smtpserver.rb +640 -0
  77. data/lib/em/protocols/socks4.rb +66 -0
  78. data/lib/em/protocols/stomp.rb +200 -0
  79. data/lib/em/protocols/tcptest.rb +53 -0
  80. data/lib/em/pure_ruby.rb +1013 -0
  81. data/lib/em/queue.rb +62 -0
  82. data/lib/em/spawnable.rb +85 -0
  83. data/lib/em/streamer.rb +130 -0
  84. data/lib/em/tick_loop.rb +85 -0
  85. data/lib/em/timers.rb +57 -0
  86. data/lib/em/version.rb +3 -0
  87. data/lib/eventmachine.rb +1548 -0
  88. data/lib/jeventmachine.rb +258 -0
  89. data/lib/rubyeventmachine.rb +2 -0
  90. data/setup.rb +1585 -0
  91. data/tasks/cpp.rake_example +77 -0
  92. data/tasks/doc.rake +30 -0
  93. data/tasks/package.rake +85 -0
  94. data/tasks/test.rake +6 -0
  95. data/tests/client.crt +31 -0
  96. data/tests/client.key +51 -0
  97. data/tests/test_attach.rb +136 -0
  98. data/tests/test_basic.rb +249 -0
  99. data/tests/test_channel.rb +64 -0
  100. data/tests/test_connection_count.rb +35 -0
  101. data/tests/test_defer.rb +49 -0
  102. data/tests/test_deferrable.rb +35 -0
  103. data/tests/test_epoll.rb +160 -0
  104. data/tests/test_error_handler.rb +35 -0
  105. data/tests/test_errors.rb +82 -0
  106. data/tests/test_exc.rb +55 -0
  107. data/tests/test_file_watch.rb +49 -0
  108. data/tests/test_futures.rb +198 -0
  109. data/tests/test_get_sock_opt.rb +30 -0
  110. data/tests/test_handler_check.rb +37 -0
  111. data/tests/test_hc.rb +190 -0
  112. data/tests/test_httpclient.rb +227 -0
  113. data/tests/test_httpclient2.rb +154 -0
  114. data/tests/test_inactivity_timeout.rb +50 -0
  115. data/tests/test_kb.rb +60 -0
  116. data/tests/test_ltp.rb +190 -0
  117. data/tests/test_ltp2.rb +317 -0
  118. data/tests/test_next_tick.rb +133 -0
  119. data/tests/test_object_protocol.rb +37 -0
  120. data/tests/test_pause.rb +70 -0
  121. data/tests/test_pending_connect_timeout.rb +48 -0
  122. data/tests/test_process_watch.rb +50 -0
  123. data/tests/test_processes.rb +128 -0
  124. data/tests/test_proxy_connection.rb +144 -0
  125. data/tests/test_pure.rb +134 -0
  126. data/tests/test_queue.rb +44 -0
  127. data/tests/test_running.rb +42 -0
  128. data/tests/test_sasl.rb +72 -0
  129. data/tests/test_send_file.rb +251 -0
  130. data/tests/test_servers.rb +76 -0
  131. data/tests/test_smtpclient.rb +83 -0
  132. data/tests/test_smtpserver.rb +85 -0
  133. data/tests/test_spawn.rb +322 -0
  134. data/tests/test_ssl_args.rb +79 -0
  135. data/tests/test_ssl_methods.rb +50 -0
  136. data/tests/test_ssl_verify.rb +82 -0
  137. data/tests/test_tick_loop.rb +59 -0
  138. data/tests/test_timers.rb +160 -0
  139. data/tests/test_ud.rb +36 -0
  140. data/tests/testem.rb +31 -0
  141. metadata +240 -0
@@ -0,0 +1,76 @@
1
+ # $Id$
2
+ #
3
+ # Author:: Francis Cianfrocca (gmail: blackhedd)
4
+ # Homepage:: http://rubyeventmachine.com
5
+ # Date:: 8 April 2006
6
+ #
7
+ # See EventMachine and EventMachine::Connection for documentation and
8
+ # usage examples.
9
+ #
10
+ #----------------------------------------------------------------------------
11
+ #
12
+ # Copyright (C) 2006-07 by Francis Cianfrocca. All Rights Reserved.
13
+ # Gmail: blackhedd
14
+ #
15
+ # This program is free software; you can redistribute it and/or modify
16
+ # it under the terms of either: 1) the GNU General Public License
17
+ # as published by the Free Software Foundation; either version 2 of the
18
+ # License, or (at your option) any later version; or 2) Ruby's License.
19
+ #
20
+ # See the file COPYING for complete licensing information.
21
+ #
22
+ #---------------------------------------------------------------------------
23
+ #
24
+ #
25
+ #
26
+
27
+ $:.unshift "../lib"
28
+ require 'eventmachine'
29
+ require 'socket'
30
+ require 'test/unit'
31
+
32
+ class TestServers < Test::Unit::TestCase
33
+
34
+ Host = "127.0.0.1"
35
+ Port = 9555
36
+
37
+ module NetstatHelper
38
+ GlobalUdp4Rexp = /udp.*\s+(?:\*|(?:0\.){3}0)[:.](\d+)\s/i
39
+ GlobalTcp4Rexp = /tcp.*\s+(?:\*|(?:0\.){3}0)[:.](\d+)\s/i
40
+ LocalUdpRexp = /udp.*\s+(?:127\.0\.0\.1|::1)[:.](\d+)\s/i
41
+ LocalTcpRexp = /tcp.*\s+(?:127\.0\.0\.1|::1)[:.](\d+)\s/i
42
+ def grep_netstat(pattern)
43
+ `netstat -an`.scan(/^.*$/).grep(pattern)
44
+ end
45
+ end
46
+ include NetstatHelper
47
+
48
+ class TestStopServer < EM::Connection
49
+ def initialize *args
50
+ super
51
+ end
52
+ def post_init
53
+ # TODO,sucks that this isn't OOPy enough.
54
+ EM.stop_server @server_instance
55
+ end
56
+ end
57
+
58
+ def run_test_stop_server
59
+ EM.run {
60
+ sig = EM.start_server(Host, Port)
61
+ assert(grep_netstat(LocalTcpRexp).grep(%r(#{Port})).size >= 1, "Server didn't start")
62
+ EM.stop_server sig
63
+ # Give the server some time to shutdown.
64
+ EM.add_timer(0.2) {
65
+ assert(grep_netstat(LocalTcpRexp).grep(%r(#{Port})).empty?, "Servers didn't stop")
66
+ EM.stop
67
+ }
68
+ }
69
+ end
70
+ def test_stop_server
71
+ assert(grep_netstat(LocalTcpRexp).grep(Port).empty?, "Port already in use")
72
+ 5.times {run_test_stop_server}
73
+ assert(grep_netstat(LocalTcpRexp).grep(%r(#{Port})).empty?, "Servers didn't stop")
74
+ end
75
+
76
+ end
@@ -0,0 +1,83 @@
1
+ # $Id$
2
+ #
3
+ # Author:: Francis Cianfrocca (gmail: blackhedd)
4
+ # Homepage:: http://rubyeventmachine.com
5
+ # Date:: 8 April 2006
6
+ #
7
+ # See EventMachine and EventMachine::Connection for documentation and
8
+ # usage examples.
9
+ #
10
+ #----------------------------------------------------------------------------
11
+ #
12
+ # Copyright (C) 2006-07 by Francis Cianfrocca. All Rights Reserved.
13
+ # Gmail: blackhedd
14
+ #
15
+ # This program is free software; you can redistribute it and/or modify
16
+ # it under the terms of either: 1) the GNU General Public License
17
+ # as published by the Free Software Foundation; either version 2 of the
18
+ # License, or (at your option) any later version; or 2) Ruby's License.
19
+ #
20
+ # See the file COPYING for complete licensing information.
21
+ #
22
+ #---------------------------------------------------------------------------
23
+ #
24
+ #
25
+ #
26
+
27
+ $:.unshift "../lib"
28
+ require 'eventmachine'
29
+ require 'test/unit'
30
+
31
+ class TestSmtpClient < Test::Unit::TestCase
32
+
33
+ Localhost = "127.0.0.1"
34
+ Localport = 9801
35
+
36
+ def setup
37
+ end
38
+
39
+ def teardown
40
+ end
41
+
42
+ def test_a
43
+ # No real tests until we have a server implementation to test against.
44
+ # This is what the call looks like, though:
45
+ err = nil
46
+ EM.run {
47
+ d = EM::Protocols::SmtpClient.send :domain=>"example.com",
48
+ :host=>Localhost,
49
+ :port=>Localport, # optional, defaults 25
50
+ :starttls=>true,
51
+ :from=>"sender@example.com",
52
+ :to=> ["to_1@example.com", "to_2@example.com"],
53
+ :header=> {"Subject" => "This is a subject line"},
54
+ :body=> "This is the body of the email",
55
+ :verbose=>true
56
+ d.errback {|e|
57
+ err = e
58
+ EM.stop
59
+ }
60
+ }
61
+ assert(err)
62
+ end
63
+
64
+ def test_content
65
+ err = nil
66
+ EM.run {
67
+ d = EM::Protocols::SmtpClient.send :domain=>"example.com",
68
+ :host=>Localhost,
69
+ :port=>Localport, # optional, defaults 25
70
+ :starttls=>true,
71
+ :from=>"sender@example.com",
72
+ :to=> ["to_1@example.com", "to_2@example.com"],
73
+ :content => ["Subject: xxx\r\n\r\ndata\r\n.\r\n"],
74
+ :verbose=>true
75
+ d.errback {|e|
76
+ err = e
77
+ EM.stop
78
+ }
79
+ }
80
+ assert(err)
81
+ end
82
+
83
+ end
@@ -0,0 +1,85 @@
1
+ # $Id$
2
+ #
3
+ # Author:: Francis Cianfrocca (gmail: blackhedd)
4
+ # Homepage:: http://rubyeventmachine.com
5
+ # Date:: 8 April 2006
6
+ #
7
+ # See EventMachine and EventMachine::Connection for documentation and
8
+ # usage examples.
9
+ #
10
+ #----------------------------------------------------------------------------
11
+ #
12
+ # Copyright (C) 2006-07 by Francis Cianfrocca. All Rights Reserved.
13
+ # Gmail: blackhedd
14
+ #
15
+ # This program is free software; you can redistribute it and/or modify
16
+ # it under the terms of either: 1) the GNU General Public License
17
+ # as published by the Free Software Foundation; either version 2 of the
18
+ # License, or (at your option) any later version; or 2) Ruby's License.
19
+ #
20
+ # See the file COPYING for complete licensing information.
21
+ #
22
+ #---------------------------------------------------------------------------
23
+ #
24
+ #
25
+ #
26
+
27
+ $:.unshift "../lib"
28
+ require 'eventmachine'
29
+ require 'test/unit'
30
+
31
+ class TestSmtpServer < Test::Unit::TestCase
32
+
33
+ # Don't test on port 25. It requires superuser and there's probably
34
+ # a mail server already running there anyway.
35
+ Localhost = "127.0.0.1"
36
+ Localport = 25001
37
+
38
+ # This class is an example of what you need to write in order
39
+ # to implement a mail server. You override the methods you are
40
+ # interested in. Some, but not all, of these are illustrated here.
41
+ #
42
+ class Mailserver < EM::Protocols::SmtpServer
43
+
44
+ attr_reader :my_msg_body, :my_sender, :my_recipients
45
+
46
+ def initialize *args
47
+ super
48
+ end
49
+ def receive_sender sender
50
+ @my_sender = sender
51
+ #p sender
52
+ true
53
+ end
54
+ def receive_recipient rcpt
55
+ @my_recipients ||= []
56
+ @my_recipients << rcpt
57
+ true
58
+ end
59
+ def receive_data_chunk c
60
+ @my_msg_body = c.last
61
+ end
62
+ def connection_ended
63
+ EM.stop
64
+ end
65
+ end
66
+
67
+ def test_mail
68
+ c = nil
69
+ EM.run {
70
+ EM.start_server( Localhost, Localport, Mailserver ) {|conn| c = conn}
71
+ EM::Timer.new(2) {EM.stop} # prevent hanging the test suite in case of error
72
+ EM::Protocols::SmtpClient.send :host=>Localhost,
73
+ :port=>Localport,
74
+ :domain=>"bogus",
75
+ :from=>"me@example.com",
76
+ :to=>"you@example.com",
77
+ :header=> {"Subject"=>"Email subject line", "Reply-to"=>"me@example.com"},
78
+ :body=>"Not much of interest here."
79
+
80
+ }
81
+ assert_equal( "Not much of interest here.", c.my_msg_body )
82
+ assert_equal( "<me@example.com>", c.my_sender )
83
+ assert_equal( ["<you@example.com>"], c.my_recipients )
84
+ end
85
+ end
@@ -0,0 +1,322 @@
1
+ # $Id$
2
+ #
3
+ # Author:: Francis Cianfrocca (gmail: blackhedd)
4
+ # Homepage:: http://rubyeventmachine.com
5
+ # Date:: 25 Aug 2007
6
+ #
7
+ # See EventMachine and EventMachine::Connection for documentation and
8
+ # usage examples.
9
+ #
10
+ #----------------------------------------------------------------------------
11
+ #
12
+ # Copyright (C) 2006-07 by Francis Cianfrocca. All Rights Reserved.
13
+ # Gmail: blackhedd
14
+ #
15
+ # This program is free software; you can redistribute it and/or modify
16
+ # it under the terms of either: 1) the GNU General Public License
17
+ # as published by the Free Software Foundation; either version 2 of the
18
+ # License, or (at your option) any later version; or 2) Ruby's License.
19
+ #
20
+ # See the file COPYING for complete licensing information.
21
+ #
22
+ #---------------------------------------------------------------------------
23
+ #
24
+ #
25
+ #
26
+ #
27
+
28
+
29
+ $:.unshift "../lib"
30
+ require 'eventmachine'
31
+ require 'test/unit'
32
+
33
+
34
+
35
+ class TestSpawn < Test::Unit::TestCase
36
+
37
+ # Spawn a process that simply stops the reactor.
38
+ # Assert that the notification runs after the block that calls it.
39
+ #
40
+ def test_stop
41
+ x = nil
42
+ EM.run {
43
+ s = EM.spawn {EM.stop}
44
+ s.notify
45
+ x = true
46
+ }
47
+ assert x
48
+ end
49
+
50
+
51
+ # Pass a parameter to a spawned process.
52
+ #
53
+ def test_parms
54
+ val = 5
55
+ EM.run {
56
+ s = EM.spawn {|v| val *= v; EM.stop}
57
+ s.notify 3
58
+ }
59
+ assert_equal( 15, val )
60
+ end
61
+
62
+ # Pass multiple parameters to a spawned process.
63
+ #
64
+ def test_multiparms
65
+ val = 5
66
+ EM.run {
67
+ s = EM.spawn {|v1,v2| val *= (v1 + v2); EM.stop}
68
+ s.notify 3,4
69
+ }
70
+ assert_equal( 35, val )
71
+ end
72
+
73
+
74
+ # This test demonstrates that a notification does not happen immediately,
75
+ # but rather is scheduled sometime after the current code path completes.
76
+ #
77
+ def test_race
78
+ x = 0
79
+ EM.run {
80
+ s = EM.spawn {x *= 2; EM.stop}
81
+ s.notify
82
+ x = 2
83
+ }
84
+ assert_equal( 4, x)
85
+ end
86
+
87
+
88
+ # Spawn a process and notify it 25 times to run fibonacci
89
+ # on a pair of global variables.
90
+ #
91
+ def test_fibonacci
92
+ x = 1
93
+ y = 1
94
+ EM.run {
95
+ s = EM.spawn {x,y = y,x+y}
96
+ 25.times {s.notify}
97
+
98
+ t = EM.spawn {EM.stop}
99
+ t.notify
100
+ }
101
+ assert_equal( 121393, x)
102
+ assert_equal( 196418, y)
103
+ end
104
+
105
+ # This one spawns 25 distinct processes, and notifies each one once,
106
+ # rather than notifying a single process 25 times.
107
+ #
108
+ def test_another_fibonacci
109
+ x = 1
110
+ y = 1
111
+ EM.run {
112
+ 25.times {
113
+ s = EM.spawn {x,y = y,x+y}
114
+ s.notify
115
+ }
116
+
117
+ t = EM.spawn {EM.stop}
118
+ t.notify
119
+ }
120
+ assert_equal( 121393, x)
121
+ assert_equal( 196418, y)
122
+ end
123
+
124
+
125
+ # Make a chain of processes that notify each other in turn
126
+ # with intermediate fibonacci results. The final process in
127
+ # the chain stops the loop and returns the result.
128
+ #
129
+ def test_fibonacci_chain
130
+ a,b = nil
131
+
132
+ EM.run {
133
+ nextpid = EM.spawn {|x,y|
134
+ a,b = x,y
135
+ EM.stop
136
+ }
137
+
138
+ 25.times {
139
+ n = nextpid
140
+ nextpid = EM.spawn {|x,y| n.notify( y, x+y )}
141
+ }
142
+
143
+ nextpid.notify( 1, 1 )
144
+ }
145
+
146
+ assert_equal( 121393, a)
147
+ assert_equal( 196418, b)
148
+ end
149
+
150
+
151
+ # EM#yield gives a spawed process to yield control to other processes
152
+ # (in other words, to stop running), and to specify a different code block
153
+ # that will run on its next notification.
154
+ #
155
+ def test_yield
156
+ a = 0
157
+ EM.run {
158
+ n = EM.spawn {
159
+ a += 10
160
+ EM.yield {
161
+ a += 20
162
+ EM.yield {
163
+ a += 30
164
+ EM.stop
165
+ }
166
+ }
167
+ }
168
+ n.notify
169
+ n.notify
170
+ n.notify
171
+ }
172
+ assert_equal( 60, a )
173
+ end
174
+
175
+ # EM#yield_and_notify behaves like EM#yield, except that it also notifies the
176
+ # yielding process. This may sound trivial, since the yield block will run very
177
+ # shortly after with no action by the program, but this actually can be very useful,
178
+ # because it causes the reactor core to execute once before the yielding process
179
+ # gets control back. So it can be used to allow heavily-used network connections
180
+ # to clear buffers, or allow other processes to process their notifications.
181
+ #
182
+ # Notice in this test code that only a simple notify is needed at the bottom
183
+ # of the initial block. Even so, all of the yielded blocks will execute.
184
+ #
185
+ def test_yield_and_notify
186
+ a = 0
187
+ EM.run {
188
+ n = EM.spawn {
189
+ a += 10
190
+ EM.yield_and_notify {
191
+ a += 20
192
+ EM.yield_and_notify {
193
+ a += 30
194
+ EM.stop
195
+ }
196
+ }
197
+ }
198
+ n.notify
199
+ }
200
+ assert_equal( 60, a )
201
+ end
202
+
203
+ # resume is an alias for notify.
204
+ #
205
+ def test_resume
206
+ EM.run {
207
+ n = EM.spawn {EM.stop}
208
+ n.resume
209
+ }
210
+ assert true
211
+ end
212
+
213
+ # run is an idiomatic alias for notify.
214
+ #
215
+ def test_run
216
+ EM.run {
217
+ (EM.spawn {EM.stop}).run
218
+ }
219
+ assert true
220
+ end
221
+
222
+
223
+ # Clones the ping-pong example from the Erlang tutorial, in much less code.
224
+ # Illustrates that a spawned block executes in the context of a SpawnableObject.
225
+ # (Meaning, we can pass self as a parameter to another process that can then
226
+ # notify us.)
227
+ #
228
+ def test_ping_pong
229
+ n_pongs = 0
230
+ EM.run {
231
+ pong = EM.spawn {|x, ping|
232
+ n_pongs += 1
233
+ ping.notify( x-1 )
234
+ }
235
+ ping = EM.spawn {|x|
236
+ if x > 0
237
+ pong.notify x, self
238
+ else
239
+ EM.stop
240
+ end
241
+ }
242
+ ping.notify 3
243
+ }
244
+ assert_equal( 3, n_pongs )
245
+ end
246
+
247
+ # Illustrates that you can call notify inside a notification, and it will cause
248
+ # the currently-executing process to be re-notified. Of course, the new notification
249
+ # won't run until sometime after the current one completes.
250
+ #
251
+ def test_self_notify
252
+ n = 0
253
+ EM.run {
254
+ pid = EM.spawn {|x|
255
+ if x > 0
256
+ n += x
257
+ notify( x-1 )
258
+ else
259
+ EM.stop
260
+ end
261
+ }
262
+ pid.notify 3
263
+ }
264
+ assert_equal( 6, n )
265
+ end
266
+
267
+
268
+ # Illustrates that the block passed to #spawn executes in the context of a
269
+ # SpawnedProcess object, NOT in the local context. This can often be deceptive.
270
+ #
271
+ class BlockScopeTest
272
+ attr_reader :var
273
+ def run
274
+ # The following line correctly raises a NameError.
275
+ # The problem is that the programmer expected the spawned block to
276
+ # execute in the local context, but it doesn't.
277
+ #
278
+ # (EM.spawn { do_something }).notify ### NO! BAD!
279
+
280
+
281
+
282
+ # The following line correctly passes self as a parameter to the
283
+ # notified process.
284
+ #
285
+ (EM.spawn {|obj| obj.do_something }).notify(self)
286
+
287
+
288
+
289
+ # Here's another way to do it. This works because "myself" is bound
290
+ # in the local scope, unlike "self," so the spawned block sees it.
291
+ #
292
+ myself = self
293
+ (EM.spawn { myself.do_something }).notify
294
+
295
+
296
+
297
+ # And we end the loop.
298
+ # This is a tangential point, but observe that #notify never blocks.
299
+ # It merely appends a message to the internal queue of a spawned process
300
+ # and returns. As it turns out, the reactor processes notifications for ALL
301
+ # spawned processes in the order that #notify is called. So there is a
302
+ # reasonable expectation that the process which stops the reactor will
303
+ # execute after the previous ones in this method. HOWEVER, this is NOT
304
+ # a documented behavior and is subject to change.
305
+ #
306
+ (EM.spawn {EM.stop}).notify
307
+ end
308
+ def do_something
309
+ @var ||= 0
310
+ @var += 100
311
+ end
312
+ end
313
+
314
+ def test_block_scope
315
+ bs = BlockScopeTest.new
316
+ EM.run {
317
+ bs.run
318
+ }
319
+ assert_equal( 200, bs.var )
320
+ end
321
+
322
+ end