Libtmux

Packaging

- pyproject.toml: Drop old issues package, remove anther package from grouping

Documentation

- Cleanup quickstart page

New features

- Added a [pytest plugin](https://libtmux.git-pull.com/pytest-plugin.html), #411.

Breaking changes

- Remove `common.which()` in favor of {func}`shutil.which`, Credit:
rocksandska, via 407
- Fixes 402: {func}`common.tmux_cmd` will only strip _trailing_ empty lines. Before this change,
all empty lines were filtered out. This will lead to a more accurate behavior when using
{meth}`Pane.capture_pane`. Credit: rockandska, via 405.
- Source files for `libtmux` modules moved to `src/`, via 414.

Development

- Add [flake8-bugbear](https://github.com/PyCQA/flake8-bugbear) (#408)
- Add [flake8-comprehensions](https://github.com/adamchainz/flake8-comprehensions) (#409)

Tests

- Test doctests in documentation via
[pytest-doctest-docutils](https://gp-libs.git-pull.com/doctest/pytest.html) (#410)

Documentation

- Examples updated for correctness, 412 (cherry-picked from 410)
- Render changelog in [linkify_issues](https://gp-libs.git-pull.com/linkify_issues/) (#410)
- Fix Table of contents rendering with sphinx autodoc with
[sphinx_toctree_autodoc_fix](https://gp-libs.git-pull.com/sphinx_toctree_autodoc_fix/) (#410)

Fixes

- {meth}`Server.new_session` _really_ works without `session_name`, 401 fixes
399. Improved tests and doctests added.

Fixes

- {meth}`Server.new_session` works without `session_name`, 400 fixes
399

_This still passed `None` to the session name, this was fixed in v0.14.2._

Breaking changes

- {meth}`Pane.send_keys`: `suppress_history` default value changed from `True` to
`False`, 395

Tests and docs

- Initial [doctests] examples stubbed out 394

[doctests]: https://docs.python.org/3/library/doctest.html

- Fix bug in `temp_window()` context manager, 394
- Pytest configuration `conftest.py` moved to `libtmux/conftest.py`, so doctest can
detect the fixtures 394

What's new

- **Improved typings**

Now [`mypy --strict`] compliant (383)

Smaller touchups from 392

[`mypy --strict`]: https://mypy.readthedocs.io/en/stable/command_line.html#cmdoption-mypy-strict

Breaking changes

- Deprecated individual item lookups (390)

- Removed key lookups from {meth}`libtmux.common.EnvironmentMixin.show_environment`

Only `EnvironmentMixin.show_environment()` (without an argument) exists, and
it still returns a `dict`.

- Add key lookups via {meth}`libtmux.common.EnvironmentMixin.getenv`

python
Before
server.show_environment('DISPLAY')

After
server.getenv('DISPLAY')

Before
session.show_environment('DISPLAY')

After
session.getenv('DISPLAY')


- Removed key lookups from {meth}`Session.show_options`

python
session.show_options() still returns dict, without an argument

Old
session.show_options('DISPLAY')

Now
session.show_option('DISPLAY')


- Removed key lookups from {meth}`Window.show_window_options`

python
window.show_window_options() still returns dict, without an argument

Old
window.show_window_options('DISPLAY')

Now
window.show_window_option('DISPLAY')


- Remove `libtmux.test.retry()`, deprecated since 0.12.x (393)

Development

- Fix incorrect function name `findWhere()` (391)