redis_queued_locks 1.12.0 → 1.12.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e8dd94852534ed373615917be290e53b29e203e7b88907d24631869ab4f2deb
-  data.tar.gz: 9b78929772d22f8ae6cbb628d306a85c44d4eec2f6a41e68bccfa0d754db80b5
+  metadata.gz: 419bb42dc0f90c9cfac1107f3eb93ab4e5185d17efa53f78012eed09aee03931
+  data.tar.gz: c9e1471bc65375cbabe88276c7144460b05bb3e0cb4880a75b061514578a4e3d
 SHA512:
-  metadata.gz: 14e6e0c7ff71c9bc0d8a4ff1088a0b9983a8bd365fa10b17236996b3cb20e291fb951e648c79430b2d4091179024385648a343b36913443a9459c3c9e2a71b18
-  data.tar.gz: f0aa55c8561513a87d3c8f347db2f9a0710c62b4fe6d03fd6b512fec56c2631da77b86080bbbdf051bfc82d6abe2016f8baf37e43b3eebc973bd404bb7f80a35
+  metadata.gz: aa5e610820ffb105003d09918ee5df8c51989de24a0473eb0d9056deb5e0c2de0cc8c23c220bd4b8da14a7ff0d2b2c7271cc521862263251c03382d4f246f302
+  data.tar.gz: dc14d292c361c798c1cd5a375ff48f271d96a35246c2e463d331dfe9dcb116b64f3b17ad95e12a5e5f72f8aad2a243a17cc0ed10a2ab4521773385bc51d2c77d

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 ## [Unreleased]
 
+## [1.12.1]
+### Changed
+- Internal Private API: an internal Reentrant's Lock utility (`RedisQueuedLocks::Utilities::Lock`) basis
+  is changed from `::Mutex` to `::Monitor` in order to use Ruby's Core C-based
+  implementation (prevent some Ruby-runtime based GVL-oriented locking) of re-entrant locks
+  instead of the custom Ruby-based implementation;
+### Fixed
+- `redis_queued_locks.lock_hold_and_release` instrumentation event has incorrect `acq_time` payload value
+  (it incorrectly stores `lock_key` payload value);
+
 ## [1.12.0] - 2024-08-11
 ### Changed
 - Timed blocks of code and their timeout errors: reduced error message object allocations;

data/README.md

@@ -2073,25 +2073,34 @@ Detalized event semantics and payload structure:
       trying to ressurect unexpectedly terminated swarm elements, and will notify about this;
     - swarm logs (thread/ractor has some limitations so the initial implementation does not include swarm logging);
     - swarm instrumentation (thread/ractor has some limitations so the initial implementation does not include swarm instrumentation);
+  - isolated timeouts which are independent of internal Ruby's timeout implementation (where all timeouts are hostend inside
+    the global "timeout request" queue and managed by a single global "timeout wathcer" thread). it should prevent any logic and timeout intersections,
+    some GVL-related things and problem situations when the global watcher thread is "dead";
   - lock request prioritization;
-  - **strict redlock algorithm support** (support for many `RedisClient` instances);
+  - **strict redlock algorithm support** (support for many `RedisClient` instances that are fully independent (distributed redis instances));
   - `#lock_series` - acquire a series of locks:
     ```ruby
     rql.lock_series('lock_a', 'lock_b', 'lock_c') { puts 'locked' }
     ```
-  - support for `Dragonfly` database backend (https://github.com/dragonflydb/dragonfly) (https://www.dragonflydb.io/);
+  - `light mode`: an ability to work without any debug and instrumentation logic and data (totally reduced debugging and instrumenting possibilities, but better performance);
 - **Minor**:
+  - support for `Dragonfly` database backend (https://github.com/dragonflydb/dragonfly) (https://www.dragonflydb.io/);
+  - (_research_) GVL-isolation for lock acquirement logic (try to bypass Ruby's "context-switching" in order to prevent any time-based affects on lock-acquirement logic);
   - Semantic error objects for unexpected Redis errors;
   - **Experimental feature**: (non-`timed` locks): per-ruby-block-holding-the-lock sidecar `Ractor` and `in progress queue` in RedisDB that will extend
     the acquired lock for long-running blocks of code (that invoked "under" the lock
     whose ttl may expire before the block execution completes). It makes sense for non-`timed` locks *only*;
+  - sized lock queues (with an ability of dynamically growing size);
   - better code stylization (+ some refactorings);
   - `RedisQueuedLocks::Acquier::Try.try_to_lock` - detailed successful result analization;
   - Support for LIFO strategy;
   - better specs with 100% test coverage (total specs rework);
   - statistics with UI;
   - JSON log formatter;
+  - RBS type signatures;
+  - **automatic** deadlock detection;
   - `go`-lang implementation;
+  - (_research_) simplification and speedup of the internal "redis-communuication-and-data-storing"-based algorithms;
 
 ---
 

data/lib/redis_queued_locks/acquier/acquire_lock/with_acq_timeout.rb

@@ -34,10 +34,6 @@ module RedisQueuedLocks::Acquier::AcquireLock::WithAcqTimeout
     on_timeout: nil,
     &block
   )
-    # TODO:
-    #   think about the runtime error class-object creation that perevent any timeout error
-    #   interception collisions (but remember: it can lead to regular internal ruby method/constant
-    #   cache invalidation);
     ::Timeout.timeout(timeout, RedisQueuedLocks::LockAcquiermentIntermediateTimeoutError, &block)
   rescue RedisQueuedLocks::LockAcquiermentIntermediateTimeoutError
     on_timeout.call unless on_timeout == nil

data/lib/redis_queued_locks/acquier/acquire_lock/yield_expire.rb

@@ -122,7 +122,7 @@ module RedisQueuedLocks::Acquier::AcquireLock::YieldExpire
       "ttl: #{lock_ttl}, " \
       "meta: #{meta ? meta.inspect : '<no-meta>'}, " \
       "acq_id: \"#{acquier_id}\", " \
-      "hst_id: \"#{host_id}\")",
+      "hst_id: \"#{host_id}\")"
     )
   end
 end

data/lib/redis_queued_locks/acquier/acquire_lock.rb

@@ -154,7 +154,7 @@ module RedisQueuedLocks::Acquier::AcquireLock
     #
     # @api private
     # @since 1.0.0
-    # @version 1.9.0
+    # @version 1.12.1
     def acquire_lock(
       redis,
       lock_name,
@@ -531,8 +531,8 @@ module RedisQueuedLocks::Acquier::AcquireLock
                 acq_process[:lock_info][:acq_id],
                 acq_process[:lock_info][:hst_id],
                 acq_process[:lock_info][:ts],
-                acq_process[:lock_info][:lock_key],
                 acq_process[:acq_time],
+                acq_process[:hold_time],
                 instrument
               )
             end

data/lib/redis_queued_locks/utilities/lock.rb

@@ -7,8 +7,9 @@ class RedisQueuedLocks::Utilities::Lock
   #
   # @api private
   # @since 1.9.0
+  # @version 1.13.0
   def initialize
-    @lock = ::Mutex.new
+    @lock = ::Monitor.new
   end
 
   # @param block [Block]
@@ -16,7 +17,8 @@ class RedisQueuedLocks::Utilities::Lock
   #
   # @api private
   # @since 1.9.0
+  # @version 1.13.0
   def synchronize(&block)
-    @lock.owned? ? yield : @lock.synchronize(&block)
+    @lock.synchronize(&block)
   end
 end

data/lib/redis_queued_locks/version.rb

@@ -5,6 +5,6 @@ module RedisQueuedLocks
   #
   # @api public
   # @since 0.0.1
-  # @version 1.12.0
-  VERSION = '1.12.0'
+  # @version 1.12.1
+  VERSION = '1.12.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: redis_queued_locks
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.12.1
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-08-11 00:00:00.000000000 Z
+date: 2024-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redis-client