async-job-processor-redis 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5dd229182e417f662b414408d5b49a3c789791f63d7178d2d3acd4c30345b097
-  data.tar.gz: 2f28fd28ebbe51ea344810a039aa2985f68bf4b3934240dabb5d5949e9ffa06c
+  metadata.gz: 19f21b96ed37f056471ebbb1935460d1be5a2714b4d1e50f9c82f8587587be8c
+  data.tar.gz: 8e1d7ba47c50236eeeb43e2b1ac38cdeba3cc1812ec028999aae7ccd87c91c66
 SHA512:
-  metadata.gz: 8818c38d052f06d17c8ada64d537ac996c3bb62bfbbb11c6965e7efa55f4c08b25f19ac9d50c44799b0dd3adcc7b8592ab573cf9793e0fab4500a09c3cfe560a
-  data.tar.gz: 9f8a5d182e4f9e7fff41bd01a328a6c50a1349a6dc9136e5fb1566d549e5558e624ccb9442d56e15a32779b5f6b0de4c67b2da619ebc6d8815f58e9183636cc0
+  metadata.gz: a7600f75d5a7a9b5b0f0d93e8896889b80853a92b59cfc02413ea12c9d02034108c27961d4878dffe4dddcb42eafd9d25825b985842f03a6514e5bd90004b3da
+  data.tar.gz: 50fa8c45039c3505aea3f8e3dc6df6a1c442994d5ca4e7eb083d851af7d3bfe9e59a23b74a89e955360bdb6b8d951e14ba226364ebdd78a9f862b40e457a17c8

data/context/getting-started.md

@@ -0,0 +1,41 @@
+# Getting Started
+
+This guide gives you an overview of the `async-job-processor-redis` gem.
+
+## Installation
+
+Add the gem to your project:
+
+``` shell
+$ bundle add async-job-processor-redis
+```
+
+## Usage
+
+Here is a full example of the job queue:
+
+``` ruby
+require "async"
+require "async/job"
+require "async/job/processor/redis"
+
+Async do
+	buffer = Async::Job::Buffer.new
+	
+	queue = Async::Job::Builder.build(buffer) do
+		dequeue Async::Job::Processor::Redis
+	end
+	
+	# Run the server:
+	server = Async{queue.start}
+	
+	# Enqueue a job:
+	queue.call({message: "Hello, World!"})
+	
+	# Wait for the job to complete:
+	job = buffer.pop
+	pp job: job
+	
+	server.stop
+end
+```

data/context/index.yaml

@@ -0,0 +1,16 @@
+# Automatically generated context index for Utopia::Project guides.
+# Do not edit then files in this directory directly, instead edit the guides and then run `bake utopia:project:agent:context:update`.
+---
+description: A asynchronous job queue for Ruby.
+metadata:
+  documentation_uri: https://socketry.github.io/async-job-processor-redis/
+  source_code_uri: https://github.com/socketry/async-job-processor-redis
+files:
+- path: getting-started.md
+  title: Getting Started
+  description: This guide gives you an overview of the `async-job-processor-redis`
+    gem.
+- path: redis-queue.md
+  title: Redis Queue
+  description: This guide gives a brief overview of the implementation of the Redis
+    queue.

data/context/redis-queue.md

@@ -0,0 +1,19 @@
+# Redis Queue
+
+This guide gives a brief overview of the implementation of the Redis queue.
+
+## Overview
+
+The Redis queue plays a pivotal role in facilitating a sophisticated and reliable job queue architecture, designed to handle diverse processing needs with efficiency and resilience. The architecture is thoughtfully split into three distinct components, each serving a critical function in the lifecycle of a job: the ready queue, the delayed queue, and the processing queue.
+
+## Ready Queue
+
+The ready queue is where jobs that are immediately available for processing are stored. When a job is submitted and is ready to be executed without any delay, it is placed into this queue. Worker processes constantly listen for new jobs on the ready queue, dequeuing and executing them as soon as they become available. This queue operates on a FIFO (First In, First Out) basis, ensuring that jobs are processed in the order they were received.
+
+## Delayed Queue
+
+The delayed queue holds jobs that are not meant to be executed immediately but at a specified future time. This functionality is crucial for tasks that need to be executed at a later stage, such as scheduled notifications or time-dependent processes. Jobs in the delayed queue are sorted according to their execution time. When possible, they are moved to the ready queue to be executed by the next available worker. This transition is managed through Redis's sorted sets, allowing efficient retrieval and management of timed events.
+
+## Processing Queue
+
+Once a job is dequeued from the ready queue, it enters the processing queue, signifying that it is currently being executed by a worker. The processing queue is crucial for tracking the progress of jobs and for ensuring that jobs can be retried or recovered in case of worker failure. Each worker emits a heartbeat, and if a worker fails to emit a heartbeat within a specified time, any jobs associated with that worker are automatically moved back to the ready queue for reprocessing.

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

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2024-2025, by Samuel Williams.
 
 module Async
 	module Job

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

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2024-2025, by Samuel Williams.
 
 module Async
 	module Job

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

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2024-2025, by Samuel Williams.
 
 module Async
 	module Job

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

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2024-2025, by Samuel Williams.
 
 module Async
 	module Job
 		module Processor
 			module Redis
-				VERSION = "0.3.0"
+				VERSION = "0.3.1"
 			end
 		end
 	end

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

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2024-2025, by Samuel Williams.
 
 require_relative "redis/server"
 require "async/redis/client"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-job-processor-redis
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Samuel Williams
@@ -70,6 +70,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- context/getting-started.md
+- context/index.yaml
+- context/redis-queue.md
 - lib/async/job/processor/redis.rb
 - lib/async/job/processor/redis/delayed_jobs.rb
 - lib/async/job/processor/redis/job_store.rb
@@ -99,7 +102,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A asynchronous job queue for Ruby.
 test_files: []