philiprehberger-progress 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8cd9b24ec4af77caa0242168972123e46f8aefe0aa7d010f355f634462d4e7ad
-  data.tar.gz: 956912f23898fd45c2434b06030aea103af6d33f390f11fc432a7cf285983325
+  metadata.gz: fb855052746be6b7d6a120d7ad8b84ce16c8ccce47534463d04b698c680ea0fa
+  data.tar.gz: 2bf7bbafcf7feb5985c8baacc4a5eb10cbab3b5ee75f25d10a0512704230212a
 SHA512:
-  metadata.gz: 79fcad8d626d2869ac6c3bfa9d29ec243c134f7c140dfca896282c940bb82b3879d25378b229162441708d13fc204c6e912c5f802fef0b9331fc4bd9bb845889
-  data.tar.gz: d0074a78f1adfa22c1c749bf6367c468dfdfb1fa011d56ab88b83faedcc86625ada2f5982430cdc2f69013c66ead9bd030058d0b538959b3778cbfc94c86cb9c
+  metadata.gz: 0b5e4769b17f4a50df8fba852ad7a9eddd1821207051bc1cd3011a2a1ef71afd2369ea6d984be789cb95be6a3e2271caf4872b32180d96ed63ddd0538956c9c1
+  data.tar.gz: c71135352b91900baa613bd2b2c87edd51d1992bd57ef586734b3328fd9fb44c330c2a1af8ecb2827f0b29ba7180860e453ffbe1abfc4e7e1a25142c811d5dc4

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
+- `Bar#remaining` — number of steps remaining (clamped to non-negative). Also added to `Bar#to_h`.
+
 ## [0.5.0] - 2026-04-14
 
 ### Added

data/README.md

@@ -116,7 +116,8 @@ Export the current state as a hash:
 bar = Philiprehberger::Progress::Bar.new(total: 100)
 50.times { bar.advance }
 bar.to_h
-# => { percentage: 50.0, elapsed: 1.2, eta: 1.2, throughput: 41.7, current: 50, total: 100 }
+# => { percentage: 50.0, elapsed: 1.2, eta: 1.2, throughput: 41.7, current: 50, total: 100, remaining: 50 }
+bar.remaining # => 50
 ```
 
 ### JSON Mode
@@ -186,7 +187,8 @@ multi.finished?  # => true
 | `#elapsed` | Elapsed time in seconds (excludes paused time) |
 | `#eta` | Estimated time remaining in seconds |
 | `#throughput` | Items per second |
-| `#to_h` | Hash with `:percentage`, `:elapsed`, `:eta`, `:throughput`, `:current`, `:total` |
+| `#remaining` | Number of steps remaining (clamped to non-negative) |
+| `#to_h` | Hash with `:percentage`, `:elapsed`, `:eta`, `:throughput`, `:current`, `:total`, `:remaining` |
 | `#to_s` | Render the bar as a string (or JSON line in json_mode) |
 
 ### `Philiprehberger::Progress::Spinner`

data/lib/philiprehberger/progress/bar.rb

@@ -103,6 +103,13 @@ module Philiprehberger
         (@current.to_f / @total * 100).round(1)
       end
 
+      # Number of steps remaining (clamped to non-negative).
+      #
+      # @return [Integer]
+      def remaining
+        [@total - @current, 0].max
+      end
+
       def elapsed
         raw = now - @start_time - @pause_elapsed
         raw -= (now - @pause_start) if @paused
@@ -132,7 +139,8 @@ module Philiprehberger
           eta: eta,
           throughput: throughput,
           current: @current,
-          total: @total
+          total: @total,
+          remaining: remaining
         }
       end
 

data/lib/philiprehberger/progress/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module Progress
-    VERSION = '0.5.0'
+    VERSION = '0.6.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-progress
 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-15 00:00:00.000000000 Z
+date: 2026-05-07 00:00:00.000000000 Z
 dependencies: []
 description: Display progress bars with percentage, ETA, and throughput, or spinners
   for indeterminate tasks. Supports block-based usage, enumerable iteration with each/map,