Skip to content

Commit 7da5d3a

Browse files
committed
docs(CHANGES) Progress spinner, structured logging, colorama removal
1 parent 433a656 commit 7da5d3a

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

CHANGES

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,42 @@ $ pipx install --suffix=@next 'tmuxp' --pip-args '\--pre' --force
3535
_Notes on the upcoming release will go here._
3636
<!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->
3737

38+
### What's new
39+
40+
#### Animated progress spinner for `tmuxp load` (#1017)
41+
42+
The `load` command now shows an animated spinner with real-time build progress
43+
as windows and panes are created. Five built-in presets control the display
44+
format (`default`, `minimal`, `window`, `pane`, `verbose`), and custom format
45+
strings are supported via `--progress-format` or `TMUXP_PROGRESS_FORMAT`.
46+
47+
- `--progress-lines N` / `TMUXP_PROGRESS_LINES`: Control how many lines of
48+
`before_script` output appear in the spinner panel (default: 3). Use `0` to
49+
hide the panel, `-1` for unlimited (capped to terminal height).
50+
- `--no-progress` / `TMUXP_PROGRESS=0`: Disable the spinner entirely.
51+
- During `before_script` execution, the progress bar shows a marching animation
52+
and ⏸ icon.
53+
54+
### Bug fixes
55+
56+
- Fix default CLI log level from INFO to WARNING so normal usage is not noisy (#1017)
57+
- Fix `before_script` failure logging from DEBUG to ERROR (#1017)
58+
- Fix `get_pane()` exception catch type to match sibling methods (#1017)
59+
- Route `ls --json` and `debug-info --json` through `OutputFormatter` for consistent machine-readable output (#1017)
60+
61+
### Development
62+
63+
#### Structured logging with `extra` context across all modules (#1017)
64+
65+
All modules now use `logging.getLogger(__name__)` with structured `extra` keys
66+
(`tmux_session`, `tmux_window`, `tmux_pane`, `tmux_config_path`, etc.) for
67+
filtering and aggregation. Library `__init__.py` adds `NullHandler` per Python
68+
best practices. A new `TmuxpLoggerAdapter` provides persistent context for
69+
objects with stable identity.
70+
71+
- Remove `colorama` runtime and type-stub dependencies; replace with stdlib ANSI constants (#1017)
72+
- Route all raw `print()` calls through `tmuxp_echo()` for consistent output channels (#1017)
73+
3874
## tmuxp 1.65.0 (2026-03-08)
3975

4076
### Breaking Changes

0 commit comments

Comments
 (0)