redis_queued_locks 0.0.16 → 0.0.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 524740cce42224df4610bce35ced68e38f0fceb13ba233fe9c2f4ceac76fa49a
-  data.tar.gz: f3cb8b791292ba1c98b9b97c2a23b413edf74a3a5a25cebba5c7e3900f5705fd
+  metadata.gz: eb745a97296f4661f7a68d7719d7bdb894521348d6aa25b92b23b4fcffce56cd
+  data.tar.gz: e12566b1c653ad97bf973887d4511482c628d8ec27fd265901d1d4bfba9c112b
 SHA512:
-  metadata.gz: 732ffd5fe549d093f8bc4ef6edd1db9751aa951b0cd0f75d3ba63b8facc7a5bea1d31c88527ae2ae1c3bd4bfc5e686a447ab3907d18f37c1756167d306c929aa
-  data.tar.gz: f6b95308ec0653068de4816ce47a45f2470000079d468a54950f4a4bfc10c2689778108a265d3be097811d0da31b16678d14aa284903066e9c889201cc412abb
+  metadata.gz: c3e6f4c421c8e6fb9b3933c01ebcd23d5762f0bdb0581333e2d85ab478a8002d8bce360bfabaab29d819c92a4f148e6562d0fa426e5999b0fc2d1c9b59f3eaa7
+  data.tar.gz: 42a5800757191ea80797c7462b765c5dd4187771ce73c6c9af70f6653dea5599710d8569b5a2fc1a0c30cb0b3483abfac557bd888a7f4bcbde4ac4a7de308021

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.0.17] - 2024-02-29
+### Added
+- `RedisQueuedLocks::Client#locks` - list of obtained locks;
+- `RedisQueuedLocks::Client#queues` - list of existing lock request queus;
+- `RedisQueuedLocks::Client#keys` - get list of taken locks and queues;
+
 ## [0.0.16] - 2024-02-29
 ### Fixed
 - Execution delay formula returns the value "in seconds" (should be "in milliseconds");

data/README.md

@@ -21,6 +21,10 @@ Each lock request is put into the request queue and processed in order of their
   - [queued?](#queued)
   - [unlock](#unlock---release-a-lock)
   - [clear_locks](#clear_locks---release-all-locks-and-lock-queues)
+  - [extend_lock_ttl](#extend_lock_ttl)
+  - [locks](#locks---get-list-of-obtained-locks)
+  - [queues](#queues---get-list-of-lock-request-queues)
+  - [keys](#keys---get-list-of-taken-locks-and-queues)
 - [Instrumentation](#instrumentation)
   - [Instrumentation Events](#instrumentation-events)
 - [Roadmap](#roadmap)
@@ -104,10 +108,15 @@ clinet = RedisQueuedLocks::Client.new(redis_client) do |config|
   config.default_queue_ttl = 15
 
   # (default: 100)
-  # - how many items will be released at a time in RedisQueuedLocks::Client#clear_locks logic;
-  # - affects the performancs capabilites (redis, rubyvm);
+  # - how many items will be released at a time in RedisQueuedLocks::Client#clear_locks logic (uses SCAN);
+  # - affects the performancs of your Redis and Ruby Application (configure thoughtfully);
   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);
+  # - affects the performance of your Redis and Ruby Application (configure thoughtfully;)
+  config.key_extraction_batch_size = 500
+
   # (default: RedisQueuedLocks::Instrument::VoidNotifier)
   # - instrumentation layer;
   # - you can provde your own instrumenter with `#notify(event, payload = {})`
@@ -138,6 +147,10 @@ end
 - [queued?](#queued)
 - [unlock](#unlock---release-a-lock)
 - [clear_locks](#clear_locks---release-all-locks-and-lock-queues)
+- [extend_lock_ttl](#extend_lock_ttl)
+- [locks](#locks---get-list-of-obtained-locks)
+- [queues](#queues---get-list-of-lock-request-queues)
+- [keys](#keys---get-list-of-taken-locks-and-queues)
 
 ---
 
@@ -393,6 +406,94 @@ Return:
 
 ---
 
+#### #extend_lock_ttl
+
+- soon
+
+---
+
+#### #locks - get list of obtained locks
+
+- uses redis `SCAN` under the hood;
+- accepts `scan_size:`/`Integer` option (`config[:key_extraction_batch_size]` by default);
+- returns `Set<String>`
+
+```ruby
+rql.locks # or rql.locks(scan_size: 123)
+
+=>
+#<Set:
+ {"rql:lock:locklock75",
+  "rql:lock:locklock9",
+  "rql:lock:locklock108",
+  "rql:lock:locklock7",
+  "rql:lock:locklock48",
+  "rql:lock:locklock104",
+  "rql:lock:locklock13",
+  "rql:lock:locklock62",
+  "rql:lock:locklock80",
+  "rql:lock:locklock28",
+  ...}>
+```
+
+---
+
+#### #queues - get list of lock request queues
+
+- uses redis `SCAN` under the hood;
+- accepts `scan_size:`/`Integer` option (`config[:key_extraction_batch_size]` by default);
+- returns `Set<String>`
+
+```ruby
+rql.queues # or rql.queues(scan_size: 123)
+
+=>
+#<Set:
+ {"rql:lock_queue:locklock75",
+  "rql:lock_queue:locklock9",
+  "rql:lock_queue:locklock108",
+  "rql:lock_queue:locklock7",
+  "rql:lock_queue:locklock48",
+  "rql:lock_queue:locklock104",
+  "rql:lock_queue:locklock13",
+  "rql:lock_queue:locklock62",
+  "rql:lock_queue:locklock80",
+  "rql:lock_queue:locklock28",
+  ...}>
+```
+
+---
+
+#### #keys - get list of taken locks and queues
+
+- uses redis `SCAN` under the hood;
+- accepts `scan_size:`/`Integer` option (`config[:key_extraction_batch_size]` by default);
+- returns `Set<String>`
+
+```ruby
+rql.keys # or rql.keys(scan_size: 123)
+
+=>
+#<Set:
+ {"rql:lock_queue:locklock75",
+  "rql:lock_queue:locklock9",
+  "rql:lock:locklock9",
+  "rql:lock_queue:locklock108",
+  "rql:lock_queue:locklock7",
+  "rql:lock:locklock7",
+  "rql:lock_queue:locklock48",
+  "rql:lock_queue:locklock104",
+  "rql:lock:locklock104",
+  "rql:lock_queue:locklock13",
+  "rql:lock_queue:locklock62",
+  "rql:lock_queue:locklock80",
+  "rql:lock:locklock80",
+  "rql:lock_queue:locklock28",
+  ...}>
+```
+
+---
+
 ## Instrumentation
 
 An instrumentation layer is incapsulated in `instrumenter` object stored in [config](#configuration) (`RedisQueuedLocks::Client#config[:instrumenter]`).

data/lib/redis_queued_locks/acquier/release.rb

@@ -37,6 +37,7 @@ module RedisQueuedLocks::Acquier::Release
         RedisQueuedLocks::Resource::LOCK_QUEUE_PATTERN,
         count: batch_size
       ) do |lock_queue|
+        # TODO: reduce unnecessary iterations
         pipeline.call('ZREMRANGEBYSCORE', lock_queue, '-inf', '+inf')
         pipeline.call('EXPIRE', RedisQueuedLocks::Resource.lock_key_from_queue(lock_queue), '0')
       end
@@ -47,6 +48,7 @@ module RedisQueuedLocks::Acquier::Release
         RedisQueuedLocks::Resource::LOCK_PATTERN,
         count: batch_size
       ) do |lock_key|
+        # TODO: reduce unnecessary iterations
         pipeline.call('EXPIRE', lock_key, '0')
       end
     end

data/lib/redis_queued_locks/acquier.rb

@@ -437,7 +437,66 @@ module RedisQueuedLocks::Acquier
     #
     # @api private
     # @since 0.1.0
-    def extend_lock_ttl(redis_client, lock_name, milliseconds); end
+    def extend_lock_ttl(redis_client, lock_name, milliseconds)
+      # TODO: realize
+    end
+
+    # @param redis_client [RedisClient]
+    # @option scan_size [Integer]
+    # @return [Set<String>]
+    #
+    # @api private
+    # @since 0.1.0
+    def locks(redis_client, scan_size:)
+      Set.new.tap do |lock_keys|
+        redis_client.scan(
+          'MATCH',
+          RedisQueuedLocks::Resource::LOCK_PATTERN,
+          count: scan_size
+        ) do |lock_key|
+          # TODO: reduce unnecessary iterations
+          lock_keys.add(lock_key)
+        end
+      end
+    end
+
+    # @param redis_client [RedisClient]
+    # @param scan_size [Integer]
+    # @return [Set<String>]
+    #
+    # @api private
+    # @since 0.1.0
+    def queues(redis_client, scan_size:)
+      Set.new.tap do |lock_queues|
+        redis_client.scan(
+          'MATCH',
+          RedisQueuedLocks::Resource::LOCK_QUEUE_PATTERN,
+          count: scan_size
+        ) do |lock_queue|
+          # TODO: reduce unnecessary iterations
+          lock_queues.add(lock_queue)
+        end
+      end
+    end
+
+    # @param redis_client [RedisClient]
+    # @option scan_size [Integer]
+    # @return [Array<String>]
+    #
+    # @api private
+    # @since 0.1.0
+    def keys(redis_client, scan_size:)
+      Set.new.tap do |keys|
+        redis_client.scan(
+          'MATCH',
+          RedisQueuedLocks::Resource::KEY_PATTERN,
+          count: scan_size
+        ) do |key|
+          # TODO: reduce unnecessary iterations
+          keys.add(key)
+        end
+      end
+    end
 
     private
 

data/lib/redis_queued_locks/client.rb

@@ -15,6 +15,7 @@ class RedisQueuedLocks::Client
     setting :default_lock_ttl, 5_000 # NOTE: milliseconds
     setting :default_queue_ttl, 15 # NOTE: seconds
     setting :lock_release_batch_size, 100
+    setting :key_extraction_batch_size, 500
     setting :instrumenter, RedisQueuedLocks::Instrument::VoidNotifier
     setting :uniq_identifier, -> { RedisQueuedLocks::Resource.calc_uniq_identity }
 
@@ -225,5 +226,32 @@ class RedisQueuedLocks::Client
   def clear_locks(batch_size: config[:lock_release_batch_size])
     RedisQueuedLocks::Acquier.release_all_locks!(redis_client, batch_size, config[:instrumenter])
   end
+
+  # @option scan_size [Integer]
+  # @return [Set<String>]
+  #
+  # @api public
+  # @since 0.1.0
+  def locks(scan_size: config[:key_extraction_batch_size])
+    RedisQueuedLocks::Acquier.locks(redis_client, scan_size:)
+  end
+
+  # @option scan_size [Integer]
+  # @return [Set<String>]
+  #
+  # @api public
+  # @since 0.1.0
+  def queues(scan_size: config[:key_extraction_batch_size])
+    RedisQueuedLocks::Acquier.queues(redis_client, scan_size:)
+  end
+
+  # @option scan_size [Integer]
+  # @return [Set<String>]
+  #
+  # @api public
+  # @since 0.1.0
+  def keys(scan_size: config[:key_extraction_batch_size])
+    RedisQueuedLocks::Acquier.keys(redis_client, scan_size:)
+  end
 end
 # rubocop:enable Metrics/ClassLength

data/lib/redis_queued_locks/resource.rb

@@ -3,6 +3,12 @@
 # @api private
 # @since 0.1.0
 module RedisQueuedLocks::Resource
+  # @return [String]
+  #
+  # @api private
+  # @since 0.1.0
+  KEY_PATTERN = 'rql:lock*'
+
   # @return [String]
   #
   # @api private

data/lib/redis_queued_locks/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: redis_queued_locks
 version: !ruby/object:Gem::Version
-  version: 0.0.16
+  version: 0.0.17
 platform: ruby
 authors:
 - Rustam Ibragimov