concurrent-ruby-ext 1.0.5 → 1.1.0.pre1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/CHANGELOG.md +42 -0
- data/{LICENSE.txt → LICENSE.md} +2 -0
- data/README.md +203 -105
- data/ext/{concurrent → concurrent-ruby-ext}/atomic_boolean.c +2 -3
- data/ext/{concurrent → concurrent-ruby-ext}/atomic_boolean.h +0 -0
- data/ext/{concurrent → concurrent-ruby-ext}/atomic_fixnum.c +0 -0
- data/ext/{concurrent → concurrent-ruby-ext}/atomic_fixnum.h +0 -0
- data/ext/{concurrent → concurrent-ruby-ext}/atomic_reference.c +32 -14
- data/ext/{concurrent → concurrent-ruby-ext}/atomic_reference.h +0 -0
- data/ext/concurrent-ruby-ext/extconf.rb +22 -0
- data/ext/{concurrent → concurrent-ruby-ext}/rb_concurrent.c +1 -1
- data/ext/{concurrent → concurrent-ruby-ext}/ruby_193_compatible.h +0 -0
- metadata +20 -25
- data/ext/concurrent/extconf.rb +0 -58
- data/lib/concurrent/atomic_reference/concurrent_update_error.rb +0 -8
- data/lib/concurrent/atomic_reference/direct_update.rb +0 -81
- data/lib/concurrent/atomic_reference/numeric_cas_wrapper.rb +0 -28
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
|
-
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
2
|
+
SHA256:
|
|
3
|
+
metadata.gz: '0234965c1816cd9d6b9d69c8e237638560bbb0095ce46b839386689b784e5594'
|
|
4
|
+
data.tar.gz: e9395276d0578ce226e84f940efa710e31ee919123c0a090a1a0c6a98a32d740
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: e8caab8ff5a5e2e0f9611cf4039c6b35391cdfb52b48e978953b2ec2caa9f7a32e8ed97164da02091886e8baabe4536cd5a63106ad9a65fadfeb2c864fa969a0
|
|
7
|
+
data.tar.gz: bcbbd33457c91afccfd7f48f8bb3336a4c322bc58202e8a958ec3a3e33f7d6768427181442cef49bea1a00b3de77528db2ce23db2b62864c502787a04fd51e51
|
data/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,45 @@
|
|
|
1
|
+
## Current
|
|
2
|
+
|
|
3
|
+
concurrent-ruby:
|
|
4
|
+
|
|
5
|
+
* [Promises](http://ruby-concurrency.github.io/concurrent-ruby/1.1.0/Concurrent/Promises.html)
|
|
6
|
+
are moved from `concurrent-ruby-edge` to `concurrent-ruby`
|
|
7
|
+
* Add support for TruffleRuby
|
|
8
|
+
* (#734) Fix Array/Hash/Set construction broken on TruffleRuby
|
|
9
|
+
* AtomicReference fixed
|
|
10
|
+
* CI stabilization
|
|
11
|
+
* remove sharp dependency edge -> core
|
|
12
|
+
* remove warnings
|
|
13
|
+
* documentation updates
|
|
14
|
+
* Exchanger is no longer documented as edge since it was already available in
|
|
15
|
+
`concurrent-ruby`
|
|
16
|
+
* (#644) Fix Map#each and #each_pair not returning enumerator outside of MRI
|
|
17
|
+
* (#659) Edge promises fail during error handling
|
|
18
|
+
* (#741) Raise on recursive Delay#value call
|
|
19
|
+
* (#727) #717 fix global IO executor on JRuby
|
|
20
|
+
* (#740) Drop support for CRuby 1.9, JRuby 1.7, Rubinius.
|
|
21
|
+
* (#737) Move AtomicMarkableReference out of Edge
|
|
22
|
+
* (#708) Prefer platform specific memory barriers
|
|
23
|
+
* (#735) Fix wrong expected exception in channel spec assertion
|
|
24
|
+
* (#729) Allow executor option in `Promise#then`
|
|
25
|
+
* (#725) fix timeout check to use timeout_interval
|
|
26
|
+
* (#719) update engine detection
|
|
27
|
+
* (#660) Add specs for Promise#zip/Promise.zip ordering
|
|
28
|
+
* (#654) Promise.zip execution changes
|
|
29
|
+
* (#666) Add thread safe set implementation
|
|
30
|
+
* (#651) #699 #to_s, #inspect should not output negative object IDs.
|
|
31
|
+
* (#685) Avoid RSpec warnings about raise_error
|
|
32
|
+
* (#680) Avoid RSpec monkey patching, persist spec results locally, use RSpec
|
|
33
|
+
v3.7.0
|
|
34
|
+
* (#665) Initialize the monitor for new subarrays on Rubinius
|
|
35
|
+
* (#661) Fix error handling in edge promises
|
|
36
|
+
|
|
37
|
+
concurrent-ruby-edge:
|
|
38
|
+
|
|
39
|
+
* (#659) Edge promises fail during error handling
|
|
40
|
+
* Edge files clearly separated in `lib-edge`
|
|
41
|
+
* added ReInclude
|
|
42
|
+
|
|
1
43
|
## Release v1.0.5, edge v0.3.1 (26 Feb 2017)
|
|
2
44
|
|
|
3
45
|
concurrent-ruby:
|
data/{LICENSE.txt → LICENSE.md}
RENAMED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
```
|
|
1
2
|
Copyright (c) Jerry D'Antonio -- released under the MIT license.
|
|
2
3
|
|
|
3
4
|
http://www.opensource.org/licenses/mit-license.php
|
|
@@ -19,3 +20,4 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
19
20
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
21
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
21
22
|
THE SOFTWARE.
|
|
23
|
+
```
|
data/README.md
CHANGED
|
@@ -3,9 +3,6 @@
|
|
|
3
3
|
[](http://badge.fury.io/rb/concurrent-ruby)
|
|
4
4
|
[](https://travis-ci.org/ruby-concurrency/concurrent-ruby)
|
|
5
5
|
[](https://ci.appveyor.com/project/rubyconcurrency/concurrent-ruby)
|
|
6
|
-
[](https://codeclimate.com/github/ruby-concurrency/concurrent-ruby)
|
|
7
|
-
[](http://inch-ci.org/github/ruby-concurrency/concurrent-ruby)
|
|
8
|
-
[](https://gemnasium.com/ruby-concurrency/concurrent-ruby)
|
|
9
6
|
[](http://opensource.org/licenses/MIT)
|
|
10
7
|
[-devs%20%26%20users-brightgreen.svg)](https://gitter.im/ruby-concurrency/concurrent-ruby)
|
|
11
8
|
|
|
@@ -19,129 +16,223 @@ Modern concurrency tools for Ruby. Inspired by
|
|
|
19
16
|
[Java](http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/package-summary.html),
|
|
20
17
|
and classic concurrency patterns.
|
|
21
18
|
|
|
22
|
-
<img src="https://raw.githubusercontent.com/ruby-concurrency/concurrent-ruby/master/
|
|
19
|
+
<img src="https://raw.githubusercontent.com/ruby-concurrency/concurrent-ruby/master/docs-source/logo/concurrent-ruby-logo-300x300.png" align="right" style="margin-left: 20px;" />
|
|
23
20
|
|
|
24
21
|
The design goals of this gem are:
|
|
25
22
|
|
|
26
|
-
*
|
|
27
|
-
|
|
28
|
-
*
|
|
29
|
-
*
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
23
|
+
* Be an 'unopinionated' toolbox that provides useful utilities without debating which is better
|
|
24
|
+
or why
|
|
25
|
+
* Remain free of external gem dependencies
|
|
26
|
+
* Stay true to the spirit of the languages providing inspiration
|
|
27
|
+
* But implement in a way that makes sense for Ruby
|
|
28
|
+
* Keep the semantics as idiomatic Ruby as possible
|
|
29
|
+
* Support features that make sense in Ruby
|
|
30
|
+
* Exclude features that don't make sense in Ruby
|
|
31
|
+
* Be small, lean, and loosely coupled
|
|
32
|
+
* Thread-safety
|
|
33
|
+
* Backward compatibility
|
|
34
|
+
|
|
35
|
+
## Contributing
|
|
36
|
+
|
|
37
|
+
**This gem depends on
|
|
38
|
+
[contributions](https://github.com/ruby-concurrency/concurrent-ruby/graphs/contributors) and we
|
|
39
|
+
appreciate your help. Would you like to contribute? Great! Have a look at
|
|
40
|
+
[issues with `looking-for-contributor` label](https://github.com/ruby-concurrency/concurrent-ruby/issues?q=is%3Aissue+is%3Aopen+label%3Alooking-for-contributor).** And if you pick something up let us know on the issue.
|
|
40
41
|
|
|
41
42
|
## Thread Safety
|
|
42
43
|
|
|
43
|
-
*Concurrent Ruby makes the strongest thread safety guarantees of any Ruby concurrency
|
|
44
|
+
*Concurrent Ruby makes one of the strongest thread safety guarantees of any Ruby concurrency
|
|
45
|
+
library, providing consistent behavior and guarantees on all three of the main Ruby interpreters
|
|
46
|
+
(MRI/CRuby, JRuby, and Rubinius).*
|
|
47
|
+
|
|
48
|
+
Every abstraction in this library is thread safe. Specific thread safety guarantees are documented
|
|
49
|
+
with each abstraction.
|
|
44
50
|
|
|
45
|
-
|
|
51
|
+
It is critical to remember, however, that Ruby is a language of mutable references. *No*
|
|
52
|
+
concurrency library for Ruby can ever prevent the user from making thread safety mistakes (such as
|
|
53
|
+
sharing a mutable object between threads and modifying it on both threads) or from creating
|
|
54
|
+
deadlocks through incorrect use of locks. All the library can do is provide safe abstractions which
|
|
55
|
+
encourage safe practices. Concurrent Ruby provides more safe concurrency abstractions than any
|
|
56
|
+
other Ruby library, many of which support the mantra of
|
|
57
|
+
["Do not communicate by sharing memory; instead, share memory by communicating"](https://blog.golang.org/share-memory-by-communicating).
|
|
58
|
+
Concurrent Ruby is also the only Ruby library which provides a full suite of thread safe and
|
|
59
|
+
immutable variable types and data structures.
|
|
46
60
|
|
|
47
|
-
|
|
61
|
+
We've also initiated discussion to document [memory model](docs-source/synchronization.md) of Ruby which
|
|
62
|
+
would provide consistent behaviour and guarantees on all three of the main Ruby interpreters
|
|
63
|
+
(MRI/CRuby, JRuby, Rubinius, TruffleRuby).
|
|
48
64
|
|
|
49
65
|
## Features & Documentation
|
|
50
66
|
|
|
51
|
-
The primary site for documentation is the automatically generated
|
|
67
|
+
**The primary site for documentation is the automatically generated
|
|
68
|
+
[API documentation](http://ruby-concurrency.github.io/concurrent-ruby/index.html) which is up to
|
|
69
|
+
date with latest release.** This readme matches the master so may contain new stuff not yet
|
|
70
|
+
released.
|
|
71
|
+
|
|
72
|
+
We also have a [IRC (gitter)](https://gitter.im/ruby-concurrency/concurrent-ruby).
|
|
73
|
+
|
|
74
|
+
### Versioning
|
|
75
|
+
|
|
76
|
+
* `concurrent-ruby` uses [Semantic Versioning](http://semver.org/)
|
|
77
|
+
* `concurrent-ruby-ext` has always same version as `concurrent-ruby`
|
|
78
|
+
* `concurrent-ruby-edge` will always be 0.y.z therefore following
|
|
79
|
+
[point 4](http://semver.org/#spec-item-4) applies *"Major version zero
|
|
80
|
+
(0.y.z) is for initial development. Anything may change at any time. The
|
|
81
|
+
public API should not be considered stable."* However we additionally use
|
|
82
|
+
following rules:
|
|
83
|
+
* Minor version increment means incompatible changes were made
|
|
84
|
+
* Patch version increment means only compatible changes were made
|
|
52
85
|
|
|
53
|
-
We also have a [mailing list](http://groups.google.com/group/concurrent-ruby) and [IRC (gitter)](https://gitter.im/ruby-concurrency/concurrent-ruby).
|
|
54
86
|
|
|
55
87
|
#### General-purpose Concurrency Abstractions
|
|
56
88
|
|
|
57
|
-
*
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
*
|
|
61
|
-
|
|
62
|
-
*
|
|
89
|
+
* [Async](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Async.html):
|
|
90
|
+
A mixin module that provides simple asynchronous behavior to a class. Loosely based on Erlang's
|
|
91
|
+
[gen_server](http://www.erlang.org/doc/man/gen_server.html).
|
|
92
|
+
* [ScheduledTask](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/ScheduledTask.html):
|
|
93
|
+
Like a Future scheduled for a specific future time.
|
|
94
|
+
* [TimerTask](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/TimerTask.html):
|
|
95
|
+
A Thread that periodically wakes up to perform work at regular intervals.
|
|
96
|
+
* [Promises](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Promises.html):
|
|
97
|
+
Unified implementation of futures and promises which combines features of previous `Future`,
|
|
98
|
+
`Promise`, `IVar`, `Event`, `dataflow`, `Delay`, and (partially) `TimerTask` into a single
|
|
99
|
+
framework. It extensively uses the new synchronization layer to make all the features
|
|
100
|
+
**non-blocking** and **lock-free**, with the exception of obviously blocking operations like
|
|
101
|
+
`#wait`, `#value`. It also offers better performance.
|
|
63
102
|
|
|
64
103
|
#### Thread-safe Value Objects, Structures, and Collections
|
|
65
104
|
|
|
66
105
|
Collection classes that were originally part of the (deprecated) `thread_safe` gem:
|
|
67
106
|
|
|
68
|
-
*
|
|
69
|
-
|
|
70
|
-
*
|
|
71
|
-
|
|
107
|
+
* [Array](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Array.html) A thread-safe
|
|
108
|
+
subclass of Ruby's standard [Array](http://ruby-doc.org/core-2.2.0/Array.html).
|
|
109
|
+
* [Hash](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Hash.html) A thread-safe
|
|
110
|
+
subclass of Ruby's standard [Hash](http://ruby-doc.org/core-2.2.0/Hash.html).
|
|
111
|
+
* [Set](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Set.html) A thread-safe
|
|
112
|
+
subclass of Ruby's standard [Set](http://ruby-doc.org/stdlib-2.4.0/libdoc/set/rdoc/Set.html).
|
|
113
|
+
* [Map](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Map.html) A hash-like object
|
|
114
|
+
that should have much better performance characteristics, especially under high concurrency,
|
|
115
|
+
than `Concurrent::Hash`.
|
|
116
|
+
* [Tuple](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Tuple.html) A fixed size
|
|
117
|
+
array with volatile (synchronized, thread safe) getters/setters.
|
|
72
118
|
|
|
73
119
|
Value objects inspired by other languages:
|
|
74
120
|
|
|
75
|
-
*
|
|
76
|
-
|
|
77
|
-
|
|
121
|
+
* [Maybe](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Maybe.html) A thread-safe,
|
|
122
|
+
immutable object representing an optional value, based on
|
|
123
|
+
[Haskell Data.Maybe](https://hackage.haskell.org/package/base-4.2.0.1/docs/Data-Maybe.html).
|
|
78
124
|
|
|
79
125
|
Structure classes derived from Ruby's [Struct](http://ruby-doc.org/core-2.2.0/Struct.html):
|
|
80
126
|
|
|
81
|
-
*
|
|
82
|
-
|
|
83
|
-
*
|
|
127
|
+
* [ImmutableStruct](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/ImmutableStruct.html)
|
|
128
|
+
Immutable struct where values are set at construction and cannot be changed later.
|
|
129
|
+
* [MutableStruct](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/MutableStruct.html)
|
|
130
|
+
Synchronized, mutable struct where values can be safely changed at any time.
|
|
131
|
+
* [SettableStruct](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/SettableStruct.html)
|
|
132
|
+
Synchronized, write-once struct where values can be set at most once, either at construction
|
|
133
|
+
or any time thereafter.
|
|
84
134
|
|
|
85
135
|
Thread-safe variables:
|
|
86
136
|
|
|
87
|
-
*
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
*
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
*
|
|
94
|
-
|
|
95
|
-
*
|
|
137
|
+
* [Agent](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Agent.html): A way to
|
|
138
|
+
manage shared, mutable, *asynchronous*, independent state. Based on Clojure's
|
|
139
|
+
[Agent](http://clojure.org/agents).
|
|
140
|
+
* [Atom](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Atom.html): A way to manage
|
|
141
|
+
shared, mutable, *synchronous*, independent state. Based on Clojure's
|
|
142
|
+
[Atom](http://clojure.org/atoms).
|
|
143
|
+
* [AtomicBoolean](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/AtomicBoolean.html)
|
|
144
|
+
A boolean value that can be updated atomically.
|
|
145
|
+
* [AtomicFixnum](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/AtomicFixnum.html)
|
|
146
|
+
A numeric value that can be updated atomically.
|
|
147
|
+
* [AtomicReference](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/MutexAtomic.html)
|
|
148
|
+
An object reference that may be updated atomically.
|
|
149
|
+
* [Exchanger](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Exchanger.html)
|
|
150
|
+
A synchronization point at which threads can pair and swap elements within pairs. Based on
|
|
151
|
+
Java's [Exchanger](http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Exchanger.html).
|
|
152
|
+
* [MVar](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/MVar.html) A synchronized
|
|
153
|
+
single element container. Based on Haskell's
|
|
154
|
+
[MVar](https://hackage.haskell.org/package/base-4.8.1.0/docs/Control-Concurrent-MVar.html) and
|
|
155
|
+
Scala's [MVar](http://docs.typelevel.org/api/scalaz/nightly/index.html#scalaz.concurrent.MVar$).
|
|
156
|
+
* [ThreadLocalVar](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/ThreadLocalVar.html)
|
|
157
|
+
A variable where the value is different for each thread.
|
|
158
|
+
* [TVar](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/TVar.html) A transactional
|
|
159
|
+
variable implementing software transactional memory (STM). Based on Clojure's
|
|
160
|
+
[Ref](http://clojure.org/refs).
|
|
96
161
|
|
|
97
162
|
#### Java-inspired ThreadPools and Other Executors
|
|
98
163
|
|
|
99
|
-
*
|
|
164
|
+
* See the [thread pool](http://ruby-concurrency.github.io/concurrent-ruby/master/file.thread_pools.html)
|
|
165
|
+
overview, which also contains a list of other Executors available.
|
|
100
166
|
|
|
101
167
|
#### Thread Synchronization Classes and Algorithms
|
|
102
168
|
|
|
103
|
-
*
|
|
104
|
-
|
|
105
|
-
*
|
|
106
|
-
|
|
107
|
-
*
|
|
108
|
-
|
|
109
|
-
*
|
|
110
|
-
|
|
169
|
+
* [CountDownLatch](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/CountDownLatch.html)
|
|
170
|
+
A synchronization object that allows one thread to wait on multiple other threads.
|
|
171
|
+
* [CyclicBarrier](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/CyclicBarrier.html)
|
|
172
|
+
A synchronization aid that allows a set of threads to all wait for each other to reach a common barrier point.
|
|
173
|
+
* [Event](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Event.html) Old school
|
|
174
|
+
kernel-style event.
|
|
175
|
+
* [ReadWriteLock](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/ReadWriteLock.html)
|
|
176
|
+
A lock that supports multiple readers but only one writer.
|
|
177
|
+
* [ReentrantReadWriteLock](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/ReentrantReadWriteLock.html)
|
|
178
|
+
A read/write lock with reentrant and upgrade features.
|
|
179
|
+
* [Semaphore](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Semaphore.html)
|
|
180
|
+
A counting-based locking mechanism that uses permits.
|
|
181
|
+
* [AtomicMarkableReference](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Atomic/AtomicMarkableReference.html)
|
|
182
|
+
|
|
183
|
+
#### Deprecated
|
|
184
|
+
|
|
185
|
+
Deprecated features are still available and bugs are being fixed, but new features will not be added.
|
|
186
|
+
|
|
187
|
+
* ~~[Future](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Future.html):
|
|
188
|
+
An asynchronous operation that produces a value.~~ Replaced by
|
|
189
|
+
[Promises](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Promises.html).
|
|
190
|
+
* ~~[.dataflow](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent.html#dataflow-class_method):
|
|
191
|
+
Built on Futures, Dataflow allows you to create a task that will be scheduled when all of
|
|
192
|
+
its data dependencies are available.~~ Replaced by
|
|
193
|
+
[Promises](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Promises.html).
|
|
194
|
+
* ~~[Promise](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Promise.html): Similar
|
|
195
|
+
to Futures, with more features.~~ Replaced by
|
|
196
|
+
[Promises](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Promises.html).
|
|
197
|
+
* ~~[Delay](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Delay.html) Lazy evaluation
|
|
198
|
+
of a block yielding an immutable result. Based on Clojure's
|
|
199
|
+
[delay](https://clojuredocs.org/clojure.core/delay).~~ Replaced by
|
|
200
|
+
[Promises](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Promises.html).
|
|
201
|
+
* ~~[IVar](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/IVar.html) Similar to a
|
|
202
|
+
"future" but can be manually assigned once, after which it becomes immutable.~~ Replaced by
|
|
203
|
+
[Promises](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Promises.html).
|
|
204
|
+
|
|
111
205
|
### Edge Features
|
|
112
206
|
|
|
113
207
|
These are available in the `concurrent-ruby-edge` companion gem.
|
|
114
208
|
|
|
115
209
|
These features are under active development and may change frequently. They are expected not to
|
|
116
210
|
keep backward compatibility (there may also lack tests and documentation). Semantic versions will
|
|
117
|
-
be obeyed though. Features developed in `concurrent-ruby-edge` are expected to move to
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
*
|
|
131
|
-
*
|
|
132
|
-
*
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
- **Channel** - Brand new implementation; partial documentation and tests; stability is good.
|
|
143
|
-
- **LazyRegister** - Missing documentation and tests.
|
|
144
|
-
- **AtomicMarkableReference, LockFreeLinkedSet, LockFreeStack** - Need real world battle testing.
|
|
211
|
+
be obeyed though. Features developed in `concurrent-ruby-edge` are expected to move to
|
|
212
|
+
`concurrent-ruby` when final.
|
|
213
|
+
|
|
214
|
+
* [Actor](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Actor.html): Implements
|
|
215
|
+
the Actor Model, where concurrent actors exchange messages.
|
|
216
|
+
*Status: Partial documentation and tests; depends on new future/promise framework; stability is good.*
|
|
217
|
+
* [Channel](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Channel.html):
|
|
218
|
+
Communicating Sequential Processes ([CSP](https://en.wikipedia.org/wiki/Communicating_sequential_processes)).
|
|
219
|
+
Functionally equivalent to Go [channels](https://tour.golang.org/concurrency/2) with additional
|
|
220
|
+
inspiration from Clojure [core.async](https://clojure.github.io/core.async/).
|
|
221
|
+
*Status: Partial documentation and tests.*
|
|
222
|
+
* [LazyRegister](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/LazyRegister.html)
|
|
223
|
+
* [LockFreeLinkedSet](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/Edge/LockFreeLinkedSet.html)
|
|
224
|
+
*Status: will be moved to core soon.*
|
|
225
|
+
* [LockFreeStack](http://ruby-concurrency.github.io/concurrent-ruby/master/Concurrent/LockFreeStack.html)
|
|
226
|
+
*Status: missing documentation and tests.*
|
|
227
|
+
|
|
228
|
+
## Supported Ruby versions
|
|
229
|
+
|
|
230
|
+
MRI 2.0 and above, JRuby 9000, TruffleRuby are supported.
|
|
231
|
+
This gem should be fully compatible with any interpreter that is compliant with Ruby 2.0 or newer.
|
|
232
|
+
Java 8 is preferred for JRuby but every Java version on which JRuby 9000 runs is supported.
|
|
233
|
+
|
|
234
|
+
The legacy support for Rubinius is kept but it is no longer maintained, if you would like to help
|
|
235
|
+
please respond to [#739](https://github.com/ruby-concurrency/concurrent-ruby/issues/739).
|
|
145
236
|
|
|
146
237
|
## Usage
|
|
147
238
|
|
|
@@ -151,13 +242,16 @@ Everything within this gem can be loaded simply by requiring it:
|
|
|
151
242
|
require 'concurrent'
|
|
152
243
|
```
|
|
153
244
|
|
|
245
|
+
*Requiring only specific abstractions from Concurrent Ruby is not yet supported.*
|
|
246
|
+
|
|
154
247
|
To use the tools in the Edge gem it must be required separately:
|
|
155
248
|
|
|
156
249
|
```ruby
|
|
157
250
|
require 'concurrent-edge'
|
|
158
251
|
```
|
|
159
252
|
|
|
160
|
-
If the library does not behave as expected, `Concurrent.use_stdlib_logger(Logger::DEBUG)` could
|
|
253
|
+
If the library does not behave as expected, `Concurrent.use_stdlib_logger(Logger::DEBUG)` could
|
|
254
|
+
help to reveal the problem.
|
|
161
255
|
|
|
162
256
|
## Installation
|
|
163
257
|
|
|
@@ -193,9 +287,9 @@ and run `bundle install` from your shell.
|
|
|
193
287
|
### C Extensions for MRI
|
|
194
288
|
|
|
195
289
|
Potential performance improvements may be achieved under MRI by installing optional C extensions.
|
|
196
|
-
To
|
|
197
|
-
gem. `concurrent-ruby` and `concurrent-ruby-ext` are always released together with same
|
|
198
|
-
Simply install the extension gem too:
|
|
290
|
+
To minimise installation errors the C extensions are available in the `concurrent-ruby-ext`
|
|
291
|
+
extension gem. `concurrent-ruby` and `concurrent-ruby-ext` are always released together with same
|
|
292
|
+
version. Simply install the extension gem too:
|
|
199
293
|
|
|
200
294
|
```ruby
|
|
201
295
|
gem install concurrent-ruby-ext
|
|
@@ -220,28 +314,32 @@ and load the appropriate C extensions.
|
|
|
220
314
|
|
|
221
315
|
#### Note For gem developers
|
|
222
316
|
|
|
223
|
-
No gems should depend on `concurrent-ruby-ext`. Doing so will force C extensions on your users.
|
|
224
|
-
|
|
317
|
+
No gems should depend on `concurrent-ruby-ext`. Doing so will force C extensions on your users. The
|
|
318
|
+
best practice is to depend on `concurrent-ruby` and let users to decide if they want C extensions.
|
|
225
319
|
|
|
226
320
|
## Maintainers
|
|
227
321
|
|
|
228
|
-
*
|
|
229
|
-
*
|
|
230
|
-
*
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
322
|
+
* [Petr Chalupa](https://github.com/pitr-ch) (lead maintainer, point-of-contact)
|
|
323
|
+
* [Jerry D'Antonio](https://github.com/jdantonio) (creator)
|
|
324
|
+
* [Chris Seaton](https://github.com/chrisseaton)
|
|
325
|
+
|
|
326
|
+
### Special Thanks to
|
|
327
|
+
|
|
328
|
+
* [Brian Durand](https://github.com/bdurand) for the `ref` gem
|
|
329
|
+
* [Charles Oliver Nutter](https://github.com/headius) for the `atomic` and `thread_safe` gems
|
|
330
|
+
* [thedarkone](https://github.com/thedarkone) for the `thread_safe` gem
|
|
234
331
|
|
|
235
|
-
|
|
332
|
+
and to the past maintainers
|
|
236
333
|
|
|
237
|
-
*
|
|
238
|
-
*
|
|
239
|
-
*
|
|
334
|
+
* [Michele Della Torre](https://github.com/mighe)
|
|
335
|
+
* [Paweł Obrok](https://github.com/obrok)
|
|
336
|
+
* [Lucas Allan](https://github.com/lucasallan)
|
|
240
337
|
|
|
241
338
|
## License and Copyright
|
|
242
339
|
|
|
243
|
-
*Concurrent Ruby* is free software released under the
|
|
340
|
+
*Concurrent Ruby* is free software released under the
|
|
341
|
+
[MIT License](http://www.opensource.org/licenses/MIT).
|
|
244
342
|
|
|
245
|
-
The *Concurrent Ruby* [logo](https://github.com/ruby-concurrency/concurrent-ruby/wiki/Logo)
|
|
246
|
-
|
|
247
|
-
|
|
343
|
+
The *Concurrent Ruby* [logo](https://github.com/ruby-concurrency/concurrent-ruby/wiki/Logo) was
|
|
344
|
+
designed by [David Jones](https://twitter.com/zombyboy). It is Copyright © 2014
|
|
345
|
+
[Jerry D'Antonio](https://twitter.com/jerrydantonio). All Rights Reserved.
|
|
@@ -21,13 +21,12 @@ VALUE method_atomic_boolean_initialize(int argc, VALUE* argv, VALUE self) {
|
|
|
21
21
|
}
|
|
22
22
|
|
|
23
23
|
VALUE method_atomic_boolean_value(VALUE self) {
|
|
24
|
-
return
|
|
24
|
+
return(ir_get(self));
|
|
25
25
|
}
|
|
26
26
|
|
|
27
27
|
VALUE method_atomic_boolean_value_set(VALUE self, VALUE value) {
|
|
28
28
|
VALUE new_value = TRUTHY(value);
|
|
29
|
-
|
|
30
|
-
return(new_value);
|
|
29
|
+
return(ir_set(self, new_value));
|
|
31
30
|
}
|
|
32
31
|
|
|
33
32
|
VALUE method_atomic_boolean_true_question(VALUE self) {
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
@@ -7,8 +7,38 @@
|
|
|
7
7
|
/*#include <libkern/OSAtomic.h>*/
|
|
8
8
|
/*#endif*/
|
|
9
9
|
|
|
10
|
+
/*
|
|
11
|
+
Following the wisdom of postgres, we opt to use platform specific memory barriers when available.
|
|
12
|
+
These are generally more performant. In this PR, we add specific cases for i386, x86_64.
|
|
13
|
+
|
|
14
|
+
In the future, we could look at using pg's atomics library directly:
|
|
15
|
+
https://github.com/postgres/postgres/tree/9d4649ca49416111aee2c84b7e4441a0b7aa2fac/src/include/port/atomics
|
|
16
|
+
|
|
17
|
+
Point of contact @ianks
|
|
18
|
+
*/
|
|
19
|
+
|
|
10
20
|
#include "atomic_reference.h"
|
|
11
21
|
|
|
22
|
+
#if (defined(__i386__) || defined(__i386)) && (defined(__GNUC__) || defined(__INTEL_COMPILER))
|
|
23
|
+
#define memory_barrier() \
|
|
24
|
+
__asm__ __volatile__ ("lock; addl $0,0(%%esp)" : : : "memory", "cc")
|
|
25
|
+
#elif defined(__x86_64__) && (defined(__GNUC__) || defined(__INTEL_COMPILER))
|
|
26
|
+
#define memory_barrier() \
|
|
27
|
+
__asm__ __volatile__ ("lock; addl $0,0(%%rsp)" : : : "memory", "cc")
|
|
28
|
+
#elif defined(HAVE_GCC__ATOMIC_INT32_CAS)
|
|
29
|
+
#define memory_barrier() \
|
|
30
|
+
__atomic_thread_fence(__ATOMIC_SEQ_CST)
|
|
31
|
+
#elif (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 1))
|
|
32
|
+
#define memory_barrier() \
|
|
33
|
+
__sync_synchronize();
|
|
34
|
+
#elif defined _MSC_VER
|
|
35
|
+
#define memory_barrier() \
|
|
36
|
+
MemoryBarrier();
|
|
37
|
+
#elif __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__ >= 1050
|
|
38
|
+
#define memory_barrier() \
|
|
39
|
+
OSMemoryBarrier();
|
|
40
|
+
#endif
|
|
41
|
+
|
|
12
42
|
void ir_mark(void *value) {
|
|
13
43
|
rb_gc_mark_maybe((VALUE) value);
|
|
14
44
|
}
|
|
@@ -27,25 +57,13 @@ VALUE ir_initialize(int argc, VALUE* argv, VALUE self) {
|
|
|
27
57
|
}
|
|
28
58
|
|
|
29
59
|
VALUE ir_get(VALUE self) {
|
|
30
|
-
|
|
31
|
-
__sync_synchronize();
|
|
32
|
-
#elif defined _MSC_VER
|
|
33
|
-
MemoryBarrier();
|
|
34
|
-
#elif __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__ >= 1050
|
|
35
|
-
OSMemoryBarrier();
|
|
36
|
-
#endif
|
|
60
|
+
memory_barrier();
|
|
37
61
|
return (VALUE) DATA_PTR(self);
|
|
38
62
|
}
|
|
39
63
|
|
|
40
64
|
VALUE ir_set(VALUE self, VALUE new_value) {
|
|
41
65
|
DATA_PTR(self) = (void *) new_value;
|
|
42
|
-
|
|
43
|
-
__sync_synchronize();
|
|
44
|
-
#elif defined _MSC_VER
|
|
45
|
-
MemoryBarrier();
|
|
46
|
-
#elif __ENVIRONMENT_MAC_OS_X_VERSION_MIN_REQUIRED__ >= 1050
|
|
47
|
-
OSMemoryBarrier();
|
|
48
|
-
#endif
|
|
66
|
+
memory_barrier();
|
|
49
67
|
return new_value;
|
|
50
68
|
}
|
|
51
69
|
|
|
File without changes
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
require 'fileutils'
|
|
2
|
+
|
|
3
|
+
extension_name = 'concurrent_ruby_ext'
|
|
4
|
+
|
|
5
|
+
require 'mkmf'
|
|
6
|
+
dir_config(extension_name)
|
|
7
|
+
have_header "libkern/OSAtomic.h"
|
|
8
|
+
|
|
9
|
+
compiler_is_gcc = (CONFIG["GCC"] && !CONFIG["GCC"].empty?) ||
|
|
10
|
+
# This could stand to be more generic... but I am afraid.
|
|
11
|
+
CONFIG["CC"] =~ /\bgcc\b/
|
|
12
|
+
|
|
13
|
+
if compiler_is_gcc
|
|
14
|
+
case CONFIG["arch"]
|
|
15
|
+
when /mswin32|mingw|solaris/
|
|
16
|
+
$CFLAGS += " -march=native"
|
|
17
|
+
when 'i686-linux'
|
|
18
|
+
$CFLAGS += " -march=i686"
|
|
19
|
+
end
|
|
20
|
+
end
|
|
21
|
+
|
|
22
|
+
create_makefile File.join('concurrent', extension_name)
|
|
File without changes
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: concurrent-ruby-ext
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.0.
|
|
4
|
+
version: 1.1.0.pre1
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Jerry D'Antonio
|
|
@@ -9,7 +9,7 @@ authors:
|
|
|
9
9
|
autorequire:
|
|
10
10
|
bindir: bin
|
|
11
11
|
cert_chain: []
|
|
12
|
-
date:
|
|
12
|
+
date: 2018-08-15 00:00:00.000000000 Z
|
|
13
13
|
dependencies:
|
|
14
14
|
- !ruby/object:Gem::Dependency
|
|
15
15
|
name: concurrent-ruby
|
|
@@ -17,41 +17,38 @@ dependencies:
|
|
|
17
17
|
requirements:
|
|
18
18
|
- - '='
|
|
19
19
|
- !ruby/object:Gem::Version
|
|
20
|
-
version: 1.0.
|
|
20
|
+
version: 1.1.0.pre1
|
|
21
21
|
type: :runtime
|
|
22
22
|
prerelease: false
|
|
23
23
|
version_requirements: !ruby/object:Gem::Requirement
|
|
24
24
|
requirements:
|
|
25
25
|
- - '='
|
|
26
26
|
- !ruby/object:Gem::Version
|
|
27
|
-
version: 1.0.
|
|
27
|
+
version: 1.1.0.pre1
|
|
28
28
|
description: |2
|
|
29
29
|
C extensions to optimize the concurrent-ruby gem when running under MRI.
|
|
30
30
|
Please see http://concurrent-ruby.com for more information.
|
|
31
31
|
email: concurrent-ruby@googlegroups.com
|
|
32
32
|
executables: []
|
|
33
33
|
extensions:
|
|
34
|
-
- ext/concurrent/extconf.rb
|
|
34
|
+
- ext/concurrent-ruby-ext/extconf.rb
|
|
35
35
|
extra_rdoc_files:
|
|
36
36
|
- README.md
|
|
37
|
-
- LICENSE.
|
|
37
|
+
- LICENSE.md
|
|
38
38
|
- CHANGELOG.md
|
|
39
39
|
files:
|
|
40
40
|
- CHANGELOG.md
|
|
41
|
-
- LICENSE.
|
|
41
|
+
- LICENSE.md
|
|
42
42
|
- README.md
|
|
43
|
-
- ext/concurrent/atomic_boolean.c
|
|
44
|
-
- ext/concurrent/atomic_boolean.h
|
|
45
|
-
- ext/concurrent/atomic_fixnum.c
|
|
46
|
-
- ext/concurrent/atomic_fixnum.h
|
|
47
|
-
- ext/concurrent/atomic_reference.c
|
|
48
|
-
- ext/concurrent/atomic_reference.h
|
|
49
|
-
- ext/concurrent/extconf.rb
|
|
50
|
-
- ext/concurrent/rb_concurrent.c
|
|
51
|
-
- ext/concurrent/ruby_193_compatible.h
|
|
52
|
-
- lib/concurrent/atomic_reference/concurrent_update_error.rb
|
|
53
|
-
- lib/concurrent/atomic_reference/direct_update.rb
|
|
54
|
-
- lib/concurrent/atomic_reference/numeric_cas_wrapper.rb
|
|
43
|
+
- ext/concurrent-ruby-ext/atomic_boolean.c
|
|
44
|
+
- ext/concurrent-ruby-ext/atomic_boolean.h
|
|
45
|
+
- ext/concurrent-ruby-ext/atomic_fixnum.c
|
|
46
|
+
- ext/concurrent-ruby-ext/atomic_fixnum.h
|
|
47
|
+
- ext/concurrent-ruby-ext/atomic_reference.c
|
|
48
|
+
- ext/concurrent-ruby-ext/atomic_reference.h
|
|
49
|
+
- ext/concurrent-ruby-ext/extconf.rb
|
|
50
|
+
- ext/concurrent-ruby-ext/rb_concurrent.c
|
|
51
|
+
- ext/concurrent-ruby-ext/ruby_193_compatible.h
|
|
55
52
|
homepage: http://www.concurrent-ruby.com
|
|
56
53
|
licenses:
|
|
57
54
|
- MIT
|
|
@@ -60,22 +57,20 @@ post_install_message:
|
|
|
60
57
|
rdoc_options: []
|
|
61
58
|
require_paths:
|
|
62
59
|
- lib
|
|
63
|
-
- ext
|
|
64
60
|
required_ruby_version: !ruby/object:Gem::Requirement
|
|
65
61
|
requirements:
|
|
66
62
|
- - ">="
|
|
67
63
|
- !ruby/object:Gem::Version
|
|
68
|
-
version:
|
|
64
|
+
version: 2.0.0
|
|
69
65
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
|
70
66
|
requirements:
|
|
71
|
-
- - "
|
|
67
|
+
- - ">"
|
|
72
68
|
- !ruby/object:Gem::Version
|
|
73
|
-
version:
|
|
69
|
+
version: 1.3.1
|
|
74
70
|
requirements: []
|
|
75
71
|
rubyforge_project:
|
|
76
|
-
rubygems_version: 2.
|
|
72
|
+
rubygems_version: 2.7.3
|
|
77
73
|
signing_key:
|
|
78
74
|
specification_version: 4
|
|
79
75
|
summary: C extensions to optimize concurrent-ruby under MRI.
|
|
80
76
|
test_files: []
|
|
81
|
-
has_rdoc:
|
data/ext/concurrent/extconf.rb
DELETED
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-
require 'fileutils'
|
|
2
|
-
|
|
3
|
-
$:.unshift(File.expand_path('../../../lib', __FILE__))
|
|
4
|
-
require 'concurrent/utility/native_extension_loader'
|
|
5
|
-
|
|
6
|
-
EXTENSION_NAME = 'extension'
|
|
7
|
-
|
|
8
|
-
def create_dummy_makefile
|
|
9
|
-
File.open('Makefile', 'w') do |f|
|
|
10
|
-
f.puts 'all:'
|
|
11
|
-
f.puts 'install:'
|
|
12
|
-
end
|
|
13
|
-
end
|
|
14
|
-
|
|
15
|
-
if Concurrent.on_jruby? || ! Concurrent.allow_c_extensions?
|
|
16
|
-
create_dummy_makefile
|
|
17
|
-
warn 'C optimizations are not supported on this version of Ruby.'
|
|
18
|
-
else
|
|
19
|
-
begin
|
|
20
|
-
|
|
21
|
-
require 'mkmf'
|
|
22
|
-
dir_config(EXTENSION_NAME)
|
|
23
|
-
|
|
24
|
-
have_header "libkern/OSAtomic.h"
|
|
25
|
-
|
|
26
|
-
def compiler_is_gcc
|
|
27
|
-
if CONFIG["GCC"] && CONFIG["GCC"] != ""
|
|
28
|
-
return true
|
|
29
|
-
elsif ( # This could stand to be more generic... but I am afraid.
|
|
30
|
-
CONFIG["CC"] =~ /\bgcc\b/
|
|
31
|
-
)
|
|
32
|
-
return true
|
|
33
|
-
end
|
|
34
|
-
return false
|
|
35
|
-
end
|
|
36
|
-
|
|
37
|
-
if compiler_is_gcc
|
|
38
|
-
case CONFIG["arch"]
|
|
39
|
-
when /mswin32|mingw|solaris/
|
|
40
|
-
$CFLAGS += " -march=native"
|
|
41
|
-
when 'i686-linux'
|
|
42
|
-
$CFLAGS += " -march=i686"
|
|
43
|
-
end
|
|
44
|
-
end
|
|
45
|
-
|
|
46
|
-
try_run(<<CODE,$CFLAGS) && ($defs << '-DHAVE_GCC_SYNC')
|
|
47
|
-
int main() {
|
|
48
|
-
__sync_synchronize();
|
|
49
|
-
return 0;
|
|
50
|
-
}
|
|
51
|
-
CODE
|
|
52
|
-
|
|
53
|
-
create_makefile('concurrent/' + EXTENSION_NAME)
|
|
54
|
-
rescue
|
|
55
|
-
create_dummy_makefile
|
|
56
|
-
warn 'C optimizations cannot be compiled on this version of Ruby.'
|
|
57
|
-
end
|
|
58
|
-
end
|
|
@@ -1,81 +0,0 @@
|
|
|
1
|
-
require 'concurrent/atomic_reference/concurrent_update_error'
|
|
2
|
-
|
|
3
|
-
module Concurrent
|
|
4
|
-
|
|
5
|
-
# Define update methods that use direct paths
|
|
6
|
-
#
|
|
7
|
-
# @!visibility private
|
|
8
|
-
# @!macro internal_implementation_note
|
|
9
|
-
module AtomicDirectUpdate
|
|
10
|
-
|
|
11
|
-
# @!macro [attach] atomic_reference_method_update
|
|
12
|
-
#
|
|
13
|
-
# Pass the current value to the given block, replacing it
|
|
14
|
-
# with the block's result. May retry if the value changes
|
|
15
|
-
# during the block's execution.
|
|
16
|
-
#
|
|
17
|
-
# @yield [Object] Calculate a new value for the atomic reference using
|
|
18
|
-
# given (old) value
|
|
19
|
-
# @yieldparam [Object] old_value the starting value of the atomic reference
|
|
20
|
-
#
|
|
21
|
-
# @return [Object] the new value
|
|
22
|
-
def update
|
|
23
|
-
true until compare_and_set(old_value = get, new_value = yield(old_value))
|
|
24
|
-
new_value
|
|
25
|
-
end
|
|
26
|
-
|
|
27
|
-
# @!macro [attach] atomic_reference_method_try_update
|
|
28
|
-
#
|
|
29
|
-
# Pass the current value to the given block, replacing it
|
|
30
|
-
# with the block's result. Return nil if the update fails.
|
|
31
|
-
#
|
|
32
|
-
# @yield [Object] Calculate a new value for the atomic reference using
|
|
33
|
-
# given (old) value
|
|
34
|
-
# @yieldparam [Object] old_value the starting value of the atomic reference
|
|
35
|
-
#
|
|
36
|
-
# @note This method was altered to avoid raising an exception by default.
|
|
37
|
-
# Instead, this method now returns `nil` in case of failure. For more info,
|
|
38
|
-
# please see: https://github.com/ruby-concurrency/concurrent-ruby/pull/336
|
|
39
|
-
#
|
|
40
|
-
# @return [Object] the new value, or nil if update failed
|
|
41
|
-
def try_update
|
|
42
|
-
old_value = get
|
|
43
|
-
new_value = yield old_value
|
|
44
|
-
|
|
45
|
-
return unless compare_and_set old_value, new_value
|
|
46
|
-
|
|
47
|
-
new_value
|
|
48
|
-
end
|
|
49
|
-
|
|
50
|
-
# @!macro [attach] atomic_reference_method_try_update!
|
|
51
|
-
#
|
|
52
|
-
# Pass the current value to the given block, replacing it
|
|
53
|
-
# with the block's result. Raise an exception if the update
|
|
54
|
-
# fails.
|
|
55
|
-
#
|
|
56
|
-
# @yield [Object] Calculate a new value for the atomic reference using
|
|
57
|
-
# given (old) value
|
|
58
|
-
# @yieldparam [Object] old_value the starting value of the atomic reference
|
|
59
|
-
#
|
|
60
|
-
# @note This behavior mimics the behavior of the original
|
|
61
|
-
# `AtomicReference#try_update` API. The reason this was changed was to
|
|
62
|
-
# avoid raising exceptions (which are inherently slow) by default. For more
|
|
63
|
-
# info: https://github.com/ruby-concurrency/concurrent-ruby/pull/336
|
|
64
|
-
#
|
|
65
|
-
# @return [Object] the new value
|
|
66
|
-
#
|
|
67
|
-
# @raise [Concurrent::ConcurrentUpdateError] if the update fails
|
|
68
|
-
def try_update!
|
|
69
|
-
old_value = get
|
|
70
|
-
new_value = yield old_value
|
|
71
|
-
unless compare_and_set(old_value, new_value)
|
|
72
|
-
if $VERBOSE
|
|
73
|
-
raise ConcurrentUpdateError, "Update failed"
|
|
74
|
-
else
|
|
75
|
-
raise ConcurrentUpdateError, "Update failed", ConcurrentUpdateError::CONC_UP_ERR_BACKTRACE
|
|
76
|
-
end
|
|
77
|
-
end
|
|
78
|
-
new_value
|
|
79
|
-
end
|
|
80
|
-
end
|
|
81
|
-
end
|
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
module Concurrent
|
|
2
|
-
|
|
3
|
-
# Special "compare and set" handling of numeric values.
|
|
4
|
-
#
|
|
5
|
-
# @!visibility private
|
|
6
|
-
# @!macro internal_implementation_note
|
|
7
|
-
module AtomicNumericCompareAndSetWrapper
|
|
8
|
-
|
|
9
|
-
# @!macro atomic_reference_method_compare_and_set
|
|
10
|
-
def compare_and_set(old_value, new_value)
|
|
11
|
-
if old_value.kind_of? Numeric
|
|
12
|
-
while true
|
|
13
|
-
old = get
|
|
14
|
-
|
|
15
|
-
return false unless old.kind_of? Numeric
|
|
16
|
-
|
|
17
|
-
return false unless old == old_value
|
|
18
|
-
|
|
19
|
-
result = _compare_and_set(old, new_value)
|
|
20
|
-
return result if result
|
|
21
|
-
end
|
|
22
|
-
else
|
|
23
|
-
_compare_and_set(old_value, new_value)
|
|
24
|
-
end
|
|
25
|
-
end
|
|
26
|
-
alias_method :compare_and_swap, :compare_and_set
|
|
27
|
-
end
|
|
28
|
-
end
|