nio4r 2.5.7 → 2.7.3

data/ext/nio4r/selector.c

@@ -23,9 +23,10 @@ static VALUE cNIO_Selector = Qnil;
 
 /* Allocator/deallocator */
 static VALUE NIO_Selector_allocate(VALUE klass);
-static void NIO_Selector_mark(struct NIO_Selector *loop);
+static void NIO_Selector_mark(void *data);
 static void NIO_Selector_shutdown(struct NIO_Selector *selector);
-static void NIO_Selector_free(struct NIO_Selector *loop);
+static void NIO_Selector_free(void *data);
+static size_t NIO_Selector_memsize(const void *data);
 
 /* Class methods */
 static VALUE NIO_Selector_supported_backends(VALUE klass);
@@ -43,13 +44,13 @@ static VALUE NIO_Selector_closed(VALUE self);
 static VALUE NIO_Selector_is_empty(VALUE self);
 
 /* Internal functions */
-static VALUE NIO_Selector_synchronize(VALUE self, VALUE (*func)(VALUE *args), VALUE *args);
+static VALUE NIO_Selector_synchronize(VALUE self, VALUE (*func)(VALUE arg), VALUE arg);
 static VALUE NIO_Selector_unlock(VALUE lock);
-static VALUE NIO_Selector_register_synchronized(VALUE *args);
-static VALUE NIO_Selector_deregister_synchronized(VALUE *args);
-static VALUE NIO_Selector_select_synchronized(VALUE *args);
-static VALUE NIO_Selector_close_synchronized(VALUE *args);
-static VALUE NIO_Selector_closed_synchronized(VALUE *args);
+static VALUE NIO_Selector_register_synchronized(VALUE arg);
+static VALUE NIO_Selector_deregister_synchronized(VALUE arg);
+static VALUE NIO_Selector_select_synchronized(VALUE arg);
+static VALUE NIO_Selector_close_synchronized(VALUE arg);
+static VALUE NIO_Selector_closed_synchronized(VALUE arg);
 
 static int NIO_Selector_run(struct NIO_Selector *selector, VALUE timeout);
 static void NIO_Selector_timeout_callback(struct ev_loop *ev_loop, struct ev_timer *timer, int revents);
@@ -62,7 +63,7 @@ static void NIO_Selector_wakeup_callback(struct ev_loop *ev_loop, struct ev_io *
 #define BUSYWAIT_INTERVAL 0.01
 
 /* Selectors wait for events */
-void Init_NIO_Selector()
+void Init_NIO_Selector(void)
 {
     mNIO = rb_define_module("NIO");
     cNIO_Selector = rb_define_class_under(mNIO, "Selector", rb_cObject);
@@ -83,6 +84,18 @@ void Init_NIO_Selector()
     cNIO_Monitor = rb_define_class_under(mNIO, "Monitor", rb_cObject);
 }
 
+static const rb_data_type_t NIO_Selector_type = {
+    "NIO::Selector",
+    {
+        NIO_Selector_mark,
+        NIO_Selector_free,
+        NIO_Selector_memsize,
+    },
+    0,
+    0,
+    RUBY_TYPED_WB_PROTECTED // Don't free immediately because of shutdown
+};
+
 /* Create the libev event loop and incoming event buffer */
 static VALUE NIO_Selector_allocate(VALUE klass)
 {
@@ -104,8 +117,7 @@ static VALUE NIO_Selector_allocate(VALUE klass)
         rb_sys_fail("fcntl");
     }
 
-    selector = (struct NIO_Selector *)xmalloc(sizeof(struct NIO_Selector));
-
+    VALUE obj = TypedData_Make_Struct(klass, struct NIO_Selector, &NIO_Selector_type, selector);
     /* Defer initializing the loop to #initialize */
     selector->ev_loop = 0;
 
@@ -118,14 +130,21 @@ static VALUE NIO_Selector_allocate(VALUE klass)
     selector->wakeup.data = (void *)selector;
 
     selector->closed = selector->selecting = selector->wakeup_fired = selector->ready_count = 0;
-    selector->ready_array = Qnil;
+    RB_OBJ_WRITE(obj, &selector->ready_array, Qnil);
+    return obj;
+}
 
-    return Data_Wrap_Struct(klass, NIO_Selector_mark, NIO_Selector_free, selector);
+struct NIO_Selector *NIO_Selector_unwrap(VALUE self)
+{
+    struct NIO_Selector *selector;
+    TypedData_Get_Struct(self, struct NIO_Selector, &NIO_Selector_type, selector);
+    return selector;
 }
 
 /* NIO selectors store all Ruby objects in instance variables so mark is a stub */
-static void NIO_Selector_mark(struct NIO_Selector *selector)
+static void NIO_Selector_mark(void *data)
 {
+    struct NIO_Selector *selector = (struct NIO_Selector *)data;
     if (selector->ready_array != Qnil) {
         rb_gc_mark(selector->ready_array);
     }
@@ -151,12 +170,18 @@ static void NIO_Selector_shutdown(struct NIO_Selector *selector)
 }
 
 /* Ruby finalizer for selector objects */
-static void NIO_Selector_free(struct NIO_Selector *selector)
+static void NIO_Selector_free(void *data)
 {
+    struct NIO_Selector *selector = (struct NIO_Selector *)data;
     NIO_Selector_shutdown(selector);
     xfree(selector);
 }
 
+static size_t NIO_Selector_memsize(const void *data)
+{
+    return sizeof(struct NIO_Selector);
+}
+
 /* Return an array of symbols for supported backends */
 static VALUE NIO_Selector_supported_backends(VALUE klass)
 {
@@ -205,7 +230,7 @@ static VALUE NIO_Selector_initialize(int argc, VALUE *argv, VALUE self)
     struct NIO_Selector *selector;
     unsigned int flags = 0;
 
-    Data_Get_Struct(self, struct NIO_Selector, selector);
+    TypedData_Get_Struct(self, struct NIO_Selector, &NIO_Selector_type, selector);
 
     rb_scan_args(argc, argv, "01", &backend);
 
@@ -259,7 +284,7 @@ static VALUE NIO_Selector_backend(VALUE self)
 {
     struct NIO_Selector *selector;
 
-    Data_Get_Struct(self, struct NIO_Selector, selector);
+    TypedData_Get_Struct(self, struct NIO_Selector, &NIO_Selector_type, selector);
     if (selector->closed) {
         rb_raise(rb_eIOError, "selector is closed");
     }
@@ -285,7 +310,7 @@ static VALUE NIO_Selector_backend(VALUE self)
 }
 
 /* Synchronize around a reentrant selector lock */
-static VALUE NIO_Selector_synchronize(VALUE self, VALUE (*func)(VALUE *args), VALUE *args)
+static VALUE NIO_Selector_synchronize(VALUE self, VALUE (*func)(VALUE arg), VALUE arg)
 {
     VALUE current_thread, lock_holder, lock;
 
@@ -298,10 +323,10 @@ static VALUE NIO_Selector_synchronize(VALUE self, VALUE (*func)(VALUE *args), VA
         rb_ivar_set(self, rb_intern("lock_holder"), current_thread);
 
         /* We've acquired the lock, so ensure we unlock it */
-        return rb_ensure(func, (VALUE)args, NIO_Selector_unlock, self);
+        return rb_ensure(func, (VALUE)arg, NIO_Selector_unlock, self);
     } else {
         /* We already hold the selector lock, so no need to unlock it */
-        return func(args);
+        return func(arg);
     }
 }
 
@@ -321,22 +346,23 @@ static VALUE NIO_Selector_unlock(VALUE self)
 /* Register an IO object with the selector for the given interests */
 static VALUE NIO_Selector_register(VALUE self, VALUE io, VALUE interests)
 {
-    VALUE args[3] = { self, io, interests };
-    return NIO_Selector_synchronize(self, NIO_Selector_register_synchronized, args);
+    VALUE args[3] = {self, io, interests};
+    return NIO_Selector_synchronize(self, NIO_Selector_register_synchronized, (VALUE)args);
 }
 
 /* Internal implementation of register after acquiring mutex */
-static VALUE NIO_Selector_register_synchronized(VALUE *args)
+static VALUE NIO_Selector_register_synchronized(VALUE _args)
 {
     VALUE self, io, interests, selectables, monitor;
     VALUE monitor_args[3];
     struct NIO_Selector *selector;
 
+    VALUE *args = (VALUE *)_args;
     self = args[0];
     io = args[1];
     interests = args[2];
 
-    Data_Get_Struct(self, struct NIO_Selector, selector);
+    TypedData_Get_Struct(self, struct NIO_Selector, &NIO_Selector_type, selector);
     if (selector->closed) {
         rb_raise(rb_eIOError, "selector is closed");
     }
@@ -361,15 +387,16 @@ static VALUE NIO_Selector_register_synchronized(VALUE *args)
 /* Deregister an IO object from the selector */
 static VALUE NIO_Selector_deregister(VALUE self, VALUE io)
 {
-    VALUE args[2] = { self, io };
-    return NIO_Selector_synchronize(self, NIO_Selector_deregister_synchronized, args);
+    VALUE args[2] = {self, io};
+    return NIO_Selector_synchronize(self, NIO_Selector_deregister_synchronized, (VALUE)args);
 }
 
 /* Internal implementation of register after acquiring mutex */
-static VALUE NIO_Selector_deregister_synchronized(VALUE *args)
+static VALUE NIO_Selector_deregister_synchronized(VALUE _args)
 {
     VALUE self, io, selectables, monitor;
 
+    VALUE *args = (VALUE *)_args;
     self = args[0];
     io = args[1];
 
@@ -396,7 +423,6 @@ static VALUE NIO_Selector_is_registered(VALUE self, VALUE io)
 static VALUE NIO_Selector_select(int argc, VALUE *argv, VALUE self)
 {
     VALUE timeout;
-    VALUE args[2];
 
     rb_scan_args(argc, argv, "01", &timeout);
 
@@ -404,27 +430,27 @@ static VALUE NIO_Selector_select(int argc, VALUE *argv, VALUE self)
         rb_raise(rb_eArgError, "time interval must be positive");
     }
 
-    args[0] = self;
-    args[1] = timeout;
-
-    return NIO_Selector_synchronize(self, NIO_Selector_select_synchronized, args);
+    VALUE args[2] = {self, timeout};
+    return NIO_Selector_synchronize(self, NIO_Selector_select_synchronized, (VALUE)args);
 }
 
 /* Internal implementation of select with the selector lock held */
-static VALUE NIO_Selector_select_synchronized(VALUE *args)
+static VALUE NIO_Selector_select_synchronized(VALUE _args)
 {
     int ready;
     VALUE ready_array;
     struct NIO_Selector *selector;
 
-    Data_Get_Struct(args[0], struct NIO_Selector, selector);
+    VALUE *args = (VALUE *)_args;
+
+    TypedData_Get_Struct(args[0], struct NIO_Selector, &NIO_Selector_type, selector);
 
     if (selector->closed) {
         rb_raise(rb_eIOError, "selector is closed");
     }
 
     if (!rb_block_given_p()) {
-        selector->ready_array = rb_ary_new();
+        RB_OBJ_WRITE(args[0], &selector->ready_array, rb_ary_new());
     }
 
     ready = NIO_Selector_run(selector, args[1]);
@@ -432,7 +458,7 @@ static VALUE NIO_Selector_select_synchronized(VALUE *args)
     /* Timeout */
     if (ready < 0) {
         if (!rb_block_given_p()) {
-            selector->ready_array = Qnil;
+            RB_OBJ_WRITE(args[0], &selector->ready_array, Qnil);
         }
 
         return Qnil;
@@ -442,7 +468,7 @@ static VALUE NIO_Selector_select_synchronized(VALUE *args)
         return INT2NUM(ready);
     } else {
         ready_array = selector->ready_array;
-        selector->ready_array = Qnil;
+        RB_OBJ_WRITE(args[0], &selector->ready_array, Qnil);
         return ready_array;
     }
 }
@@ -489,7 +515,7 @@ static int NIO_Selector_run(struct NIO_Selector *selector, VALUE timeout)
 static VALUE NIO_Selector_wakeup(VALUE self)
 {
     struct NIO_Selector *selector;
-    Data_Get_Struct(self, struct NIO_Selector, selector);
+    TypedData_Get_Struct(self, struct NIO_Selector, &NIO_Selector_type, selector);
 
     if (selector->closed) {
         rb_raise(rb_eIOError, "selector is closed");
@@ -504,15 +530,14 @@ static VALUE NIO_Selector_wakeup(VALUE self)
 /* Close the selector and free system resources */
 static VALUE NIO_Selector_close(VALUE self)
 {
-    VALUE args[1] = { self };
-    return NIO_Selector_synchronize(self, NIO_Selector_close_synchronized, args);
+    return NIO_Selector_synchronize(self, NIO_Selector_close_synchronized, self);
 }
 
-static VALUE NIO_Selector_close_synchronized(VALUE *args)
+static VALUE NIO_Selector_close_synchronized(VALUE self)
 {
     struct NIO_Selector *selector;
-    VALUE self = args[0];
-    Data_Get_Struct(self, struct NIO_Selector, selector);
+
+    TypedData_Get_Struct(self, struct NIO_Selector, &NIO_Selector_type, selector);
 
     NIO_Selector_shutdown(selector);
 
@@ -522,15 +547,14 @@ static VALUE NIO_Selector_close_synchronized(VALUE *args)
 /* Is the selector closed? */
 static VALUE NIO_Selector_closed(VALUE self)
 {
-    VALUE args[1] = { self };
-    return NIO_Selector_synchronize(self, NIO_Selector_closed_synchronized, args);
+    return NIO_Selector_synchronize(self, NIO_Selector_closed_synchronized, self);
 }
 
-static VALUE NIO_Selector_closed_synchronized(VALUE *args)
+static VALUE NIO_Selector_closed_synchronized(VALUE self)
 {
     struct NIO_Selector *selector;
-    VALUE self = args[0];
-    Data_Get_Struct(self, struct NIO_Selector, selector);
+
+    TypedData_Get_Struct(self, struct NIO_Selector, &NIO_Selector_type, selector);
 
     return selector->closed ? Qtrue : Qfalse;
 }

data/lib/nio/bytebuffer.rb

@@ -1,5 +1,11 @@
 # frozen_string_literal: true
 
+# Released under the MIT License.
+# Copyright, 2016, by Upekshe Jayasekera.
+# Copyright, 2016-2017, by Tony Arcieri.
+# Copyright, 2020, by Thomas Dziedzic.
+# Copyright, 2023, by Samuel Williams.
+
 module NIO
   # Efficient byte buffers for performant I/O operations
   class ByteBuffer

data/lib/nio/monitor.rb

@@ -1,5 +1,12 @@
 # frozen_string_literal: true
 
+# Released under the MIT License.
+# Copyright, 2011-2018, by Tony Arcieri.
+# Copyright, 2015, by Upekshe Jayasekera.
+# Copyright, 2015, by Vladimir Kochnev.
+# Copyright, 2018-2023, by Samuel Williams.
+# Copyright, 2019-2020, by Gregory Longtin.
+
 module NIO
   # Monitors watch IO objects for specific events
   class Monitor

data/lib/nio/selector.rb

@@ -1,5 +1,20 @@
 # frozen_string_literal: true
 
+# Released under the MIT License.
+# Copyright, 2011-2017, by Tony Arcieri.
+# Copyright, 2012, by Logan Bowers.
+# Copyright, 2013, by Sadayuki Furuhashi.
+# Copyright, 2013, by Stephen von Takach.
+# Copyright, 2013, by Tim Carey-Smith.
+# Copyright, 2013, by Ravil Bayramgalin.
+# Copyright, 2014, by Sergey Avseyev.
+# Copyright, 2014, by John Thornton.
+# Copyright, 2015, by Vladimir Kochnev.
+# Copyright, 2015, by Upekshe Jayasekera.
+# Copyright, 2019-2020, by Gregory Longtin.
+# Copyright, 2020-2021, by Joao Fernandes.
+# Copyright, 2023, by Samuel Williams.
+
 require "set"
 
 module NIO

data/lib/nio/version.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+# Released under the MIT License.
+# Copyright, 2011-2018, by Tony Arcieri.
+# Copyright, 2018-2024, by Samuel Williams.
+# Copyright, 2023, by Tsimnuj Hawj.
+
 module NIO
-  VERSION = "2.5.7"
+  VERSION = "2.7.3"
 end

data/lib/nio.rb

@@ -1,5 +1,14 @@
 # frozen_string_literal: true
 
+# Released under the MIT License.
+# Copyright, 2011-2017, by Tony Arcieri.
+# Copyright, 2013, by Stephen von Takach.
+# Copyright, 2013, by Per Lundberg.
+# Copyright, 2014, by Marek Kowalcze.
+# Copyright, 2016, by Upekshe Jayasekera.
+# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2021, by Jun Jiang.
+
 require "socket"
 require "nio/version"
 

data/lib/nio4r.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2023, by Phillip Aldridge.
+# Copyright, 2023, by Samuel Williams.
+
+require_relative "nio"

data/license.md

@@ -0,0 +1,80 @@
+# MIT License
+
+Copyright, 2011-2020, by Tony Arcieri.  
+Copyright, 2012, by Bernd Ahlers.  
+Copyright, 2012, by Logan Bowers.  
+Copyright, 2012, by Dirkjan Bussink.  
+Copyright, 2013, by Sadayuki Furuhashi.  
+Copyright, 2013, by Shannon Skipper.  
+Copyright, 2013, by Stephen von Takach.  
+Copyright, 2013, by Tim Carey-Smith.  
+Copyright, 2013, by Per Lundberg.  
+Copyright, 2013, by Ravil Bayramgalin.  
+Copyright, 2013, by Luis Lavena.  
+Copyright, 2014, by Anatol Pomozov.  
+Copyright, 2014, by Hiroshi Shibata.  
+Copyright, 2014, by Marek Kowalcze.  
+Copyright, 2014, by Sergey Avseyev.  
+Copyright, 2014, by John Thornton.  
+Copyright, 2015-2017, by Tiago Cardoso.  
+Copyright, 2015, by Daniel Berger.  
+Copyright, 2015-2016, by Upekshe Jayasekera.  
+Copyright, 2015, by Vladimir Kochnev.  
+Copyright, 2016-2018, by Jun Aruga.  
+Copyright, 2016, by Omer Katz.  
+Copyright, 2016, by Denis Washington.  
+Copyright, 2016-2021, by Olle Jonsson.  
+Copyright, 2017, by Tao Luo.  
+Copyright, 2017, by Usaku Nakamura.  
+Copyright, 2017-2022, by Gregory Longtin.  
+Copyright, 2017, by Lars Kanis.  
+Copyright, 2017, by Tomoya Ishida.  
+Copyright, 2018-2024, by Samuel Williams.  
+Copyright, 2019, by Cédric Boutillier.  
+Copyright, 2019-2020, by Benoit Daloze.  
+Copyright, 2019, by Jesús Burgos Maciá.  
+Copyright, 2019, by Thomas Kuntz.  
+Copyright, 2019, by Orien Madgwick.  
+Copyright, 2019, by Zhang Kang.  
+Copyright, 2020, by Thomas Dziedzic.  
+Copyright, 2020, by Elad Eyal.  
+Copyright, 2020, by Pedro Paiva.  
+Copyright, 2020, by Boaz Segev.  
+Copyright, 2020, by Charles Oliver Nutter.  
+Copyright, 2020-2021, by Joao Fernandes.  
+Copyright, 2021, by Jun Jiang.  
+Copyright, 2021, by Pavel Lobashov.  
+Copyright, 2021, by Jeffrey Martin.  
+Copyright, 2023-2024, by Pavel Rosický.  
+Copyright, 2023, by Tsimnuj Hawj.  
+Copyright, 2023, by Phillip Aldridge.  
+Copyright, 2023, by Maxime Demolin.  
+Copyright, 2023-2024, by Vít Ondruch.  
+Copyright, 2023, by Jean Boussier.  
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## libev
+
+Released under the BSD-2-Clause OR GPL-2.0-or-later license.
+See [ext/libev/LICENSE] for details.
+
+Copyright, 2007-2019, by Marc Alexander Lehmann.
+
+[ext/libev/LICENSE]: https://github.com/socketry/nio4r/blob/master/ext/libev/LICENSE

data/readme.md

@@ -0,0 +1,91 @@
+# ![nio4r](https://raw.github.com/socketry/nio4r/master/logo.png)
+
+[![Development Status](https://github.com/socketry/nio4r/workflows/Test/badge.svg)](https://github.com/socketry/nio4r/actions?workflow=Test)
+
+**New I/O for Ruby (nio4r)**: cross-platform asynchronous I/O primitives for
+scalable network clients and servers. Modeled after the Java NIO API, but
+simplified for ease-of-use.
+
+**nio4r** provides an abstract, cross-platform stateful I/O selector API for Ruby.
+I/O selectors are the heart of "reactor"-based event loops, and monitor
+multiple I/O objects for various types of readiness, e.g. ready for reading or
+writing.
+
+## Projects using nio4r
+
+  - [ActionCable](https://rubygems.org/gems/actioncable): Rails 5 WebSocket protocol, uses nio4r for a WebSocket server
+  - [Celluloid](https://github.com/celluloid/celluloid-io): Actor-based concurrency framework, uses nio4r for async I/O
+  - [Async](https://github.com/socketry/async): Asynchronous I/O framework for Ruby
+  - [Puma](https://github.com/puma/puma): Ruby/Rack web server built for concurrency
+
+## Goals
+
+  - Expose high-level interfaces for stateful IO selectors
+  - Keep the API small to maximize both portability and performance across many
+    different OSes and Ruby VMs
+  - Provide inherently thread-safe facilities for working with IO objects
+
+## Supported platforms
+
+  - Ruby 2.5
+  - Ruby 2.6
+  - Ruby 2.7
+  - Ruby 3.0
+  - [JRuby](https://github.com/jruby/jruby)
+  - [TruffleRuby](https://github.com/oracle/truffleruby)
+
+## Supported backends
+
+  - **libev**: MRI C extension targeting multiple native IO selector APIs (e.g epoll, kqueue)
+  - **Java NIO**: JRuby extension which wraps the Java NIO subsystem
+  - **Pure Ruby**: `Kernel.select`-based backend that should work on any Ruby interpreter
+
+## Documentation
+
+[Please see the nio4r wiki](https://github.com/socketry/nio4r/wiki)
+for more detailed documentation and usage notes:
+
+  - [Getting Started](https://github.com/socketry/nio4r/wiki/Getting-Started): Introduction to nio4r's components
+  - [Selectors](https://github.com/socketry/nio4r/wiki/Selectors): monitor multiple `IO` objects for readiness events
+  - [Monitors](https://github.com/socketry/nio4r/wiki/Monitors): control interests and inspect readiness for specific `IO` objects
+  - [Byte Buffers](https://github.com/socketry/nio4r/wiki/Byte-Buffers): fixed-size native buffers for high-performance I/O
+
+See also:
+
+  - [YARD API documentation](http://www.rubydoc.info/gems/nio4r/frames)
+
+## Non-goals
+
+**nio4r** is not a full-featured event framework like [EventMachine](https://github.com/eventmachine/eventmachine) or [Cool.io](https://coolio.github.io/).
+Instead, nio4r is the sort of thing you might write a library like that on
+top of. nio4r provides a minimal API such that individual Ruby implementers
+may choose to produce optimized versions for their platform, without having
+to maintain a large codebase.
+
+## Releases
+
+Bump the version first:
+
+    bundle exec bake gem:release:version:patch
+
+### CRuby
+
+    rake clean
+    rake release
+
+### JRuby
+
+You might need to delete `Gemfile.lock` before trying to `bundle install`.
+
+    # Ensure you have the correct JDK:
+    pacman -Syu jdk-openjdk
+    archlinux-java set java-19-openjdk
+    
+    # Ensure you are using jruby:
+    chruby jruby
+    bundle update
+    
+    # Build the package:
+    rake clean
+    rake compile
+    rake release