# libtmux.pytest_plugin.server

- **Module:** libtmux.pytest_plugin
- **Package:** libtmux
- **Language:** Python
- **Kind:** function
- **Source:** https://github.com/tmux-python/libtmux/blob/38e368c11117fb4aeb2f082d552cd4f210eae06a/src/libtmux/pytest_plugin.py#L145
- **Page:** https://libtmux.org/en/py/stable/reference/libtmux-pytest_plugin-server/

```
libtmux.pytest_plugin.server(
    request: pytest.FixtureRequest,
    monkeypatch: pytest.MonkeyPatch,
    config_file: pathlib.Path,
) -> Server
```

Return new, temporary :class:`libtmux.Server`.

```python
>>> from libtmux.server import Server
```

```python
>>> def test_example(server: Server) -> None:
...     assert isinstance(server, Server)
...     session = server.new_session('my session')
...     assert len(server.sessions) == 1
...     assert [session.name.startswith('my') for session in server.sessions]
```

.. :

```text
>>> locals().keys()
dict_keys(...)

>>> source = ''.join([e.source for e in request._pyfuncitem.dtest.examples][:3])
>>> pytester = request.getfixturevalue('pytester')

>>> pytester.makepyfile(**{'whatever.py': source})
PosixPath(...)

>>> result = pytester.runpytest('whatever.py', '--disable-warnings')
===...

>>> result.assert_outcomes(passed=1)
```

## Parameters

- `request` (`pytest.FixtureRequest`)
- `monkeypatch` (`pytest.MonkeyPatch`)
- `config_file` (`pathlib.Path`)