tests(pytest_plugin): Add session doctest example

Author: tony

src/libtmux/pytest_plugin.py

@@ -122,7 +122,24 @@ def fin() -> None:
 
 @pytest.fixture(scope="function")
 def session(request: pytest.FixtureRequest, server: Server) -> "Session":
-    """Returns a new, temporary :class:`libtmux.Session`"""
+    """Returns a new, temporary :class:`libtmux.Session`
+
+    >>> from libtmux import Session
+
+    >>> def test_example(session: "Session"):
+    ...     assert isinstance(session.name, str)
+    ...     assert session.name.startswith('libtmux_')
+    ...     window = session.new_window(window_name='new one')
+    ...     assert window.name == 'new one'
+
+    >>> import inspect
+
+    >>> test_mod = pytester.makepyfile(whatever=inspect.getsource(test_example))
+    >>> result = pytester.inline_run(str(test_mod), '--disable-warnings')
+    ===...
+
+    >>> result.assertoutcome(passed=1)
+    """
     session_name = "tmuxp"
 
     if not server.has_session(session_name):