tlq-client 0.2.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0888c52bfd5c94d767673f92efe410094daa86fa50d844408e4830cee364130a'
-  data.tar.gz: 796ed9252ce96e44464f39b99296d09ce7a3763cb2d0eb62594e40fad98c3a41
+  metadata.gz: 40f40f39e20c3a46bb0d6cc6a5517fbb2d581e4996893307bffc84582f90bb15
+  data.tar.gz: 0f1686b89b1306f27866738e029709ec1e58d736ae87363f67660a1e7edcad1a
 SHA512:
-  metadata.gz: c986e9700b352ebb948511e61fdb48a5cf92387456c5e1e40bad75f9a7d03bd2b852f985439c9662c91e92ffa28a530d2aef2d60ab3882555a9b76ae09563148
-  data.tar.gz: c9aabb8ad51cf2e4e70b072c6fe42291506bef4ef556a240be2529df03f8599cb1cf2ea0826d6586f912fa7b9cc8273fe7c48cce442743c5031fa0ba666c300b
+  metadata.gz: 0da8db4deaf928c53ebd6f2caf1973054efe290b556253bfe022a4c2f8eaa3e27eabd64e474a18f83922ffb56c3ec50bd6b9ffd9151c32064f7e62f0fc86f578
+  data.tar.gz: 3863fa188edd2a85f074a9da0cf7e219f3c5528f4b4c3a1fcb41fb0ae74aab0d62b564044d419591a0bebee9f2f34ad2ec5f2459a9955b26b517aaea189bb157

data/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] - 2026-03-21
+
+### Added
+
+- `stats` - Get queue statistics (ready, processing, dead counts)
+
 ## [0.2.0] - 2025-11-26
 
 ### Added

data/README.md

@@ -58,6 +58,10 @@ ids = messages.map { |m| m['id'] }
 client.delete_messages(ids)  # Delete multiple
 client.retry_messages(ids)   # Retry multiple
 
+# Queue statistics
+stats = client.stats
+puts stats  # => {"ready" => 10, "processing" => 2, "dead" => 0}
+
 # Health check
 client.health_check  # => true
 
@@ -100,13 +104,17 @@ Returns messages to the queue for reprocessing. Increments `retry_count`. Accept
 
 Removes all messages from the queue. Cannot be undone.
 
+### `stats → Hash`
+
+Returns queue statistics with `ready`, `processing`, and `dead` counts.
+
 ### `health_check → Boolean`
 
 Returns `true` if the TLQ server is reachable.
 
 ## Requirements
 
-- Ruby >= 2.6
+- Ruby >= 3.1
 - Running [TLQ server](https://github.com/skyaktech/tlq)
 
 ## Development

data/lib/tlq_client/version.rb

@@ -3,5 +3,5 @@
 class TLQClient
   # The current version of the TLQClient gem.
   # @return [String] the semantic version string
-  VERSION = "0.2.1"
+  VERSION = "0.4.0"
 end

data/lib/tlq_client.rb

@@ -168,6 +168,26 @@ class TLQClient
     raise "HTTP request failed: #{e.message}"
   end
 
+  # Returns queue statistics from the TLQ server.
+  #
+  # @return [Hash] queue statistics containing 'ready', 'processing', and 'dead' counts
+  #
+  # @raise [RuntimeError] if the server response cannot be parsed as JSON
+  # @raise [RuntimeError] if the HTTP request fails
+  #
+  # @example Get queue stats
+  #   stats = client.stats
+  #   puts "Ready: #{stats['ready']}, Processing: #{stats['processing']}, Dead: #{stats['dead']}"
+  def stats
+    uri = URI("#{@base_uri}/stats")
+    response = Net::HTTP.get_response(uri)
+    JSON.parse(response.body)
+  rescue JSON::ParserError => e
+    raise "Failed to parse response: #{e.message}"
+  rescue StandardError => e
+    raise "HTTP request failed: #{e.message}"
+  end
+
   # Checks if the TLQ server is reachable and responding.
   #
   # @return [Boolean] true if the server is healthy and responding

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tlq-client
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Nebojsa Jakovljevic
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-11-28 00:00:00.000000000 Z
+date: 2026-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler