Skip to content

Commit 1b5a99b

Browse files
committed
docs(CHANGES): Add changelog entries for teamocil, tmuxinator parity
why: Document the three new features for the upcoming release. what: - Pane.set_title() and pane_title support - Configurable tmux binary path (Server tmux_bin parameter) - Pre-execution command logging in tmux_cmd
1 parent ea56146 commit 1b5a99b

1 file changed

Lines changed: 52 additions & 0 deletions

File tree

CHANGES

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,58 @@ $ uvx --from 'libtmux' --prerelease allow python
3636
_Notes on the upcoming release will go here._
3737
<!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->
3838

39+
### What's new
40+
41+
#### Pane.set_title() (#636)
42+
43+
New {meth}`~libtmux.Pane.set_title` method wraps `select-pane -T`, and
44+
{attr}`~libtmux.Pane.title` provides a short alias for
45+
{attr}`~libtmux.Pane.pane_title`:
46+
47+
```python
48+
pane.set_title("my-worker")
49+
pane.pane_title
50+
# 'my-worker'
51+
pane.title
52+
# 'my-worker'
53+
```
54+
55+
The `pane_title` format variable is now included in libtmux's format queries
56+
(it was previously excluded).
57+
58+
#### Configurable tmux binary path (#636)
59+
60+
{class}`~libtmux.Server` now accepts a `tmux_bin` parameter to use an
61+
alternative tmux binary (e.g. wemux, byobu, or a custom build):
62+
63+
```python
64+
server = Server(socket_name="myserver", tmux_bin="/usr/local/bin/tmux-next")
65+
```
66+
67+
The path is threaded through {meth}`~libtmux.Server.cmd`,
68+
{meth}`~libtmux.Server.raise_if_dead`, {func}`~libtmux.neo.fetch_objs`,
69+
all version-check functions ({func}`~libtmux.common.has_version`,
70+
{func}`~libtmux.common.has_gte_version`, etc.), and hook scope guards in
71+
{class}`~libtmux.hooks.HooksMixin`. All child objects (Session, Window,
72+
Pane) inherit it automatically.
73+
Falls back to ``shutil.which("tmux")`` at execution time when not set.
74+
75+
#### Pre-execution command logging (#636)
76+
77+
{class}`~libtmux.common.tmux_cmd` now logs the full command line at
78+
`DEBUG` level *before* execution, complementing the existing post-execution
79+
stdout logging. This enables diagnostic output and is a prerequisite for a
80+
future dry-run mode.
81+
82+
### Bug fixes
83+
84+
#### `TmuxCommandNotFound` raised for invalid `tmux_bin` path (#636)
85+
86+
Previously, passing a non-existent binary path raised a raw
87+
`FileNotFoundError` from `subprocess`. It now raises
88+
{exc}`~libtmux.exc.TmuxCommandNotFound` consistently, in both
89+
`tmux_cmd` and `raise_if_dead`.
90+
3991
## libtmux 0.54.0 (2026-03-07)
4092

4193
### What's new

0 commit comments

Comments
 (0)