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
|
[](https://travis-ci.org/JoshCheek/thread_order)
ThreadOrder
===========
A tool for testing threaded code.
Its purpose is to enable reasoning about thread order.
* Tested on 1.8.7 - 2.2, JRuby, Rbx
* It has no external dependencies
* It does not depend on the stdlib.
Example
-------
```ruby
# A somewhat contrived class we're going to test.
class MyQueue
attr_reader :array
def initialize
@array, @mutex = [], Mutex.new
end
def enqueue
@mutex.synchronize { @array << yield }
end
end
require 'rspec/autorun'
require 'thread_order'
RSpec.describe MyQueue do
let(:queue) { described_class.new }
let(:order) { ThreadOrder.new }
after { order.apocalypse! } # ensure everything gets cleaned up (technically redundant for our one example, but it's a good practice)
it 'is threadsafe on enqueue' do
# will execute in a thread, can be invoked by name
order.declare :concurrent_enqueue do
queue.enqueue { :concurrent }
end
# this enqueue will block until the mutex puts the other one to sleep
queue.enqueue do
order.pass_to :concurrent_enqueue, resume_on: :sleep
:main
end
order.join_all # concurrent_enqueue may still be asleep
expect(queue.array).to eq [:main, :concurrent]
end
end
# >> MyQueue
# >> is threadsafe on enqueue
# >>
# >> Finished in 0.00131 seconds (files took 0.08687 seconds to load)
# >> 1 example, 0 failures
```
|
