tests: Add doctests

Author: tony

src/libtmux/test.py

@@ -27,6 +27,16 @@ class RandomStrSequence:
     def __init__(
         self, characters: str = "abcdefghijklmnopqrstuvwxyz0123456789_"
     ) -> None:
+        """Create a random letter / number generator. 8 chars in length.
+
+        >>> rng = RandomStrSequence()
+        >>> next(rng)
+        '...'
+        >>> len(next(rng))
+        8
+        >>> type(next(rng))
+        <class 'str'>
+        """
         self.characters: str = characters
 
     def __iter__(self) -> "RandomStrSequence":
@@ -110,6 +120,15 @@ def get_test_session_name(server: "Server", prefix: str = TEST_SESSION_PREFIX) -
     -------
     str
         Random session name guaranteed to not collide with current ones.
+
+    Examples
+    --------
+    >>> get_test_session_name(server=server)
+    'libtmux_...'
+
+    Never the same twice:
+    >>> get_test_session_name(server=server) != get_test_session_name(server=server)
+    True
     """
     while True:
         session_name = prefix + next(namer)
@@ -138,6 +157,15 @@ def get_test_window_name(
     -------
     str
         Random window name guaranteed to not collide with current ones.
+
+    Examples
+    --------
+    >>> get_test_window_name(session=session)
+    'libtmux_...'
+
+    Never the same twice:
+    >>> get_test_window_name(session=session) != get_test_window_name(session=session)
+    True
     """
     assert prefix is not None
     while True:
@@ -181,7 +209,7 @@ def temp_session(
 
     >>> with temp_session(server) as session:
     ...     session.new_window(window_name='my window')
-    Window(@... ...:..., Session($... ...))
+    Window(@3 2:my window, Session($... ...))
     """
 
     if "session_name" in kwargs:
@@ -233,12 +261,12 @@ def temp_window(
 
     >>> with temp_window(session) as window:
     ...     window
-    Window(@... ...:..., Session($... ...))
+    Window(@2 2:... Session($1 libtmux_...))
 
 
     >>> with temp_window(session) as window:
     ...     window.split_window()
-    Pane(%... Window(@... ...:..., Session($... ...)))
+    Pane(%4 Window(@3 2:libtmux_..., Session($1 libtmux_...)))
     """
 
     if "window_name" not in kwargs:
@@ -270,7 +298,6 @@ class EnvironmentVarGuard:
 
     Notes
     -----
-
     Vendorized to fix issue with Anaconda Python 2 not including test module,
     see #121 [1]_