ruby-progress 1.1.4 → 1.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 599c6e45e09421994859e63461afbe8291cc1e0580ea04f5ec6cce11ce24af6c
-  data.tar.gz: '08cd819f0e15c121ae19af452a12aa666c68ecf1a63f448c657e8f09499a9b23'
+  metadata.gz: 7b9c54f1a667742fffe32c16ac5d84b26e2e0c9c4ed34492913f61ffb084a44d
+  data.tar.gz: fbf1a1dc3293b68e3ac63e0cc1084bc27a5a99241d56df8843a87ce5f79c59db
 SHA512:
-  metadata.gz: 934d646d83e178445ca8d4f6c0deac2df5e7a4f3c24c6397f871ee6c2d6af1d01a15d28ddf5fc35b24f9c072a22da05a5133edb6256117647fbd662ad971b75c
-  data.tar.gz: b703ffa90548a16e8e71b35ec6f12550937aab9be5f46d3f7a4e1754d64fb7dac75104128bf5db4d95cc911b9285a383d20897d2d313c2a5d77d981e70f0c71b
+  metadata.gz: 52b88f06001f49dac80b6aa735b252ba0760fc123a7b28a5609ef7f7c570f0db43e07a3a104efb4f3a513befa3b7e3113b556847a4b095a4521586587d3d87c7
+  data.tar.gz: 90188577fa0935924cc01ba3e1520a3625fab2c80975cf105413f631e8e5ef8623a160aadd5fb6d03194f88c884be6b4599269296163b4ba4ca66edd0f585d9f

data/.rubocop.yml

@@ -0,0 +1,5 @@
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  NewCops: enable
+  SuggestExtensions: false

data/.rubocop_todo.yml

@@ -0,0 +1,201 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2025-10-09 14:47:16 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
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 4
+# Configuration parameters: EnforcedStyle, AllowedGems, Include.
+# SupportedStyles: Gemfile, gems.rb, gemspec
+# Include: **/*.gemspec, **/Gemfile, **/gems.rb
+Gemspec/DevelopmentDependencies:
+  Exclude:
+    - 'ruby-progress.gemspec'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: final_newline, final_blank_line
+Layout/TrailingEmptyLines:
+  Exclude:
+    - 'test_worm_flags.rb'
+
+# Offense count: 4
+# Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
+Lint/DuplicateBranch:
+  Exclude:
+    - 'bin/prg'
+    - 'lib/ruby-progress/utils.rb'
+    - 'lib/ruby-progress/worm.rb'
+
+# Offense count: 2
+# Configuration parameters: AllowComments, AllowEmptyLambdas.
+Lint/EmptyBlock:
+  Exclude:
+    - 'spec/worm_integration_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Lint/ScriptPermission:
+  Exclude:
+    - 'demo_gem.rb'
+    - 'demo_worm_infinite.rb'
+
+# Offense count: 1
+Lint/SelfAssignment:
+  Exclude:
+    - 'lib/ruby-progress/ripple.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AutoCorrect, AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
+# NotImplementedExceptions: NotImplementedError
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/ruby-progress/worm.rb'
+
+# Offense count: 23
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AutoCorrect.
+Lint/UselessAssignment:
+  Exclude:
+    - 'demo_gem.rb'
+    - 'lib/ruby-progress/worm.rb'
+    - 'spec/cli_integration_spec.rb'
+
+# Offense count: 20
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 114
+
+# Offense count: 17
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 109
+
+# Offense count: 2
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 254
+
+# Offense count: 12
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/CyclomaticComplexity:
+  Max: 19
+
+# Offense count: 31
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 131
+
+# Offense count: 3
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ModuleLength:
+  Max: 206
+
+# Offense count: 10
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/PerceivedComplexity:
+  Max: 20
+
+# Offense count: 1
+# Configuration parameters: ExpectMatchingDefinition, CheckDefinitionPathHierarchy, CheckDefinitionPathHierarchyRoots, Regex, IgnoreExecutableScripts, AllowedAcronyms.
+# CheckDefinitionPathHierarchyRoots: lib, spec, test, src
+# AllowedAcronyms: CLI, DSL, ACL, API, ASCII, CPU, CSS, DNS, EOF, GUID, HTML, HTTP, HTTPS, ID, IP, JSON, LHS, QPS, RAM, RHS, RPC, SLA, SMTP, SQL, SSH, TCP, TLS, TTL, UDP, UI, UID, UUID, URI, URL, UTF8, VM, XML, XMPP, XSRF, XSS
+Naming/FileName:
+  Exclude:
+    - 'Rakefile.rb'
+    - 'lib/ruby-progress.rb'
+
+# Offense count: 17
+# Configuration parameters: EnforcedStyle, CheckMethodNames, CheckSymbols, AllowedIdentifiers, AllowedPatterns.
+# SupportedStyles: snake_case, normalcase, non_integer
+# AllowedIdentifiers: TLS1_1, TLS1_2, capture3, iso8601, rfc1123_date, rfc822, rfc2822, rfc3339, x86_64
+Naming/VariableNumber:
+  Exclude:
+    - 'lib/ruby-progress/ripple.rb'
+
+# Offense count: 2
+# Configuration parameters: AllowedConstants.
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+    - 'lib/ruby-progress.rb'
+    - 'lib/ruby-progress/daemon.rb'
+
+# Offense count: 4
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: allowed_in_returns, forbidden
+Style/DoubleNegation:
+  Exclude:
+    - 'bin/prg'
+    - 'lib/ruby-progress/worm.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AutoCorrect, EnforcedStyle, AllowComments.
+# SupportedStyles: empty, nil, both
+Style/EmptyElse:
+  Exclude:
+    - 'lib/ruby-progress/ripple.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: always, always_true, never
+Style/FrozenStringLiteralComment:
+  Exclude:
+    - '**/*.arb'
+    - 'test_worm_flags.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: AllowedReceivers.
+# AllowedReceivers: Thread.current
+Style/HashEachMethods:
+  Exclude:
+    - 'lib/ruby-progress/ripple.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+Style/InfiniteLoop:
+  Exclude:
+    - 'lib/ruby-progress/ripple.rb'
+
+# Offense count: 2
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: EnforcedStyle, AllowedMethods, AllowedPatterns.
+# SupportedStyles: predicate, comparison
+Style/NumericPredicate:
+  Exclude:
+    - 'spec/**/*'
+    - 'bin/prg'
+    - 'lib/ruby-progress/ripple.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: RequireEnglish, EnforcedStyle.
+# SupportedStyles: use_perl_names, use_english_names, use_builtin_english_names
+Style/SpecialGlobalVars:
+  Exclude:
+    - 'lib/ruby-progress/ripple.rb'
+
+# Offense count: 6
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
+# SupportedStyles: single_quotes, double_quotes
+Style/StringLiterals:
+  Exclude:
+    - 'test_worm_flags.rb'
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 154

data/CHANGELOG.md

@@ -5,6 +5,80 @@ 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.1.8] - 2025-10-10
+
+### Added
+
+- **Intelligent fuzzy matching for twirl styles**: Enhanced twirl style selector with sophisticated pattern matching
+  - Exact matches: Direct style name matching (case-insensitive)
+  - Prefix matches: `ar` matches `arc` instead of `arrow` (shortest match priority)
+  - Character-by-character fuzzy matches: `cls` matches `classic` (sequential character matching)
+  - Substring fallback: Comprehensive matching for partial inputs
+  - Works dynamically against all available indicator styles in `RubyProgress::INDICATORS`
+
+### Improved
+
+- **Worm message spacing**: Enhanced visual formatting for worm animations
+  - Automatic space insertion between `--message` text and animation
+  - Clean formatting: `"Loading data ●··●·"` instead of `"Loading data●··●·"`
+  - No extra spacing when no message is provided
+  - Consistent behavior across all worm animation methods (standard, daemon, aggressive clearing)
+
+### Technical
+
+- **Enhanced test coverage**: Added comprehensive fuzzy matching test suite for twirl styles
+  - 13 test cases covering exact, prefix, fuzzy, and edge case scenarios
+  - Validation of shortest match priority and character-order matching
+  - Integration with existing comprehensive test coverage (maintained at 70.47%)
+
+## [1.1.7] - 2025-10-10
+
+### Added
+
+- **Visual style previews**: Added `--show-styles` flag to all subcommands showing visual previews of animation styles
+  - Global `prg --show-styles` displays all styles for all subcommands with visual examples
+  - Subcommand-specific `prg <subcommand> --show-styles` shows only relevant styles
+  - Ripple styles show "Progress" text with actual color/effect rendering
+  - Worm styles display wave patterns like `··●⬤●··` for circles style
+  - Twirl styles show spinner character sequences like `◜ ◠ ◝ ◞ ◡ ◟` for arc style
+- **Process management**: Added `--stop-all` flag for comprehensive process control
+  - Global `prg --stop-all` stops all prg processes across all subcommands
+  - Subcommand-specific `prg <subcommand> --stop-all` stops only processes for that animation type
+  - Smart process detection excludes current process to prevent self-termination
+  - Graceful termination using TERM signal for proper cleanup
+
+### Improved
+
+- **Error handling**: Replaced verbose Ruby stack traces with clean, user-friendly error messages
+  - Invalid command-line options now show simple "Invalid option: --flag-name" messages
+  - Each error includes appropriate usage information and help guidance
+  - Consistent error format across all subcommands (ripple, worm, twirl)
+- **Style discovery**: Enhanced distinction between `--list-styles` (simple name lists) and `--show-styles` (visual previews)
+- **Silent process management**: All `--stop` and `--stop-all` commands now operate silently
+  - No status messages or confirmation output for cleaner automation
+  - Exit code 0 when processes found and stopped successfully
+  - Exit code 1 when no processes found to stop
+- **Terminal output separation**: Moved all animations to stderr for proper stream handling
+  - Animations and progress indicators use stderr (status information)
+  - Application output remains on stdout (program data)
+  - Fixes daemon mode output interruption issues
+- **Enhanced process cleanup**: Improved daemon process termination reliability
+  - Uses TERM signal first for graceful shutdown, followed by KILL if needed
+  - Comprehensive process detection and cleanup across all subcommands
+  - Better handling of orphaned processes
+- **Version display**: Enhanced `--version` output to show individual subcommand versions
+  - Main version: `prg version 1.1.7`
+  - Component versions: `ripple (v1.0.5)`, `worm (v1.0.2)`, `twirl (v1.0.0)`
+  - Enables tracking of individual component changes
+
+### Technical
+
+- **Test coverage**: Significantly improved test coverage from ~60% to 74.53%
+  - Added comprehensive error handling tests
+  - Enhanced daemon lifecycle testing
+  - Improved edge case coverage for all animation types
+  - Added version constant validation tests
+
 ## [1.1.4] - 2025-10-09
 
 ### Fixed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ruby-progress (1.1.4)
+    ruby-progress (1.1.8)
 
 GEM
   remote: https://rubygems.org/

data/Rakefile

@@ -7,7 +7,7 @@ require 'rubocop/rake_task'
 RSpec::Core::RakeTask.new(:spec)
 RuboCop::RakeTask.new
 
-task default: %i[spec rubocop]
+task default: [:spec]
 
 # Used by markdown tasks
 MARKDOWN_GLOB = ['**/*.md'].freeze
@@ -34,7 +34,6 @@ task :bump_major do
   bump_version(:major)
 end
 
-# rubocop:disable Metrics/MethodLength, Metrics/AbcSize
 def bump_version(type)
   require_relative 'lib/ruby-progress/version'
   version_parts = RubyProgress::VERSION.split('.').map(&:to_i)
@@ -61,8 +60,6 @@ def bump_version(type)
 
   puts "Version bumped from #{RubyProgress::VERSION} to #{new_version}"
 end
-# rubocop:enable Metrics/MethodLength, Metrics/AbcSize
-
 # Package management
 desc 'Clean up generated files'
 task :clobber do
@@ -89,7 +86,6 @@ task :test_binaries do
 end
 
 # Markdown lint/fix tasks (no external deps)
-# rubocop:disable Metrics/BlockLength
 namespace :markdown do
   def markdown_files
     Dir.glob(MARKDOWN_GLOB).reject do |p|
@@ -105,7 +101,7 @@ namespace :markdown do
     !!(line =~ /^\s*```|^\s*~~~/)
   end
 
-  # rubocop:disable Metrics/MethodLength, Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+  # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
   def format_markdown(content)
     lines = content.split("\n", -1)
     out = []
@@ -164,7 +160,7 @@ namespace :markdown do
     out << '' if (last = out.last) && !last.empty?
     out.join("\n")
   end
-  # rubocop:enable Metrics/MethodLength, Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+  # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
 
   desc 'Lint markdown (reports files that would be changed)'
   task :lint do
@@ -202,4 +198,3 @@ namespace :markdown do
     end
   end
 end
-# rubocop:enable Metrics/BlockLength