ruby-progress 1.3.2 → 1.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c5a7ddc53059cb7f6d2b7bd1c066653058e1dbb281f4c23aa04229ce360a594
-  data.tar.gz: 0446a713142b93f16b9fe3e102c8a3c0db3194db17da25de7f1f7f31e5090907
+  metadata.gz: b46930eb2d8991d939a50094820ddfd0821203a8ee1b393bbb3a1269d8c2032f
+  data.tar.gz: ae70d2f66ff64d6816b177a0e145d7c6ae8f6d1ee98f71cfb7198a9784493c36
 SHA512:
-  metadata.gz: 3cda8e32c95b8bd03d6c8549de1b3f4fc488f868cb028a554ddc44654428978bfd1db4178a1cb0a0a71c9a0c8ea46a1cc8da844c4026ef9b84ed45c1b43f4691
-  data.tar.gz: 39c31e85f87ea2201cbf3267fefedff1f4946f6bef9b1ee6178b8e1b5ecf8569a8391c20519582a1077bd6d352d229b01997ceedb358eeb049cf484c895028ed
+  metadata.gz: 3323def54c36c02851a2b8da4c7daca769038631ad18610f89f1e6c390449785946f61cd70a53eebc96d93b0e8da2713c228bb4078df36d8b9e3a69a6c4c4d96
+  data.tar.gz: 66fb49464bfe312d53110de3cceb38c8e3c64f12c7b6e1790bde8da547ee6fb726d15c77458db6409dd72efebb4982b3ac7bec97197457f3162fe4527ece7d12

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-10-13 12:49:46 UTC using RuboCop version 1.75.7.
+# on 2025-10-14 13:03:02 UTC using RuboCop version 1.75.7.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -22,10 +22,11 @@ Layout/TrailingEmptyLines:
   Exclude:
     - 'test_worm_flags.rb'
 
-# Offense count: 2
+# Offense count: 5
 # Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
 Lint/DuplicateBranch:
   Exclude:
+    - 'lib/ruby-progress/output_capture.rb'
     - 'lib/ruby-progress/utils.rb'
     - 'lib/ruby-progress/worm.rb'
 
@@ -56,38 +57,43 @@ Lint/UselessAssignment:
     - 'demo_gem.rb'
     - 'spec/cli_integration_spec.rb'
 
-# Offense count: 52
+# Offense count: 50
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 122
+  Max: 121
 
-# Offense count: 49
+# Offense count: 52
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 # AllowedMethods: refine
 Metrics/BlockLength:
   Max: 111
 
-# Offense count: 4
+# Offense count: 5
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 268
+  Max: 200
 
-# Offense count: 30
+# Offense count: 33
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/CyclomaticComplexity:
   Max: 26
 
-# Offense count: 68
+# Offense count: 70
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 156
+  Max: 140
 
-# Offense count: 9
+# Offense count: 10
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ModuleLength:
-  Max: 285
+  Max: 287
+
+# Offense count: 1
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 6
 
-# Offense count: 31
+# Offense count: 32
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/PerceivedComplexity:
   Max: 27
@@ -174,7 +180,7 @@ Style/StringLiterals:
   Exclude:
     - 'test_worm_flags.rb'
 
-# Offense count: 39
+# Offense count: 46
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https

data/CHANGELOG.md

@@ -27,6 +27,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Merge commit: 99d9c39 (squash-merge of feature/output-handling)
 
+## Unreleased
+
+### Fixed
+
+- Output capture: ensure `--output-lines N` is honored when reserving terminal rows for captured output; coerce the `lines` option to an integer and stabilize the reserve/redraw logic so live captured output does not overwrite the prompt or animation.
+
+### Changed
+
+- Prepared for next patch release.
+
+## 1.3.3 - 2025-10-14
+
+### Fixed
+
+- Output capture: ensure `--output-lines N` is honored when reserving terminal rows for captured output; coerce the `lines` option to an integer and stabilize the reserve/redraw logic so live captured output does not overwrite the prompt or animation.
+
+### Changed
+
+- Removed one-off init trace writes and cleaned debug logging. Bumped main gem `VERSION` to 1.3.3 during intermediate fixes.
+
 ## 1.3.2 - 2025-10-13
 
 ### Added
@@ -38,147 +58,93 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added `--stop-id NAME` shorthand for targeting named daemons (implies `--stop` and normalizes the name to the canonical PID filename). This is a small convenience used by the demo and scripts.
 - Demo: updated `demo_screencast.rb` to call the local `bin/prg` when stopping the demo daemon to avoid conflicts with system-installed versions.
 
-### Changed
+# CHANGELOG
 
-- Bumped `FILL_VERSION` (patch) to reflect the new CLI behavior.
+All notable changes to this project will be documented in this file.
 
+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).
 
-## 1.2.3 - 2025-10-11
+## Unreleased
 
-### Added
+### Fixed
 
-- Dedicated `fill` shim: added `bin/fill` that delegates to `prg fill`.
+- Output capture: ensure `--output-lines N` is honored when reserving terminal rows for captured output; coerce the `lines` option to an integer and stabilize the reserve/redraw logic so live captured output does not overwrite the prompt or animation.
 
 ### Changed
 
-- Version bumps: prg 1.2.2 → 1.2.3, fill 1.0.0 → 1.0.1
+- Prepared for next patch release.
 
-## 1.2.2 - 2025-10-11
+## 1.3.4 - 2025-10-14
 
-### Improved
+### Fixed
 
-- Demo script enhancements: updated quick demo with better visual examples.
+- Ensure non-live (`--stdout`) capture does not stream output to the terminal during animation; captured output is now emitted at completion only.
+- Stabilized PTY-based output capture redraw/reserve logic and cursor save/restore fallback.
 
-### Technical
+### Changed
 
-- Version alignment: synchronized demo script version display with actual gem version.
+- Bumped main gem `VERSION` to 1.3.4.
+- Cleaned up one-off debug/init traces written during development.
 
-## 1.2.4 - 2025-10-12
+## 1.3.3 - 2025-10-14
 
-### Added
+### Fixed
 
-- Small bug fixes and test stability improvements:
-    - Ensured SimpleCov finalization runs reliably across Ruby versions during tests.
-    - Minor CLI help text clarifications and version constant alignment.
+- Output capture: ensure `--output-lines N` is honored when reserving terminal rows for captured output; coerce the `lines` option to an integer and stabilize the reserve/redraw logic so live captured output does not overwrite the prompt or animation.
 
 ### Changed
 
-- Bumped gem version and synchronized component version constants where applicable.
-    - Messages now display cleanly at the beginning of a new line
-    - Affects all three commands: ripple, worm, and twirl
-    - Resolves issue where completion messages appeared mid-line after animation ended
-    - Improved professional appearance of CLI output
+- Removed one-off init trace writes and cleaned debug logging.
 
-Technical
+## 1.3.2 - 2025-10-13
 
-- **Enhanced display_completion method**: Added proper line clearing and cursor positioning
-    - Uses `re[2K` sequence followed by clean message display
-    - Updated test expectations to match new output format
-    - Maintains backward compatibility with existing functionality
+### Added
 
-## 1.2.0 - 2025-10-11
+- `fill` subcommand: added `-c, --command COMMAND` so the determinate progress bar can run and capture command output like the other subcommands. This includes `--output-lines` and `--output-position` support for reserving terminal rows during capture.
 
-### Added
+### Changed
 
-- **--ends flag for all commands**: New universal option to add start/end characters around animations
-    - Accepts even-length strings split in half for start and end characters
-    - Works across all three commands: ripple, worm, and twirl
-    - Examples: `--ends "[]"` → `[animation]`, `--ends "<<>>"` → `<<animation>>`
-    - Multi-byte character support for emojis: `--ends "🎯🎪"` → `🎯animation🎪`
-    - Graceful fallback for invalid input (odd-length strings)
-
-- **Comprehensive test coverage for new features**: Added extensive test suites
-    - Direction control tests: Forward-only vs bidirectional animation behavior
-    - Custom style tests: ASCII, Unicode, emoji, and mixed character pattern validation
-    - CLI integration tests: End-to-end testing for all new command-line options
-    - Ends functionality tests: Multi-byte character handling, error cases, help documentation
-    - Total: 58 new test examples covering all edge cases
-
-- **Worm direction control**: Fine-grained animation movement control
-    - `--direction forward` (or `-d f`): Animation moves only forward, resets at end
-    - `--direction bidirectional` (or `-d b`): Default back-and-forth movement
-    - Compatible with all worm styles including custom patterns
-
-- **Worm custom styles**: User-defined 3-character animation patterns
-    - Format: `--style custom=abc` where `abc` defines baseline, midline, peak characters
-    - ASCII support: `--style custom=_-=` → `___-=___`
-    - Unicode support: `--style custom=▫▪■` → geometric patterns
-    - Emoji support: `--style custom=🟦🟨🟥` → colorful animations
-    - Mixed characters: `--style custom=.🟡*` → combined ASCII and emoji
-    - Proper multi-byte character counting for accurate 3-character validation
-- **Ripple style flags**: `--spinner`, `--rainbow`, `--inverse`, and `--caps` flags deprecated in favor of unified `--style` system (backward
-compatibility maintained)
+- Added `--stop-id NAME` shorthand for targeting named daemons (implies `--stop` and normalizes the name to the canonical PID filename). This is a small convenience used by the demo and scripts.
+- Demo: updated `demo_screencast.rb` to call the local `bin/prg` when stopping the demo daemon to avoid conflicts with system-installed versions.
 
-### Fixed
+## 1.2.4 - 2025-10-12
 
-- **OptionParser conflicts**: Resolved parsing issues with optional arguments that could consume following flags
-- **Daemon workflow**: Streamlined daemon start/stop workflow eliminating need for redundant flag combinations
+### Added
 
-## 1.0.1 - 2025-01-01
+- Small bug fixes and test stability improvements; ensured SimpleCov finalization runs reliably across Ruby versions during tests and minor CLI help clarifications.
 
-## 1.1.0 - 2025-10-09
+## 1.2.3 - 2025-10-11
 
 ### Added
 
-- Shared daemon helpers module `RubyProgress::Daemon` for default PID file, control message file, status, and stop logic
-- Unified daemon flags across ripple and worm: `--daemon`, `--status`, `--stop`, `--pid-file`, `--stop-success`, `--stop-error`,
-`--stop-checkmark`
-- Ripple: daemon parity with worm, including clean shutdown on SIGUSR1/TERM/HUP/INT
+- Dedicated `fill` shim: added `bin/fill` that delegates to `prg fill`.
 
-### Changed
+## 1.2.2 - 2025-10-11
 
-- `bin/prg` now delegates status/stop/default PID handling to `RubyProgress::Daemon`
-- README updated with new daemon usage examples and flag descriptions
+### Improved
 
-Deprecated
+- Demo script enhancements: updated quick demo with better visual examples.
 
-- `--stop-pid` remains available but is deprecated in favor of `--stop [--pid-file FILE]`
+## 1.2.0 - 2025-10-11
 
 ### Added
 
-- Packaged as proper Ruby gem with library structure
-- Added RSpec test suite with comprehensive coverage
-- Added Rake tasks for version management and packaging
-- Added --checkmark and --stdout flags to Worm (ported from Ripple)
-- Added infinite mode to Worm (runs indefinitely without command like Ripple)
-- **Added unified `prg` binary with subcommands for both `ripple` and `worm`**
-- **Enhanced command-line interface with consistent flag support across both tools**
-- **Added `RubyProgress::Utils` module with universal terminal control utilities**
-- **Centralized cursor control, line clearing, and completion message functionality**
-- **Added daemon mode for background progress indicators in bash scripts**
-- **Implemented signal-based control (SIGUSR1) for clean daemon shutdown**
-
-### Changed
+- `--ends` flag for all commands and lots of smaller UX and testing improvements.
 
-- Moved classes into RubyProgress module
-- Separated logic into lib/ruby-progress/ structure
-- Created proper bin/ executables for ripple and worm
-- Updated README with gem installation and usage instructions
+## 1.1.0 - 2025-10-09
 
-### Fixed
+### Added
 
-- Fixed duplicate error messages in Worm error handling
-- Improved signal handling and cursor management
+- Shared daemon helpers module `RubyProgress::Daemon` and unified daemon flags across ripple and worm.
 
 ## 1.0.0 - 2025-10-09
 
 ### Added
 
-- Initial release with two progress indicators:
-    - Ripple: Text ripple animation with 30+ spinner styles, rainbow effects, and command execution
-    - Worm: Unicode wave animation with multiple styles and configurable options
-- Command-line interfaces for both tools
-- Support for custom speeds, messages, and styling options
-- Integration with system commands and process monitoring
+- Initial release with two progress indicators (Ripple and Worm) and basic CLI tooling.
+
+
+## 1.0.1 - 2025-01-01
 
 

data/Gemfile

@@ -10,4 +10,6 @@ group :development, :test do
   gem 'rspec', '~> 3.0'
   gem 'rubocop', '~> 1.21'
   gem 'simplecov', '~> 0.21', require: false
+  gem 'tty-cursor', '~> 0.7'
+  gem 'tty-screen', '~> 0.8'
 end

data/Gemfile.lock

@@ -1,7 +1,9 @@
 PATH
   remote: .
   specs:
-    ruby-progress (1.3.2)
+    ruby-progress (1.3.4)
+      tty-cursor (~> 0.7)
+      tty-screen (~> 0.8)
 
 GEM
   remote: https://rubygems.org/
@@ -55,6 +57,8 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.13.1)
     simplecov_json_formatter (0.1.4)
+    tty-cursor (0.7.1)
+    tty-screen (0.8.2)
     unicode-display_width (3.1.4)
       unicode-emoji (~> 4.0, >= 4.0.4)
     unicode-emoji (4.0.4)
@@ -69,6 +73,8 @@ DEPENDENCIES
   rubocop (~> 1.21)
   ruby-progress!
   simplecov (~> 0.21)
+  tty-cursor (~> 0.7)
+  tty-screen (~> 0.8)
 
 BUNDLED WITH
    2.6.8