philiprehberger-progress 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6f9be35e1424be64489b24f5d9b63bbf9a9b202b154c6c5c2139a8845a94f75
-  data.tar.gz: 0d8fedddb6f6a594f7ad766d996d2c98fb5a974ee4893942ce6be419eaaa653a
+  metadata.gz: 9d1ecb051d55213a818343c3133c067129bf55e65b6677a2efb9be49c249ab5b
+  data.tar.gz: '0039452f607ef4f9fe1f1a1098b31039c6ea7ecbc9c0618c8f8fba78b5464763'
 SHA512:
-  metadata.gz: cefbeb2571f5812ffbacc35d5dbf1df5b36523d7a51809b7030e945c7a3081e24934066a8cf3b8d4a261d87104da492d4d75637657da485c70ad48506688ddd7
-  data.tar.gz: fff6cb774a53a996ec6c757c8d5c3123656691d5cf7fe91dc21169ff4ac37819070427980784b852ce908b240cc18394c7bb584a8fffe74352e6dab01343f25b
+  metadata.gz: da6edc69bcc8dc77d091ba848dae89fb8f8e5054ceb1f9c6991537e85554b8a3bbde4cef23b94089d0c6194827ae6c13e3a7cb02f875d9d7ca9e3960519d7023
+  data.tar.gz: 5692a7b42fb906e3234117a3a96ca0ad2c1af88d558bc41e7a787cd8c1cc954a5c317613b91ff8d913b27b87263ea279d8bf497b19f17886cf57c8141578b6f8

data/CHANGELOG.md

@@ -2,11 +2,30 @@
 
 All notable changes to this gem will be documented in this file.
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-09
+
+### Added
+- `Bar#set(n)` to set absolute progress position
+- `Bar#reset` to restart the bar from 0, preserving configuration
+- `Spinner#message=` to update the spinner message dynamically
+
+### Changed
+- Standardize CHANGELOG header format to match template
+
+## [0.3.0] - 2026-04-09
+
+### Added
+- `Spinner#auto_spin(interval: 0.1)` starts a background thread that animates the spinner until `stop` is called
+- `Progress.map(enumerable) { |item| ... }` transforms items with a progress bar, returning the collected results
+
+### Fixed
+- Gemspec `required_ruby_version` format to `'>= 3.1.0'` (was `'>= 3.1'`)
+
 ## [0.2.0] - 2026-04-04
 
 ### Added

data/README.md

@@ -68,6 +68,19 @@ Philiprehberger::Progress.spin('Processing...') do |spinner|
 end
 ```
 
+### Auto-spinning
+
+Start a background thread that animates the spinner automatically:
+
+```ruby
+Philiprehberger::Progress.spin("Deploying...") do |spinner|
+  spinner.auto_spin
+  deploy!  # spinner animates while you work
+end
+```
+
+The thread is joined automatically when `stop` is called (or when the block completes).
+
 ### Enumerable Integration
 
 ```ruby
@@ -77,6 +90,15 @@ Philiprehberger::Progress.each(items) do |item|
 end
 ```
 
+### Mapping with Progress
+
+Transform items while displaying progress:
+
+```ruby
+results = Philiprehberger::Progress.map(urls) { |url| fetch(url) }
+# results contains the return values from each block call
+```
+
 ### Multi-bar
 
 ```ruby
@@ -101,6 +123,8 @@ multi.finished?  # => true
 |--------|-------------|
 | `.new(total:, width: 30, output: $stderr)` | Create a progress bar |
 | `#advance(n = 1)` | Advance by `n` items |
+| `#set(n)` | Set absolute progress position (clamped to 0..total) |
+| `#reset` | Reset to 0, clear finished state, restart timer |
 | `#finish` | Mark as complete |
 | `#finished?` | Whether the bar is finished |
 | `#percentage` | Current percentage (0.0 to 100.0) |
@@ -114,8 +138,10 @@ multi.finished?  # => true
 | Method | Description |
 |--------|-------------|
 | `.new(message:, output: $stderr)` | Create a spinner |
+| `#message=` | Update the spinner message dynamically |
 | `#spin` | Advance to the next frame |
-| `#stop(final_message = 'done')` | Stop with a message |
+| `#auto_spin(interval: 0.1)` | Start background thread animation |
+| `#stop(final_message = 'done')` | Stop with a message (joins background thread) |
 | `#stopped?` | Whether the spinner is stopped |
 | `#to_s` | Render the current frame with message |
 
@@ -140,6 +166,7 @@ multi.finished?  # => true
 | `Progress.spin(message, &block)` | Create spinner, auto-stop after block |
 | `Progress.multi(output: $stderr, &block)` | Create multi-bar tracker |
 | `Progress.each(enumerable, label: nil) { \|item\| }` | Iterate with progress |
+| `Progress.map(enumerable, label: nil) { \|item\| }` | Transform with progress, returns results |
 
 ## Development
 

data/lib/philiprehberger/progress/bar.rb

@@ -25,6 +25,28 @@ module Philiprehberger
         self
       end
 
+      # Set absolute progress position.
+      #
+      # @param n [Integer] the new current value (clamped to 0..total)
+      # @return [self]
+      def set(n)
+        return self if @finished
+
+        @current = [[n, 0].max, @total].min
+        render_to_output
+        self
+      end
+
+      # Reset the bar to 0, preserving total and width. Restarts the timer.
+      #
+      # @return [self]
+      def reset
+        @current = 0
+        @finished = false
+        @start_time = now
+        self
+      end
+
       def finish
         @current = @total
         @finished = true

data/lib/philiprehberger/progress/spinner.rb

@@ -6,7 +6,7 @@ module Philiprehberger
       FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807",
                 "\u280F"].freeze
 
-      attr_reader :message
+      attr_accessor :message
 
       def initialize(message:, output: $stderr)
         @message = message
@@ -23,8 +23,20 @@ module Philiprehberger
         self
       end
 
+      def auto_spin(interval: 0.1)
+        @auto_thread = Thread.new do
+          until @stopped
+            spin
+            sleep(interval)
+          end
+        end
+        self
+      end
+
       def stop(final_message = 'done')
         @stopped = true
+        @auto_thread&.join
+        @auto_thread = nil
         @output.write("\r\e[2K#{final_message}\n") if tty?
         self
       end

data/lib/philiprehberger/progress/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module Progress
-    VERSION = '0.2.0'
+    VERSION = '0.4.0'
   end
 end

data/lib/philiprehberger/progress.rb

@@ -53,5 +53,19 @@ module Philiprehberger
       bar.finish
       items
     end
+
+    def self.map(enumerable, label: nil, output: $stderr)
+      items = enumerable.to_a
+      bar = Bar.new(total: items.length, output: output)
+
+      results = items.map do |item|
+        result = yield item
+        bar.advance
+        result
+      end
+
+      bar.finish
+      results
+    end
   end
 end

metadata

@@ -1,18 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-progress
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-05 00:00:00.000000000 Z
+date: 2026-04-10 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, and auto-disables
-  rendering when not connected to a terminal.
+  for indeterminate tasks. Supports block-based usage, enumerable iteration with each/map,
+  background auto-spinning, multi-bar tracking, and auto-disables rendering when not
+  connected to a terminal.
 email:
 - me@philiprehberger.com
 executables: []
@@ -44,7 +45,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="