Core LibrarystableAPI Reference

Choose documentation 3

stable

Current version

stable
English

Prerelease This site documents an alpha of libtmux. Its structure, URLs and APIs are subject to change.

function libtmux stable

_reap_test_server

Kill the tmux daemon on socket_name and unlink the socket file.

Source and package
Qualified name
libtmux.pytest_plugin._reap_test_server
Module
libtmux.pytest_plugin
Package
libtmux
Source
src/libtmux/pytest_plugin.py
_reap_test_server (socket_name: str | None) → None

Description#

Invoked from the server and TestServer fixture finalizers to guarantee teardown even when the daemon has already exited (kill is a no-op then) and the socket file was left on disk. tmux does not reliably unlink(2) its socket on non-graceful exit, so /tmp/tmux-<uid>/ otherwise accumulates stale entries across test runs.

Conservative: suppresses LibTmuxException / OSError on both the kill and the unlink. A finalizer that raises replaces the real test failure with a cleanup error, and cleanup failures are not actionable (socket already gone, permissions changed, race with a concurrent pytest-xdist worker).

Parameters
Esc

Type to search.

Reference preview Open reference