# libtmux.pytest_plugin.session

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

```
libtmux.pytest_plugin.session(
    request: pytest.FixtureRequest,
    session_params: dict[str, t.Any],
    server: Server,
) -> Session
```

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

```python
>>> from libtmux.session import Session
```

```python
>>> def test_example(session: "Session") -> None:
...     assert isinstance(session.name, str)
...     assert session.name.startswith('libtmux_')
...     window = session.new_window(window_name='new one')
...     assert window.name == 'new one'
```

.. :

```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`)
- `session_params` (`dict[str, t.Any]`)
- `server` (`Server`)