async-job-processor-redis 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf246106a0b45eade2e2316e3d198a80101b89e83619ae6ebf753a1a153a853c
-  data.tar.gz: c298e2a87023a73a2014693d09685320ba20b875b1d872eea764ba3d97054cf8
+  metadata.gz: 5dd229182e417f662b414408d5b49a3c789791f63d7178d2d3acd4c30345b097
+  data.tar.gz: 2f28fd28ebbe51ea344810a039aa2985f68bf4b3934240dabb5d5949e9ffa06c
 SHA512:
-  metadata.gz: c343b68ed4fdefa6473737c65ea4e5d4303573eb60dca28a9f9d7ac36fcb5a35fdf7c37b91d74900aedb335d62701497398a6336073886305998ca3d6668f3c4
-  data.tar.gz: 17c8c94cdd5a3c08bd09d10c77e129bd9bcffc475f444411afa79fcd8f94f3bce6e80e03c391cb4fb2aadf3c729916fb1a8c1ed9ba44db786bc86c0e0d573300
+  metadata.gz: 8818c38d052f06d17c8ada64d537ac996c3bb62bfbbb11c6965e7efa55f4c08b25f19ac9d50c44799b0dd3adcc7b8592ab573cf9793e0fab4500a09c3cfe560a
+  data.tar.gz: 9f8a5d182e4f9e7fff41bd01a328a6c50a1349a6dc9136e5fb1566d549e5558e624ccb9442d56e15a32779b5f6b0de4c67b2da619ebc6d8815f58e9183636cc0

data/lib/async/job/processor/redis/delayed_jobs.rb

@@ -36,6 +36,11 @@ module Async
 						@move = @client.script(:load, MOVE)
 					end
 					
+					# @returns [Integer] The number of jobs currently in the delayed queue.
+					def size
+						@client.zcard(@key)
+					end
+					
 					# Start the background task that moves ready delayed jobs to the ready queue.
 					# @parameter ready_list [ReadyList] The ready list to move jobs to.
 					# @parameter resolution [Integer] The check interval in seconds.

data/lib/async/job/processor/redis/processing_list.rb

@@ -73,6 +73,8 @@ module Async
 						@requeue = @client.script(:load, REQUEUE)
 						@retry = @client.script(:load, RETRY)
 						@complete = @client.script(:load, COMPLETE)
+						
+						@complete_count = 0
 					end
 					
 					# @attribute [String] The base Redis key for this processing list.
@@ -81,6 +83,14 @@ module Async
 					# @attribute [String] The Redis key for this worker's heartbeat.
 					attr :heartbeat_key
 					
+					# @attribute [Integer] The total count of all jobs completed by this worker.
+					attr :complete_count
+					
+					# @returns [Integer] The number of jobs currently being processed by this worker.
+					def size
+						@client.llen(@pending_key)
+					end
+					
 					# Fetch the next job from the ready queue, moving it to this worker's pending list.
 					# This is a blocking operation that waits until a job is available.
 					# @returns [String, nil] The job ID, or nil if no job is available.
@@ -91,6 +101,8 @@ module Async
 					# Mark a job as completed, removing it from the pending list and job store.
 					# @parameter id [String] The job ID to complete.
 					def complete(id)
+						@complete_count += 1
+						
 						@client.evalsha(@complete, 2, @pending_key, @job_store.key, id)
 					end
 					

data/lib/async/job/processor/redis/ready_list.rb

@@ -28,6 +28,11 @@ module Async
 					# @attribute [String] The Redis key for this ready list.
 					attr :key
 					
+					# @returns [Integer] The number of jobs currently in the ready list.
+					def size
+						@client.llen(@key)
+					end
+					
 					# Add a new job to the ready queue.
 					# @parameter job [String] The serialized job data.
 					# @parameter job_store [JobStore] The job store to save the job data.

data/lib/async/job/processor/redis/server.rb

@@ -85,6 +85,21 @@ module Async
 						super
 					end
 					
+					# Generates a human-readable string representing the current statistics.
+					#
+					# e.g. `R=3.42K D=1.23K P=7/2.34K``
+					#
+					# This can be interpreted as:
+					#
+					# - R: Number of jobs in the ready list
+					# - D: Number of jobs in the delayed queue
+					# - P: Number of jobs currently being processed / total number of completed jobs.
+					#
+					# @returns [String] A string representing the current statistics.
+					def status_string
+						"R=#{format_count(@ready_list.size)} D=#{format_count(@delayed_jobs.size)} P=#{format_count(@processing_list.size)}/#{format_count(@processing_list.complete_count)}"
+					end
+					
 					# Submit a new job for processing.
 					# Jobs with a scheduled_at time are queued for delayed processing, while immediate jobs are added to the ready queue.
 					# @parameter job [Hash] The job data to process.
@@ -121,6 +136,18 @@ module Async
 					ensure
 						@processing_list.retry(_id) if _id
 					end
+					
+					private
+					
+					def format_count(value)
+						if value > 1_000_000
+							"#{(value/1_000_000.0).round(2)}M"
+						elsif value > 1_000
+							"#{(value/1_000.0).round(2)}K"
+						else
+							value
+						end
+					end
 				end
 			end
 		end

data/lib/async/job/processor/redis/version.rb

@@ -7,7 +7,7 @@ module Async
 	module Job
 		module Processor
 			module Redis
-				VERSION = "0.2.0"
+				VERSION = "0.3.0"
 			end
 		end
 	end

data/readme.md

@@ -16,6 +16,10 @@ Please see the [project documentation](https://socketry.github.io/async-job-proc
 
 Please see the [project releases](https://socketry.github.io/async-job-processor-redis/releases/index) for all releases.
 
+### v0.3.0
+
+  - Add `Async::Job::Processor::Redis::Server#status_string` method to return a string with the current job counts.
+
 ### v0.2.0
 
   - Achieve 100% documentation coverage.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.3.0
+
+  - Add `Async::Job::Processor::Redis::Server#status_string` method to return a string with the current job counts.
+
 ## v0.2.0
 
   - Achieve 100% documentation coverage.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-job-processor-redis
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Samuel Williams