Skip to content

Add Options overlay (threads/emoji), improve output, bump to 2.5.1 - #9

Merged
VoltKraft merged 5 commits into
mainfrom
WIP
Nov 7, 2025
Merged

Add Options overlay (threads/emoji), improve output, bump to 2.5.1#9
VoltKraft merged 5 commits into
mainfrom
WIP

Conversation

@VoltKraft

Copy link
Copy Markdown
Owner

This PR enhances the interactive UX and console output of PBS_Chunk_Checker, introduces a menu-driven Options overlay, adds emoji/ASCII toggling, improves progress and summary formatting, and bumps the version to 2.5.1.

Key Changes

Interactive TUI
Add Options overlay (press o) to adjust thread count and toggle emoji output.
Add version popup (press v) in TUI and fallback menu.
Numeric menu fallback remains available; can be forced via PBS_CC_NO_CURSES=1.
CLI
Add --version flag (prints 2.5.1).
Add --no-emoji to disable emoji output.
Standardize terminology to “threads”; keep --workers as a hidden alias for backward compatibility.
Default threads = min(32, 2 × CPU cores) with validation.
Output improvements
Show a thread icon for the configured thread count (ASCII fallback when emojis are disabled).
Include completion percentages and live runtime timer on index and chunk progress lines.
Rework chunk usage summary into aligned columns and add unique/duplicate percentages.
Docs
Update README with new usage, TUI controls, Options overlay, flags, defaults, and refreshed output example.
Why

Make configuration discoverable during interactive runs.
Improve readability and situational awareness during long operations.
Provide clear, copy-pastable documentation and examples.
Compatibility

No breaking changes.
--workers remains as an alias to --threads.
Emoji output can be disabled via --no-emoji or falls back automatically.
Files

PBS_Chunk_Checker.py
README.md
References

Version: PBS_Chunk_Checker.py:21, README.md:10
TUI hotkeys and Options: README.md:68, README.md:75
CLI flags: PBS_Chunk_Checker.py:1258, PBS_Chunk_Checker.py:1274, PBS_Chunk_Checker.py:1283
Summary formatting and percentages: PBS_Chunk_Checker.py:1453
Test Plan

Interactive: run without args; press o to change threads and toggle emoji; press v to show version.
CLI: ./PBS_Chunk_Checker.py --version, --threads N, --workers N, --no-emoji.
Verify output shows percentages, timers, thread icon/label, and aligned summary.

… show version/options hotkeys; update README

Add curses Options overlay (list navigation, Space toggles)
Implement emoji output toggle (✔/✘) equivalent to --no-emoji
Move workers setting into Options; keep background visible
Add global hotkeys: o (options), v (version)
Update README with controls and workers explanation
… show version/options hotkeys; update README

Add curses Options overlay (list navigation, Space toggles)
Implement emoji output toggle (✔/✘) equivalent to --no-emoji
Move workers setting into Options; keep background visible
Add global hotkeys: o (options), v (version)
Update README with controls and workers explanation
…, and aligned summary

Replace “workers” with “threads” across CLI, UI, and logs
Add thread icon (🧵, ASCII [THREADS]) and print Threads on its own line
Show percent complete on Index and Chunk progress lines
Align “Chunk usage summary” values in table-like columns
Keep --workers as hidden alias for backward compatibility; add --threads
Update README examples and docs to reflect changes
Confirm consistency between script and README (v2.5.1, CLI flags, defaults, TUI behavior, output).
Update README to state the Options overlay adjusts threads and toggles emoji (was phrased as future capability).
Note: --workers alias exists in code but remains undocumented intentionally.
@VoltKraft
VoltKraft merged commit 020f020 into main Nov 7, 2025
3 checks passed
@VoltKraft
VoltKraft deleted the WIP branch November 7, 2025 23:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant