philiprehberger-progress 0.1.10 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e560bf8164797ea9cdae72cbc7a49616ed9c8dbad91346fc78c26148b3eb2c97
-  data.tar.gz: bb204cbe97276cacaf5f75e736096c0ba6d3769413ad1ec732ff99b0ed41ddbd
+  metadata.gz: f8cedfd9240c3ab6dd70848fbc63dca19ca4e3eea6d13ccada9e1663c73ca75d
+  data.tar.gz: 3a81c872fc39dc070eaa68e0393c0e65d9878f7d54b01bd3ec9af557a40b92e2
 SHA512:
-  metadata.gz: '091e1a8fc2e928687b84148b5b90f983ca5c5eb204d65a35978917c4c1ffb95e14e4dc53897ac60af3a7a71b7a08766a2abca3b11a14fa133258b6b464247e13'
-  data.tar.gz: e35b2ac112952aaeb54327c5db0cc0b2b3132c9859f141440db76159848600744ac83e72974dfb3965c6ae77b81276534361376b2d1a0b9e87d750ed9e95ee81
+  metadata.gz: 309c39e3e947e5dc7c9465cd4f1a1feff1fa9ec38221a11325243202c8f9e6326f1e60b458138b9d7fb2ec50ddd5b98cdf7425227d4a913b0dda464a3fd3d137
+  data.tar.gz: 985d65af32ab52d1310b2f01e24b7024a1595e1357a1f09c074ad9bc636ffb0445a33b00fc5a943472955cf5c0d663df516905cb67140db80734ed6af218300e

data/CHANGELOG.md

@@ -7,6 +7,31 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [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
+- Multi-bar support via `Philiprehberger::Progress::Multi` for tracking concurrent tasks
+- `Progress.multi` convenience method
+- GitHub issue template gem version field
+- Feature request "Alternatives considered" field
+
+### Fixed
+- Gemspec author and email to match standard template
+
+## [0.1.11] - 2026-03-31
+
+### Added
+- Add GitHub issue templates, dependabot config, and PR template
+
 ## [0.1.10] - 2026-03-31
 
 ### Changed
@@ -67,3 +92,17 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - `Progress.spin` convenience method with block support
 - `Progress.each` for iterating enumerables with progress display
 - TTY detection to auto-disable rendering in non-terminal environments
+
+[0.3.0]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.3.0
+[0.2.0]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.2.0
+[0.1.11]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.1.11
+[0.1.10]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.1.10
+[0.1.9]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.1.9
+[0.1.8]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.1.8
+[0.1.7]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.1.7
+[0.1.6]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.1.6
+[0.1.5]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.1.5
+[0.1.4]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.1.4
+[0.1.3]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.1.3
+[0.1.2]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.1.2
+[0.1.0]: https://github.com/philiprehberger/rb-progress/releases/tag/v0.1.0

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,31 @@ 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
+require "philiprehberger/progress"
+
+multi = Philiprehberger::Progress.multi do |m|
+  downloads = m.add("Downloads", total: 100)
+  uploads   = m.add("Uploads", total: 50)
+
+  100.times { downloads.advance }
+  50.times { uploads.advance }
+end
+
+multi.finished?  # => true
+```
+
 ## API
 
 ### `Philiprehberger::Progress::Bar`
@@ -99,17 +137,33 @@ end
 |--------|-------------|
 | `.new(message:, output: $stderr)` | Create a spinner |
 | `#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 |
 
+### `Philiprehberger::Progress::Multi`
+
+| Method | Description |
+|--------|-------------|
+| `Multi.new(output: $stderr)` | Create multi-bar tracker |
+| `Multi#add(label, total:, width: 30)` | Add a named progress bar |
+| `Multi#[](label)` | Retrieve a bar by label |
+| `Multi#labels` | List of bar labels in order |
+| `Multi#bars` | Hash of label to bar |
+| `Multi#finished?` | True when all bars are finished |
+| `Multi#render` | Render all bars to output |
+| `Multi#reset` | Clear all bars |
+
 ### Module Methods
 
 | Method | Description |
 |--------|-------------|
 | `Progress.bar(total:, &block)` | Create bar, auto-finish after block |
 | `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/multi.rb

@@ -1,3 +1,56 @@
 # frozen_string_literal: true
 
-# This file is kept for backward compatibility but is no longer actively used.
+module Philiprehberger
+  module Progress
+    class Multi
+      def initialize(output: $stderr)
+        @output = output
+        @bars = {}
+        @order = []
+      end
+
+      def add(label, total:, width: 30)
+        bar = Bar.new(total: total, width: width, output: @output)
+        @bars[label] = bar
+        @order << label unless @order.include?(label)
+        bar
+      end
+
+      def [](label)
+        @bars[label]
+      end
+
+      def bars
+        @bars.dup
+      end
+
+      def labels
+        @order.dup
+      end
+
+      def finished?
+        return false if @bars.empty?
+
+        @bars.values.all?(&:finished?)
+      end
+
+      def render
+        return unless @output.respond_to?(:tty?) && @output.tty?
+
+        lines = @order.map do |label|
+          bar = @bars[label]
+          "#{label}: #{bar}"
+        end
+        @output.print("\e[#{lines.size}A") if @rendered_once
+        lines.each { |line| @output.puts(line) }
+        @rendered_once = true
+      end
+
+      def reset
+        @bars.clear
+        @order.clear
+        @rendered_once = false
+      end
+    end
+  end
+end

data/lib/philiprehberger/progress/spinner.rb

@@ -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.1.10'
+    VERSION = '0.3.0'
   end
 end

data/lib/philiprehberger/progress.rb

@@ -3,6 +3,7 @@
 require_relative 'progress/version'
 require_relative 'progress/bar'
 require_relative 'progress/spinner'
+require_relative 'progress/multi'
 
 module Philiprehberger
   module Progress
@@ -30,6 +31,16 @@ module Philiprehberger
       end
     end
 
+    def self.multi(output: $stderr)
+      m = Multi.new(output: output)
+      if block_given?
+        yield m
+        m
+      else
+        m
+      end
+    end
+
     def self.each(enumerable, label: nil, output: $stderr)
       items = enumerable.to_a
       bar = Bar.new(total: items.length, output: output)
@@ -42,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,20 +1,21 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-progress
 version: !ruby/object:Gem::Version
-  version: 0.1.10
+  version: 0.3.0
 platform: ruby
 authors:
-- philiprehberger
+- Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 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:
-- philiprehberger@users.noreply.github.com
+- me@philiprehberger.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -27,11 +28,11 @@ files:
 - lib/philiprehberger/progress/multi.rb
 - lib/philiprehberger/progress/spinner.rb
 - lib/philiprehberger/progress/version.rb
-homepage: https://github.com/philiprehberger/rb-progress
+homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-progress
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/philiprehberger/rb-progress
+  homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-progress
   source_code_uri: https://github.com/philiprehberger/rb-progress
   changelog_uri: https://github.com/philiprehberger/rb-progress/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/philiprehberger/rb-progress/issues
@@ -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:
   - - ">="