snerdmq 0.3.3 → 0.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85e9f934b6976cdbd8c95718707762e2da87e93ea53448a51b3983b40d145f26
-  data.tar.gz: 82d99ccce4066f516da45f536e36f8539d569cdf47d1a74442b1557086830243
+  metadata.gz: 49f0d03ac996ffe2018f862d5a82f0a73fec5281a1d1097727ad369f4a112ab2
+  data.tar.gz: 1ac5125ecef4e6d40cbcc4103b96aa18a6d002c1ee7371135720df6fc4370f20
 SHA512:
-  metadata.gz: b18cee9ae796c2c612d44bea8c6aa0e81725e4a27f7f4001bb4c1d66acafc89ea2766c21e573dedebf45a8689b4b2a60abc885ad0d13a632de4da3d9934e2d5c
-  data.tar.gz: 815dc8ba1eb2977aba024af95fba389753a0428d3483c3db438e8ced86fada4666c0375d7d6d4b032a3705ac2f8c9fe30aea5c82d9967adc1260c17cfcf53d86
+  metadata.gz: 4de56bd72675519a68bc92e81553cc3a3033fa9f9e06786dcf3b2b79b79d83741730fd91dce142ff9230c64fa090b5ba8c0a65acbfeb4299f5126a3b61d3fb6e
+  data.tar.gz: 67987b9a61af61b50606577063103b7e6ca5feb3398dd0946e22b85396d40276ed80c2d78e66a73a1670a327af043e1e072e1c02f1e07263de8e6d25d63449cb

data/README.md

@@ -1,6 +1,6 @@
 <div align="center">
   <img src="./assets/Designer-9.png" height="120" alt="SnerdMQ Ruby Logo" />
-  <h1>💎 SnerdMQ Ruby SDK v0.3.3</h1>
+  <h1>💎 SnerdMQ Ruby SDK v0.3.5</h1>
   <p>A zero-config, C-speed background job queue for Ruby. Ditch Redis and Sidekiq for lightweight, persistent background jobs.</p>
 
   [![Gem Version](https://badge.fury.io/rb/snerdmq.svg)](https://badge.fury.io/rb/snerdmq)
@@ -9,7 +9,7 @@
 
 This is the official Ruby SDK wrapper for **SnerdMQ**. It handles all JSON-RPC communication and `IO.popen` orchestration so you can write lightning-fast background jobs without managing any external databases like Redis or Postgres.
 
-## ✨ v0.3.3 AI Features
+## ✨ v0.3.5 AI Features
 - **Smart API Rate-Limiting**: Natively tracks `rate_limit_group` execution velocity to prevent 429 "Too Many Requests" API errors.
 - **Payload-Hashing Deduplication**: Automatically computes cryptographic hashes to drop duplicate tasks instantly.
 - **Dynamic Float Prioritization**: A native Binary Max-Heap bypasses standard FIFO rules for high urgency tasks.
@@ -18,7 +18,7 @@ This is the official Ruby SDK wrapper for **SnerdMQ**. It handles all JSON-RPC c
 - **Zero Rust Required**: Our gem installation script automatically downloads the pre-compiled C-speed Rust binary for your OS.
 - **Thread Safe**: Uses native Ruby `Thread`s and `Mutex` locks to orchestrate I/O without blocking your main event loop.
 
-### ⚙️ Advanced Task Configuration (v0.3.3)
+### ⚙️ Advanced Task Configuration (v0.3.5)
 To power complex AI workflows, tasks can now be configured with advanced orchestration parameters:
 
 * **`auto_dedupe` (`true/false`)**: If set to `true`, the daemon computes a cryptographic hash of the `task_type` and `data`. If an identical payload is currently sitting in the queue pending execution, this new task is silently dropped. Excellent for preventing duplicate generative AI requests from trigger-happy users!
@@ -241,3 +241,41 @@ queue = Snerdmq::SnerdQueue.new(storage_path: "/var/data/snerd") # per-server st
 A shared network drive (AWS EFS or NFS) is still a good home for that storage when a single instance needs durable state — e.g. a container that restarts but must keep its queue. Native OS file locking (`flock`) keeps writes safe — no Redis required.
 
 *Built with ❤️ for John Wick tier engineering.*
+
+
+## Architecture Best Practices
+
+When building production applications with SnerdMQ, it is recommended to initialize the queue as a Singleton, isolate your domain workers into separate files/functions, use Dead Letter Queues (DLQ) for failed tasks via `RegisterMaxRetryHandler`, and ensure manual graceful shutdown. The embedded Dashboard UI can also be easily served from the same instance.
+
+```ruby
+require 'snerdmq'
+
+queue = SnerdQueue.new(storage_path: "./.snerdata")
+
+def init_email_workers(queue)
+  queue.register_handler('send_email') do |data|
+    puts "Sending email to #{data['email']}..."
+  end
+
+  queue.register_max_retry_handler('send_email') do |data|
+    puts "Email to #{data['email']} failed permanently. Dead letter processing..."
+  end
+end
+
+def init_image_workers(queue)
+  queue.register_handler('process_image') do |data|
+    puts "Processing image #{data['imageId']}..."
+  end
+end
+
+init_email_workers(queue)
+init_image_workers(queue)
+
+queue.start_dashboard(8080)
+
+# Trap signals for graceful shutdown
+trap('INT') { queue.shutdown; exit }
+trap('TERM') { queue.shutdown; exit }
+
+queue.start_listening
+```

data/snerdmq.gemspec

@@ -3,7 +3,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = "snerdmq"
-  spec.version       = "0.3.3"
+  spec.version       = "0.3.5"
   spec.authors       = ["Greyhands2"]
   spec.email         = ["developer@example.com"]
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: snerdmq
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.3.5
 platform: ruby
 authors:
 - Greyhands2
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-19 00:00:00.000000000 Z
+date: 2026-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack