philiprehberger-retry_queue 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a5c95df7fb98070ed959408d5fce1be2d1b920a800221d831f24214ffe9425d1
-  data.tar.gz: d681958fb8eddf3710283315eb52ff81cc13bec03d67c0e72d1199ec5025ec9e
+  metadata.gz: 933efd4881279b847d651e774a565205b246ae3859b624cc2715373549664d58
+  data.tar.gz: c24e1b713702a4775248ca23b4e88d08dab9b2e077c0f78ca866ad08ec50a629
 SHA512:
-  metadata.gz: 4b91743778fba30ed468fe23da3157c4df3086a81c5aa1784f5d304a967967ad271e7dd9646a54d75a54379b5123f8589614249c346fa760ccc05111f7e6bdcc
-  data.tar.gz: e63ef43720e3915d2942c06fd34e33ca79aabe147b3fc678db7812759c0501e6b660e80e4ae37afcc59ab031f8250e04371766888cd873e2edd7f1dc1f9ae0bf
+  metadata.gz: d17e2e333cbf2cf723ea0bbb2519186a24487fc5fe1fc4410302791ba211292b8092f9d84120a713951d433a3dfb1a237d051a7f5ebe6d31cd47c3f102b93462
+  data.tar.gz: 408fb3f24b0928ecf0438a5773c5fafc6404b73139cecbfe470235bcb5476741197bb402054e8b96b1e480b74f3ac19d6564f569db9bfa0c57e4d7e512c22f72

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-19
+
+### Added
+- `Result#success_rate` — ratio of succeeded to total items as a Float in `[0.0, 1.0]`; returns `0.0` for empty batches
+
 ## [0.3.0] - 2026-04-17
 
 ### Added

data/README.md

@@ -107,6 +107,13 @@ stats = result.stats
 # => { total: 100, succeeded: 97, failed: 3, success_rate: 0.97, elapsed: 1.23 }
 ```
 
+### Success rate
+
+```ruby
+result = Philiprehberger::RetryQueue.process(items, max_retries: 3) { |item| call(item) }
+result.success_rate # => 0.92
+```
+
 ## API
 
 | Method | Description |
@@ -116,6 +123,7 @@ stats = result.stats
 | `Result#succeeded` | Array of successfully processed items |
 | `Result#failed` | Array of hashes with `:item`, `:error`, `:attempts` |
 | `Result#stats` | Hash with `:total`, `:succeeded`, `:failed`, `:success_rate`, `:elapsed` |
+| `Result#success_rate` | Float in `[0.0, 1.0]`; ratio of succeeded to total items (`0.0` for empty batches) |
 | `Result#reprocess_failed { \|item, error\| }` | Reprocess failed items, returns a new Result |
 
 ## Development

data/lib/philiprehberger/retry_queue/result.rb

@@ -28,11 +28,23 @@ module Philiprehberger
           total: total,
           succeeded: @succeeded.size,
           failed: @failed.size,
-          success_rate: total.zero? ? 0.0 : @succeeded.size.to_f / total,
+          success_rate: success_rate,
           elapsed: @elapsed
         }
       end
 
+      # Ratio of succeeded items to total processed items.
+      #
+      # Returns 0.0 for an empty batch to avoid ZeroDivisionError.
+      #
+      # @return [Float] ratio in the range [0.0, 1.0]
+      def success_rate
+        total = @succeeded.size + @failed.size
+        return 0.0 if total.zero?
+
+        @succeeded.size.to_f / total
+      end
+
       # Reprocess failed items by yielding each item and its last error to the block.
       # Returns a new Result with the reprocessing outcomes.
       #

data/lib/philiprehberger/retry_queue/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module RetryQueue
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-retry_queue
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-18 00:00:00.000000000 Z
+date: 2026-04-20 00:00:00.000000000 Z
 dependencies: []
 description: Processes collections of items with configurable per-item retry logic,
   exponential backoff, and dead letter collection for failed items. Returns detailed