eventmachine 1.0.0.beta.2-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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