farce 0.2.0-x86_64-linux-gnu → 0.4.0-x86_64-linux-gnu

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95a80efa39413410cb58c9838346a6b0f22f3f2257e2343ba9e200a0c70bd888
-  data.tar.gz: f813bef3e5b5e4d8fbdeee9651810a3695924c33cbae33d00a21751691ba47d1
+  metadata.gz: 25af3aeb5510f2a334aa0774b2786be7ceaa56556a1b796b7182d011ac0568c1
+  data.tar.gz: 1a6990110f28469088b087bff007fb3cef4524cd48ab475c1493122abead87b1
 SHA512:
-  metadata.gz: 1d6bb887f88615c3ca8ec63343900f3f0ff3d0056f51f722c91f3739170e8c7a91f890466646eb7b539e661d68299d1ad42c3175ffd777faf05fc542d6b23f35
-  data.tar.gz: 95b72aabc1e151d71c9a6aea389fb639cdf8d90ed3f87507cd433596d8a8482962c6c84e09032b53ab4e0311f9346a9e7a69407e8ba19435e1851e92dcabfc28
+  metadata.gz: d526a15f67b128c664afe5f53e553fb1c2bef266296f36f7b5d692e5b21f937ed66b94994cb9ef7148b6d51b08c4f4324a42c8c22f96669c416db8a09dabc279
+  data.tar.gz: 45bed6e2ad45e7f35da5f4d963ec24e6c3403ce37db2e011c83df2a44fd254c105a362b4cd2394e7ef833d1290de959a0b2ace63abbbc15373fdc4f7537f86de

data/CHANGELOG.md

@@ -4,6 +4,97 @@ Farce follows [Semantic Versioning 2.0](http://semver.org/). Any public method o
 
 ## Development Releases
 
+### Farce 0.4.0 (2026-10-16)
+
+#### New Features
+
+##### Ractor Backports
+
+`Farce::Backports` makes newer Ractor APIs available on older Ruby versions:
+
+* Added `Ractor#default_port`, `#join`, `#monitor`, `#unmonitor`, and `#value` on Ruby versions prior to 4.0.
+* Added `Ractor#alive?` on Ruby versions prior to 4.1.
+* Added optional `timeout:` support for `Ractor.select`, `Ractor#receive`, and `Ractor::Port#receive` on Ruby versions prior to 4.1.
+
+You can activate the backports for a lexical scope with `using Farce::Backports`, install them globally with `Farce::Backports.install`, or call methods on `Farce::Backports` directly.
+Global installation also defines `Ractor` and `Ractor::Port` when they are not natively available.
+
+```ruby
+using Farce::Backports
+
+ractor = Farce::Ractor.new { 42 }
+ractor.join
+ractor.value # => 42
+```
+
+##### Ractor Improvements
+
+* `Farce::Ractor.select` is now implemented on JRuby and TruffleRuby. It supports selecting from Ractors and ports, optional timeouts, and waiting without blocking a Fiber scheduler.
+* The Ractor polyfill now supports `alive?` and follows Ruby 4.1's `monitor` notification format when running on Ruby 4.1 or later.
+
+##### Miscellaneous
+
+* Added `set?` and `unset?` predicates to `Flag` and `Local::Flag`.
+* Added `Farce::NULL_PORT`, a write-only port that discards messages and can be used to ignore Ractor exit notifications.
+* Added `Farce::System.ruby_version`, which returns the current Ruby release as a version object without prerelease suffixes. It can be called from any Ractor.
+* Added `Farce::Extension` to easily define modules that can be used both as refinements or installed globally into existing classes, used by `Farce::Backports`.
+
+#### Bug Fixes
+
+* Work around a JRuby synchronization race that could lose a mutex wakeup and leave a scheduled Fiber blocked.
+
+#### Other changes
+
+* Reorganized the README into a shorter introduction with topic-specific guides in the docs directory.
+* Updated compatibility documentation and tests for `ractor-tmvar` 0.4.0.
+
+### Farce 0.3.0 (2026-10-13)
+
+#### New Features
+
+##### Breaking Changes
+
+* `Abstract::Scheduler` is no longer a superclass of `Pool`. Use `Abstract::Executor` instead.
+
+##### Executor Improvements
+
+`Scheduler` and `Pool` have the following improvements:
+
+* They now support `try_schedule`, which discards tasks and returns `nil` when their internal queues are at capacity.
+* They now have `Unshared` and `Local` variants, running in a Ractor-local context (Pool will manage a Thread pool instead of a Ractor pool).
+
+Creates a thread pool with a maximum size of 2 and a queue capacity of 10:
+
+```ruby
+# A thread pool local to the current Ractor
+thread_pool = Farce::Unshared::Pool.new(max_size: 2, capacity: 10)
+
+# this should only run approximately 10 tasks on CRuby
+500.times { thread_pool.try_schedule { puts "Task executed" } }
+```
+
+##### Tasks
+
+A new class, `Task`, has been introduced to represent asynchronous tasks that can be scheduled and executed within Farce's executor framework,
+executed manually, or handed off to any other executor supporting procs or callable objects.
+
+```ruby
+task = Farce::Task.schedule do
+  puts "Task started"
+  sleep 1
+  :success
+ensure
+  puts "Task finished"
+end
+
+task.alive? # => true
+task.value  # => :success (blocks until the task completes)
+```
+
+#### Bug Fixes
+
+* Calling `wait_*` methods on atoms on JRuby no longer blocks a fiber scheduler.
+
 ### Farce 0.2.0 (2026-10-11)
 
 #### New Features