redis_queued_locks 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83f1a77fc07b776195720c2f06a7117baa22ea7f68be06120d3fe7befe26db84
-  data.tar.gz: 4a06cb4f59afb485331513ab01172c2836f07702bd79fdc85c95efaa459a2597
+  metadata.gz: 6b175564df436902d56e07a376f0257118eced8d7c81dbb81837e63cdef74938
+  data.tar.gz: f88d3e83045cb4dd4dcd10b12744399ce45d3b99a84f6ca492d801a678db55f0
 SHA512:
-  metadata.gz: ebae6ceee85253f767b0de53b70a69f00590e91bbcdb6c86860c35a00d736f59593f924eaccb13b593def1f9b504f338f786a2eeb59f9dcd4a596c9d70f2f348
-  data.tar.gz: 5e6e97c4645df750d618c778caccd80fa3eab1491e141b238e5e4c1ed15f59c72871c00f10d38269f33ada195b96ed5b407a62cc52d2543a169b150d2150c770
+  metadata.gz: ae486564a408bc9039d6b09f3fe08ba37e733bae902ec2c3f55eae84b22a05e6c6f31bc9ceafc5ee78a10ae34dfdc0b3e7dcbfb09a41f74795ed29dce823a6bc
+  data.tar.gz: ba40ab572fb1863b0bcddee6536385d19e3b3c7c9df07b2e2d71d74ad740eccb05a18847222be70bf6796596ce2b93266dbf462dccab294c6200a4441ca1f1a7

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 ## [Unreleased]
 
+## [1.1.0] - 2024-04-01
+### Added
+- Documentation updates:
+  - more `#lock` examples;
+  - added missing docs for `config.dead_request_ttl`;
+  - some minor updates;
+### Changed
+- `#clear_dead_requests`: `:scan_size` is equal to `config[:lock_release_batch_size]` now (instead of to `config[:key_extraction_batch_size]`);
+  cuz `#clear_dead_requests` works with lock releasing;
+
 ## [1.0.0] - 2024-04-01
 - First Major Release;
 

data/README.md

@@ -155,10 +155,16 @@ clinet = RedisQueuedLocks::Client.new(redis_client) do |config|
   config.lock_release_batch_size = 100
 
   # (default: 500)
-  # - how many items should be extracted from redis during the #locks, #queues and #keys operations (uses SCAN);
+  # - how many items should be extracted from redis during the #locks, #queues, #keys
+  #   #locks_info, and #queues_info operations (uses SCAN);
   # - affects the performance of your Redis and Ruby Application (configure thoughtfully;)
   config.key_extraction_batch_size = 500
 
+  # (default: 1 day)
+  # - the default period of time (in milliseconds) after which a lock request is considered dead;
+  # - used for `#clear_dead_requests` as default vaule of `:dead_ttl` option;
+  config.dead_request_ttl = (1 * 24 * 60 * 60 * 1000) # one day in milliseconds
+
   # (default: RedisQueuedLocks::Instrument::VoidNotifier)
   # - instrumentation layer;
   # - you can provde your own instrumenter with `#notify(event, payload = {})`
@@ -245,7 +251,7 @@ def lock(
   ttl: config[:default_lock_ttl],
   queue_ttl: config[:default_queue_ttl],
   timeout: config[:try_to_lock_timeout],
-  timed: false,
+  timed: config[:is_timed_by_default],
   retry_count: config[:retry_count],
   retry_delay: config[:retry_delay],
   retry_jitter: config[:retry_jitter],
@@ -429,6 +435,24 @@ rql.lock("my_lock", ttl: 6_500) # blocks execution until the lock is obtained
 puts "Let's go" # will be called immediately after the lock is obtained
 ```
 
+- add custom metadata to the lock (via `:meta` option):
+
+```ruby
+rql.lock("my_lock", ttl: 123456, meta: { "some" => "data", key: 123.456 })
+
+rql.lock_info("my_lock")
+# =>
+{
+  "lock_key" => "rql:lock:my_lock",
+  "acq_id" => "rql:acq:123/456/567/678/374dd74324",
+  "ts" => 123456789,
+  "ini_ttl" => 123456,
+  "rem_ttl" => 123440,
+  "some" => "data",
+  "key" => "123.456" # NOTE: returned as a raw string directly from Redis
+}
+```
+
 ---
 
 #### #lock! - exceptional lock obtaining

data/lib/redis_queued_locks/acquier/acquire_lock.rb

@@ -186,7 +186,7 @@ module RedisQueuedLocks::Acquier::AcquireLock
       with_acq_timeout(timeout, lock_key, raise_errors, on_timeout: acq_dequeue) do
         acq_start_time = ::Process.clock_gettime(::Process::CLOCK_MONOTONIC)
 
-        # Step 2.1: caclically try to obtain the lock
+        # Step 2.1: cyclically try to obtain the lock
         while acq_process[:should_try]
           run_non_critical do
             logger.debug do

data/lib/redis_queued_locks/client.rb

@@ -402,11 +402,12 @@ class RedisQueuedLocks::Client
   end
 
   # @option dead_ttl [Integer]
-  #  - the time period (in millsiecnds) after whcih the lock request is
-  #    considered as dead;
-  #  - `config[:dead_request_ttl]` is used by default;
+  #   - the time period (in millsiecnds) after whcih the lock request is
+  #     considered as dead;
+  #   - `config[:dead_request_ttl]` is used by default;
   # @option scan_size [Integer]
-  #   The batch of scanned keys for Redis'es SCAN command.
+  #   - the batch of scanned keys for Redis'es SCAN command;
+  #   - `config[:lock_release_batch_size]` is used by default;
   # @option logger [::Logger,#debug]
   # @option instrumenter [#notify]
   # @option instrument [NilClass,Any]
@@ -417,7 +418,7 @@ class RedisQueuedLocks::Client
   # @since 0.1.0
   def clear_dead_requests(
     dead_ttl: config[:dead_request_ttl],
-    scan_size: config[:key_extraction_batch_size],
+    scan_size: config[:lock_release_batch_size],
     logger: config[:logger],
     instrumenter: config[:instrumenter],
     instrument: nil

data/lib/redis_queued_locks/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: redis_queued_locks
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-04-01 00:00:00.000000000 Z
+date: 2024-04-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redis-client
@@ -108,7 +108,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.5.1
 signing_key:
 specification_version: 4
 summary: Queued distributed locks based on Redis.