Skip to content

v0.63.0 - Python 3.11 floor, tmux 3.8 fixes

Latest

Choose a tag to compare

@tony tony released this 21 Nov 21:59
· 45 commits to master since this release

libtmux 0.63.0 raises the minimum Python to 3.11 and brings the library in line with tmux 3.8. Pane.break_pane() now returns the destination window when it moves a window's only pane, and show_hook() reads the hooks tmux 3.8 added.

Highlights

  • Breaking: Python 3.11+ is required. libtmux 0.62.0 was the last release supporting Python 3.10, which reached end of life in October 2026. On Python 3.10, pip keeps installing 0.62.0.
  • Fix: break_pane() returns the destination window (#879). Breaking out a window's only pane returns the destination Window, even if another client moved the pane first. On tmux 3.2a through 3.5 this could raise IndexError after the move had succeeded.
  • Fix: tmux 3.8 hooks and popups (#775). show_hook() reads the hooks tmux 3.8 added, such as pane-created and window-zoomed, with their sparse indices intact. display_popup() needs a terminal client to run its command on tmux 3.8.
  • Docs: task directories on the core classes. The Server, Session, Window and Pane class pages group their methods by job (finding one thing, listing everything, sending input) and say what each call returns and raises.
  • Docs: every field described (#721). Option classes, the hook table and the format object carry the tmux manual's description for each field.

See the changelog for the full list.

What's Changed

  • from_env(docs): Hide doctest setup with # doctest: +HIDE by @tony in #719
  • Document dataclass fields that ship as bare autodoc stubs by @tony in #721
  • Require ruff>=0.16.0 and adopt its default rule set by @tony in #722
  • docs: Standardize via CONTRIBUTING.md + WRITING.md by @tony in #747
  • Link libtmux.org and the package registry from the READMEs by @tony in #794
  • ci(fix): Rebuild incompatible tmux caches by @tony in #835
  • docs(feat[header]): Add the libtmux.org bars by @tony in #846
  • fix(tests): fix flaky test_capture_pane_flags[join_wrapped_numbers] by @tony in #655
  • tmux(fix[3.8]): Support hooks and terminal fixtures by @tony in #825
  • py(chore[floor]): Require Python 3.11 by @tony in #849
  • docs(feat[header]): Link the port picker to home pages and add six ports by @tony in #852
  • Server,Session,Window,Pane(docs): Add task directories by @tony in #857
  • Pane(fix): Return the relinked sole-pane window by @tony in #879

Full Changelog: v0.62.0...v0.63.0