Libtmux

_Maintenance only, no bug fixes or new features_

Testing

- Add `pytest-xdist` ([PyPI](https://pypi.org/project/pytest-xdist/), [GitHub](https://github.com/pytest-dev/pytest-xdist)) for parallel testing (#522).

pytest:

console
py.test -n auto


pytest-watcher:

console
env PYTEST_ADDOPTS='-n auto' make start


entr(1):

console
make watch_test test="-n auto"


- Improve flakey tests:

- `retry_until()` tests: Relax clock in `assert` (522).
- `tests/test_pane.py::test_capture_pane_start`: Use `retry_until()` to poll,
improve correctness of test (522).

Documentation

- Automatically linkify links that were previously only text.

Development

- poetry: 1.8.1 -> 1.8.2

See also: https://github.com/python-poetry/poetry/blob/1.8.2/CHANGELOG.md

_Maintenance only, no bug fixes or new features_

Development

- Aggressive automated lint fixes via `ruff` (539)

via ruff v0.3.4, all automated lint fixes, including unsafe and previews were applied:

sh
ruff check --select ALL . --fix --unsafe-fixes --preview --show-fixes; ruff format .


Branches were treated with:

sh
git rebase \
--strategy-option=theirs \
--exec 'poetry run ruff check --select ALL . --fix --unsafe-fixes --preview --show-fixes; poetry run ruff format .; git add src tests; git commit --amend --no-edit' \
origin/master

Bug fix

- {attr}`Server.attached_sessions` fix for when multiple clients attached, thank you patrislav1 (537)

- 538 fix to `QueryList`.

Breaking changes

- Eliminate redundant targets / `window_index`'s across codebase (536).

Breaking changes

Command target change (535)

Commands: All `cmd()` methods using custom or overridden targets must use the keyword argument
`target`. This avoids entanglement with inner shell values that include `-t` for
other purposes. These methods include:

- {meth}`Server.cmd()`
- {meth}`Session.cmd()`
- {meth}`Window.cmd()`
- {meth}`Pane.cmd()`

Breaking changes

Improved new sessions (532)

- `Session.new_window()`:

- Learned `direction`, via {class}`~libtmux.constants.WindowDirection`).
- [PEP 3102] keyword-only arguments after window name (534).

- Added {meth}`Window.new_window()` shorthand to create window based on that
window's position.

[PEP 3102]: https://www.python.org/dev/peps/pep-3102/

Improved window splitting (532)

- `Window.split_window()` to {meth}`Window.split()`

- Deprecate `Window.split_window()`

- `Pane.split_window()` to {meth}`Pane.split()`

- Deprecate `Pane.split_window()`
- Learned `direction`, via {class}`~libtmux.constants.PaneDirection`).

- Deprecate `vertical` and `horizontal` in favor of `direction`.

- Learned `zoom`

Tweak: Pane position (532)

It's now possible to retrieve the position of a pane in a window via a
`bool` helper::

- {attr}`Pane.at_left`
- {attr}`Pane.at_right`
- {attr}`Pane.at_bottom`
- {attr}`Pane.at_right`

Development

- poetry: 1.7.1 -> 1.8.1

See also: https://github.com/python-poetry/poetry/blob/1.8.1/CHANGELOG.md