philiprehberger-retry_queue 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84632c19e4b14130651e69107803a2b6ac6e7369cd44da66a1eaa7f4dd4af5bc
-  data.tar.gz: c68647a250798bb8640a67cb8a78fe531be97b1694b10c1a7ac8b9bbebb9f488
+  metadata.gz: 96d4078aaeb7a082f0b36dc2121077882c4ae88d5acba91acdf668b2de76d42c
+  data.tar.gz: 92e49204be845308e033260af04fa8aa1d40fa328ab14a7cb2c31a5e4c54cbb7
 SHA512:
-  metadata.gz: 0b08ca27ce50965c960de23dd07b8c645603fd7fa0dcbfff7fb6094d6f09a0d51f19be649f8135c507cf08d826064c0bd286e014c75889984adbebf40bd6f56b
-  data.tar.gz: e33e336e614769dcd56bd7833ac2d5074ce46a795f995ef886c0284ab9ffaa91acc08d419853c669bb313bc984a6d073d896701be84df8ad8d1a06bf6484fc12
+  metadata.gz: a43f5db92ac6e907a95b51b066852a55f9203f88f44600649dd12bfd6b93568dea33c12722869dc951b3f2927f70adca69a68a6cc423bdd4ac2463d815259319
+  data.tar.gz: 03466f8aeb298b0d4ff161b43a913967662ed59d2add9e5a9ff6cdbc7b027a849a556d370e9edd41badc3e18b409f05d43079f5b3ab28e08e0dc98839525cc4d

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-05-07
+
+### Added
+- `Result#failure_rate` — counterpart to `#success_rate`, returns the ratio of failed items to total. Returns `0.0` for empty batches.
+
 ## [0.5.0] - 2026-04-23
 
 ### Added

data/README.md

@@ -126,8 +126,13 @@ stats = result.stats
 ```ruby
 result = Philiprehberger::RetryQueue.process(items, max_retries: 3) { |item| call(item) }
 result.success_rate # => 0.92
+result.failure_rate # => 0.08
 ```
 
+`Result#failure_rate` is the counterpart to `#success_rate` and pairs naturally with
+it — for any non-empty Result, `success_rate + failure_rate` sums to `1.0`. Empty
+batches return `0.0` for both.
+
 ## API
 
 | Method | Description |
@@ -140,6 +145,7 @@ result.success_rate # => 0.92
 | `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#failure_rate` | Ratio of failed items to total (0.0..1.0); pairs with success_rate |
 | `Result#empty?` | `true` when `stats[:total]` is 0 |
 | `Result#size` | Returns `stats[:total]` (succeeded + failed count) |
 | `Result#reprocess_failed { \|item, error\| }` | Reprocess failed items, returns a new Result |

data/lib/philiprehberger/retry_queue/result.rb

@@ -59,6 +59,18 @@ module Philiprehberger
         @succeeded.size.to_f / total
       end
 
+      # Ratio of failed 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 failure_rate
+        total = @succeeded.size + @failed.size
+        return 0.0 if total.zero?
+
+        @failed.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.5.0'
+    VERSION = '0.6.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-retry_queue
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-23 00:00:00.000000000 Z
+date: 2026-05-07 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