async 1.26.1 → 1.26.2

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 (55) hide show
  1. checksums.yaml +4 -4
  2. data/lib/async/barrier.rb +1 -1
  3. data/lib/async/version.rb +1 -1
  4. metadata +54 -99
  5. data/.editorconfig +0 -6
  6. data/.github/workflows/development.yml +0 -55
  7. data/.gitignore +0 -14
  8. data/.rspec +0 -3
  9. data/.yardopts +0 -1
  10. data/Gemfile +0 -20
  11. data/Guardfile +0 -14
  12. data/README.md +0 -385
  13. data/Rakefile +0 -40
  14. data/async.gemspec +0 -34
  15. data/bake.rb +0 -33
  16. data/benchmark/async_vs_lightio.rb +0 -84
  17. data/benchmark/fiber_count.rb +0 -10
  18. data/benchmark/rubies/README.md +0 -51
  19. data/benchmark/rubies/benchmark.rb +0 -220
  20. data/benchmark/thread_count.rb +0 -9
  21. data/benchmark/thread_vs_fiber.rb +0 -45
  22. data/examples/async_method.rb +0 -60
  23. data/examples/callback/loop.rb +0 -44
  24. data/examples/capture/README.md +0 -59
  25. data/examples/capture/capture.rb +0 -116
  26. data/examples/fibers.rb +0 -178
  27. data/examples/queue/producer.rb +0 -28
  28. data/examples/sleep_sort.rb +0 -40
  29. data/examples/stop/condition.rb +0 -31
  30. data/examples/stop/sleep.rb +0 -42
  31. data/gems/event.gemfile +0 -4
  32. data/logo.png +0 -0
  33. data/logo.svg +0 -64
  34. data/papers/1982 Grossman.pdf +0 -0
  35. data/papers/1987 ODell.pdf +0 -0
  36. data/spec/async/barrier_spec.rb +0 -116
  37. data/spec/async/chainable_async_examples.rb +0 -13
  38. data/spec/async/clock_spec.rb +0 -37
  39. data/spec/async/condition_examples.rb +0 -105
  40. data/spec/async/condition_spec.rb +0 -72
  41. data/spec/async/logger_spec.rb +0 -65
  42. data/spec/async/node_spec.rb +0 -193
  43. data/spec/async/notification_spec.rb +0 -66
  44. data/spec/async/performance_spec.rb +0 -72
  45. data/spec/async/queue_spec.rb +0 -133
  46. data/spec/async/reactor/nested_spec.rb +0 -52
  47. data/spec/async/reactor_spec.rb +0 -253
  48. data/spec/async/semaphore_spec.rb +0 -169
  49. data/spec/async/task_spec.rb +0 -476
  50. data/spec/async/wrapper_spec.rb +0 -203
  51. data/spec/async_spec.rb +0 -33
  52. data/spec/enumerator_spec.rb +0 -83
  53. data/spec/kernel/async_spec.rb +0 -39
  54. data/spec/kernel/sync_spec.rb +0 -54
  55. data/spec/spec_helper.rb +0 -18
@@ -1,203 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
4
- #
5
- # Permission is hereby granted, free of charge, to any person obtaining a copy
6
- # of this software and associated documentation files (the "Software"), to deal
7
- # in the Software without restriction, including without limitation the rights
8
- # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- # copies of the Software, and to permit persons to whom the Software is
10
- # furnished to do so, subject to the following conditions:
11
- #
12
- # The above copyright notice and this permission notice shall be included in
13
- # all copies or substantial portions of the Software.
14
- #
15
- # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
- # THE SOFTWARE.
22
-
23
- require "async/rspec"
24
-
25
- RSpec.describe Async::Wrapper do
26
- include_context Async::RSpec::Reactor
27
-
28
- let(:pipe) {IO.pipe}
29
- let(:input) {Async::Wrapper.new(pipe.last)}
30
- let(:output) {Async::Wrapper.new(pipe.first)}
31
-
32
- after(:each) do
33
- input.close unless input.closed?
34
- output.close unless output.closed?
35
-
36
- expect(input.monitor).to be_nil
37
- expect(output.monitor).to be_nil
38
- end
39
-
40
- describe '#wait_readable' do
41
- it "can wait to be readable" do
42
- reader = reactor.async do
43
- expect(output.wait_readable).to be_truthy
44
- end
45
-
46
- input.io.write('Hello World')
47
- reader.wait
48
- end
49
-
50
- it "can timeout if no event occurs" do
51
- expect do
52
- output.wait_readable(0.1)
53
- end.to raise_exception(Async::TimeoutError)
54
- end
55
-
56
- it "can wait for readability in sequential tasks" do
57
- reactor.async do
58
- input.wait_writable(1)
59
- input.io.write('Hello World')
60
- end
61
-
62
- 2.times do
63
- reactor.async do
64
- expect(output.wait_readable(1)).to be_truthy
65
- end.wait
66
- end
67
- end
68
-
69
- it "can be cancelled" do
70
- reactor.async do
71
- expect do
72
- output.wait_readable
73
- end.to raise_exception(Async::Wrapper::Cancelled)
74
- end
75
-
76
- expect(output.monitor).to_not be_nil
77
- end
78
- end
79
-
80
- describe '#wait_writable' do
81
- it "can wait to be writable" do
82
- expect(input.wait_writable).to be_truthy
83
- end
84
-
85
- it "can be cancelled while waiting to be readable" do
86
- reactor.async do
87
- expect do
88
- input.wait_readable
89
- end.to raise_exception(Async::Wrapper::Cancelled)
90
- end
91
-
92
- # This reproduces the race condition that can occur if two tasks are resumed in sequence.
93
-
94
- # Resume task 1 which closes IO:
95
- output.close
96
-
97
- # Resume task 2:
98
- expect do
99
- output.resume
100
- end.to_not raise_exception
101
- end
102
-
103
- it "can be cancelled" do
104
- reactor.async do
105
- expect do
106
- input.wait_readable
107
- end.to raise_exception(Async::Wrapper::Cancelled)
108
- end
109
-
110
- expect(input.monitor).to_not be_nil
111
- end
112
- end
113
-
114
- describe "#wait_any" do
115
- it "can wait for any events" do
116
- reactor.async do
117
- input.wait_any(1)
118
- input.io.write('Hello World')
119
- end
120
-
121
- expect(output.wait_readable(1)).to be_truthy
122
- end
123
-
124
- it "can wait for readability in one task and writability in another" do
125
- reactor.async do
126
- expect do
127
- input.wait_readable(1)
128
- end.to raise_exception(Async::Wrapper::Cancelled)
129
- end
130
-
131
- expect(input.monitor.interests).to be == :r
132
-
133
- reactor.async do
134
- input.wait_writable
135
-
136
- input.close
137
- output.close
138
- end.wait
139
- end
140
-
141
- it "fails if waiting on from multiple tasks" do
142
- input.reactor = reactor
143
-
144
- reactor.async do
145
- expect do
146
- input.wait_readable
147
- end.to raise_exception(Async::Wrapper::Cancelled)
148
- end
149
-
150
- expect(input.monitor.interests).to be == :r
151
-
152
- reactor.async do
153
- expect do
154
- input.wait_readable
155
- end.to raise_exception(Async::Wrapper::WaitError)
156
- end
157
- end
158
- end
159
-
160
- describe '#reactor=' do
161
- it 'can assign a wrapper to a reactor' do
162
- input.reactor = reactor
163
-
164
- expect(input.reactor).to be == reactor
165
- end
166
-
167
- it 'assigns current reactor when waiting for events' do
168
- input.wait_writable
169
-
170
- expect(input.reactor).to be == reactor
171
- end
172
- end
173
-
174
- describe '#dup' do
175
- let(:dup) {input.dup}
176
-
177
- it 'dups the underlying io' do
178
- expect(dup.io).to_not eq input.io
179
-
180
- dup.close
181
-
182
- expect(input).to_not be_closed
183
- end
184
- end
185
-
186
- describe '#close' do
187
- it "closes monitor when closing wrapper" do
188
- input.wait_writable
189
- expect(input.monitor).to_not be_nil
190
- input.close
191
- expect(input.monitor).to be_nil
192
- end
193
-
194
- it "can't wait on closed wrapper" do
195
- input.close
196
- output.close
197
-
198
- expect do
199
- output.wait_readable
200
- end.to raise_exception(IOError, /closed stream/)
201
- end
202
- end
203
- end
@@ -1,33 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright, 2019, by Samuel G. D. Williams. <http://www.codeotaku.com>
4
- #
5
- # Permission is hereby granted, free of charge, to any person obtaining a copy
6
- # of this software and associated documentation files (the "Software"), to deal
7
- # in the Software without restriction, including without limitation the rights
8
- # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- # copies of the Software, and to permit persons to whom the Software is
10
- # furnished to do so, subject to the following conditions:
11
- #
12
- # The above copyright notice and this permission notice shall be included in
13
- # all copies or substantial portions of the Software.
14
- #
15
- # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
- # THE SOFTWARE.
22
-
23
- require 'async'
24
-
25
- RSpec.describe Async do
26
- describe '.run' do
27
- it "can run an asynchronous task" do
28
- Async.run do |task|
29
- expect(task).to be_a Async::Task
30
- end
31
- end
32
- end
33
- end
@@ -1,83 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright, 2018, by Samuel G. D. Williams. <http://www.codeotaku.com>
4
- # Copyright, 2018, by Sokolov Yura aka funny-falcon
5
- #
6
- # Permission is hereby granted, free of charge, to any person obtaining a copy
7
- # of this software and associated documentation files (the "Software"), to deal
8
- # in the Software without restriction, including without limitation the rights
9
- # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
- # copies of the Software, and to permit persons to whom the Software is
11
- # furnished to do so, subject to the following conditions:
12
- #
13
- # The above copyright notice and this permission notice shall be included in
14
- # all copies or substantial portions of the Software.
15
- #
16
- # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
- # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
- # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
- # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
- # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
- # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22
- # THE SOFTWARE.
23
-
24
- RSpec.describe Enumerator do
25
- def some_yielder(task)
26
- yield 1
27
- task.sleep(0.002)
28
- yield 2
29
- end
30
-
31
- def enum(task)
32
- to_enum(:some_yielder, task)
33
- end
34
-
35
- it "should play well with Enumerator as internal iterator" do
36
- # no fiber really used in internal iterator,
37
- # but let this test be here for completness
38
- ar = nil
39
- Async do |task|
40
- ar = enum(task).to_a
41
- end
42
- expect(ar).to be == [1, 2]
43
- end
44
-
45
- it "should play well with Enumerator as external iterator", pending: "expected failure" do
46
- ar = []
47
- Async do |task|
48
- en = enum(task)
49
- ar << en.next
50
- ar << en.next
51
- ar << begin en.next rescue $! end
52
- end
53
- expect(ar[0]).to be == 1
54
- expect(ar[1]).to be == 2
55
- expect(ar[2]).to be_a StopIteration
56
- end
57
-
58
- it "should play well with Enumerator.zip(Enumerator) method", pending: "expected failure" do
59
- Async do |task|
60
- ar = [:a, :b, :c, :d].each.zip(enum(task))
61
- expect(ar).to be == [[:a, 1], [:b, 2], [:c, nil], [:d, nil]]
62
- end.wait
63
- end
64
-
65
- it "should play with explicit Fiber usage", pending: "expected failure" do
66
- ar = []
67
- Async do |task|
68
- fib = Fiber.new {
69
- Fiber.yield 1
70
- task.sleep(0.002)
71
- Fiber.yield 2
72
- }
73
- ar << fib.resume
74
- ar << fib.resume
75
- ar << fib.resume
76
- ar << begin en.next rescue $! end
77
- end
78
- expect(ar[0]).to be == 1
79
- expect(ar[1]).to be == 2
80
- expect(ar[2]).to be nil
81
- expect(ar[3]).to be_a FiberError
82
- end
83
- end
@@ -1,39 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright, 2019, by Samuel G. D. Williams. <http://www.codeotaku.com>
4
- #
5
- # Permission is hereby granted, free of charge, to any person obtaining a copy
6
- # of this software and associated documentation files (the "Software"), to deal
7
- # in the Software without restriction, including without limitation the rights
8
- # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- # copies of the Software, and to permit persons to whom the Software is
10
- # furnished to do so, subject to the following conditions:
11
- #
12
- # The above copyright notice and this permission notice shall be included in
13
- # all copies or substantial portions of the Software.
14
- #
15
- # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
- # THE SOFTWARE.
22
-
23
- require 'kernel/async'
24
-
25
- RSpec.describe Async do
26
- describe '#Async' do
27
- it "can run an asynchronous task" do
28
- Async do |task|
29
- expect(task).to be_a Async::Task
30
- end
31
- end
32
-
33
- it "passes options through to initial task" do
34
- Async(transient: true) do |task|
35
- expect(task).to be_transient
36
- end
37
- end
38
- end
39
- end
@@ -1,54 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- # Copyright, 2019, by Samuel G. D. Williams. <http://www.codeotaku.com>
4
- #
5
- # Permission is hereby granted, free of charge, to any person obtaining a copy
6
- # of this software and associated documentation files (the "Software"), to deal
7
- # in the Software without restriction, including without limitation the rights
8
- # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- # copies of the Software, and to permit persons to whom the Software is
10
- # furnished to do so, subject to the following conditions:
11
- #
12
- # The above copyright notice and this permission notice shall be included in
13
- # all copies or substantial portions of the Software.
14
- #
15
- # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
- # THE SOFTWARE.
22
-
23
- require 'kernel/async'
24
- require 'kernel/sync'
25
-
26
- RSpec.describe Kernel do
27
- describe '#Sync' do
28
- let(:value) {10}
29
-
30
- it "can run a synchronous task" do
31
- result = Sync do |task|
32
- expect(Async::Task.current).to_not be nil
33
- expect(Async::Task.current).to be task
34
-
35
- next value
36
- end
37
-
38
- expect(result).to be == value
39
- end
40
-
41
- it "can run inside reactor" do
42
- Async do |task|
43
- result = Sync do |sync_task|
44
- expect(Async::Task.current).to be task
45
- expect(sync_task).to be task
46
-
47
- next value
48
- end
49
-
50
- expect(result).to be == value
51
- end
52
- end
53
- end
54
- end
@@ -1,18 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- require "covered/rspec"
4
-
5
- if RUBY_PLATFORM =~ /darwin/
6
- Q = 20
7
- else
8
- Q = 1
9
- end
10
-
11
- RSpec.configure do |config|
12
- # Enable flags like --only-failures and --next-failure
13
- config.example_status_persistence_file_path = ".rspec_status"
14
-
15
- config.expect_with :rspec do |c|
16
- c.syntax = :expect
17
- end
18
- end