Libtmux

Compatibility

- Brought back python 3.7 and 3.8 support (375)
- Support for tmux 3.3a

- Add to CI
- Bump `TMUX_MAX_VERSION` from 2.4 -> 3.3

_2.4 to 3.3a already worked, this is just the constant
being updated._

Development

- Remove tox and tox-poetry-installer

This created issues with running poetry while inside the virtualenv.

- Typings: Core relations, e.g. `Pane.window`, `Pane.session`, `Pane.server`, `Window.server` 385

Documentation

- Renewed logo
- Try out sphinx-autoapi for its table of contents generation (367)
- Break up API documentations for utilities, exception, and test helpers and
remove duplicate docs from API page. Server, session, window, and pane docs
are in the Reference section now.

Testing

- `retry()`: Add deprecation warning. This will be removed in 0.13.x (368, 372)
- New function `retry_until()`: Polls a callback function for a set period of time until it returns `True` or times out. By default it will raise {exc}`libtmux.exc.WaitTimeout`, with `raises=False` it will return `False`. Thank you categulario! (368, 372)
- 384 Chore: Use absolute modules rather than root-level to avoid cyclic imports.

python
Bad / Old
from libtmux import Server

Good / New
from libtmux.server import Server


Internals

- 382 [mypy] support added:

- Basic mypy tests now pass

Compatibility

- Python 3.7 and 3.8 returns in 0.12.0

~~Final python 3.7 and 3.8 release~~

~~Fixes and security updates will go to
[`v0.11.x`](https://github.com/tmux-python/libtmux/tree/v0.11.x)~~

- Internal: Use new separator to split `tmux(1)` formatting information (289,
343)

The separator is configurable via `LIBTMUX_TMUX_FORMAT_SEPARATOR`. If you ever
have compatibility issues in the future let us know which default works best
across versions.

Credit: JonathanRaiman and jagguli

- Basic type annotations (359, 361) via otherJL0

Development

- Code cleanup (362) from otherJL0
- Format with black w/ string normalization. This is a one-time diff (354)

Documentation

- Sidebar reorganized into sections
- Added documentation on fetching developmental releases of libtmux

Packaging

First experimental release using `poetry build` (347). If you are packaging and run
across any difficulty please see 346.

Compatibility

- Drop python 3.6 (344)
- Add python 3.10, though still `packaging.version` issues remain (344)

A compat module and version constraints will need to be added for this

Development

- poetry: 1.1.7 -> 1.1.12 (344)
- Add `.pre-commit-config.yaml` (344)

- 324: Update poetry to 1.1
- CI: Use poetry 1.1.7 and `install-poetry.py` installer
- Relock poetry.lock at 1.1 (w/ 1.1.7's fix)
- 339 (CI): Lock python at 3.9 to avoid poetry issue with `dataclasses`
- ci: Fix publishing docs (similar to 339)
- 341 342: `Server.attached_sessions()` now supports multiple attached sessions.

Remove attached sessions limitation to not detect multiple attached clients,
thank you timoses

- Update `Window.select_window()` for 271

- 321: Convert to markdown
- 271: Fix `select_window()` by providing the session ID as
argument to `-t`. Thanks Flowdalic
- Drop python 3.5 support