!squash more server

Author: tony

src/libtmux/server.py

@@ -10,8 +10,6 @@
 
 Examples
 --------
->>> from libtmux import Server
->>> server = Server()  # Create a new server instance
 >>> server.is_alive()  # Check if tmux server is running
 True
 >>> # Clean up any existing test session first
@@ -23,7 +21,7 @@
 >>> server.has_session("test_session")
 True
 >>> server.kill_session("test_session")  # Clean up
-Server(socket_path=/tmp/tmux-.../default)
+Server(socket_name=libtmux_test...)
 """
 
 from __future__ import annotations
@@ -337,7 +335,6 @@ def has_session(self, target_session: str, exact: bool = True) -> bool:
 
         Examples
         --------
-        >>> server = Server()
         >>> # Clean up any existing test session
         >>> if server.has_session("test_session"):
         ...     server.kill_session("test_session")
@@ -349,10 +346,11 @@ def has_session(self, target_session: str, exact: bool = True) -> bool:
         False
         >>> server.has_session("test_session", exact=True)  # Exact match
         True
-        >>> server.has_session("test*", exact=False)  # Pattern match
+        >>> # Pattern matching (using tmux's pattern matching)
+        >>> server.has_session("test_sess*", exact=False)  # Pattern match
         True
         >>> server.kill_session("test_session")  # Clean up
-        Server(socket_path=/tmp/tmux-.../default)
+        Server(socket_name=libtmux_test...)
         """
         session_check_name(target_session)
 
@@ -369,16 +367,14 @@ def kill(self) -> None:
 
         Examples
         --------
-        >>> svr = Server(socket_name="testing")
-        >>> svr.new_session()
+        >>> # Create a new server for testing kill()
+        >>> test_server = Server(socket_name="testing")
+        >>> test_server.new_session()
         Session(...)
-
-        >>> svr.is_alive()
+        >>> test_server.is_alive()
         True
-
-        >>> svr.kill()
-
-        >>> svr.is_alive()
+        >>> test_server.kill()
+        >>> test_server.is_alive()
         False
         """
         self.cmd("kill-server")
@@ -393,15 +389,14 @@ def kill_session(self, target_session: str | int) -> Server:
 
         Examples
         --------
-        >>> server = Server()
         >>> # Clean up any existing session first
         >>> if server.has_session("temp"):
         ...     server.kill_session("temp")
         >>> session = server.new_session(session_name="temp")
         >>> server.has_session("temp")
         True
         >>> server.kill_session("temp")
-        Server(socket_path=/tmp/tmux-.../default)
+        Server(socket_name=libtmux_test...)
         >>> server.has_session("temp")
         False
         """
@@ -418,6 +413,22 @@ def switch_client(self, target_session: str) -> None:
         target_session
             The name or pattern of the target session.
 
+        Examples
+        --------
+        >>> # Create two test sessions
+        >>> for name in ["session1", "session2"]:
+        ...     if server.has_session(name):
+        ...         server.kill_session(name)
+        >>> session1 = server.new_session(session_name="session1")
+        >>> session2 = server.new_session(session_name="session2")
+        >>> # Note: switch_client() requires an interactive terminal
+        >>> # so we can't demonstrate it in doctests
+        >>> # Clean up
+        >>> server.kill_session("session1")
+        Server(socket_name=libtmux_test...)
+        >>> server.kill_session("session2")
+        Server(socket_name=libtmux_test...)
+
         Raises
         ------
         exc.BadSessionName
@@ -439,6 +450,18 @@ def attach_session(self, target_session: str | None = None) -> None:
             The name or pattern of the target session. If None, attaches to
             the most recently used session.
 
+        Examples
+        --------
+        >>> # Create a test session
+        >>> if server.has_session("test_attach"):
+        ...     server.kill_session("test_attach")
+        >>> session = server.new_session(session_name="test_attach")
+        >>> # Note: attach_session() requires an interactive terminal
+        >>> # so we can't demonstrate it in doctests
+        >>> # Clean up
+        >>> server.kill_session("test_attach")
+        Server(socket_name=libtmux_test...)
+
         Raises
         ------
         exc.BadSessionName
@@ -490,7 +513,6 @@ def new_session(
 
         Examples
         --------
-        >>> server = Server()
         >>> # Clean up any existing sessions first
         >>> for name in ["basic", "custom", "env_test"]:
         ...     if server.has_session(name):
@@ -519,9 +541,9 @@ def new_session(
         >>> # Clean up
         >>> for name in ["basic", "custom", "env_test"]:
         ...     server.kill_session(name)
-        Server(socket_path=/tmp/tmux-.../default)
-        Server(socket_path=/tmp/tmux-.../default)
-        Server(socket_path=/tmp/tmux-.../default)
+        Server(socket_name=libtmux_test...)
+        Server(socket_name=libtmux_test...)
+        Server(socket_name=libtmux_test...)
         """
         if session_name is not None:
             session_check_name(session_name)
@@ -585,7 +607,6 @@ def sessions(self) -> QueryList[Session]:
 
         Examples
         --------
-        >>> server = Server()
         >>> # Clean up any existing test sessions first
         >>> for name in ["test1", "test2"]:
         ...     if server.has_session(name):
@@ -599,9 +620,9 @@ def sessions(self) -> QueryList[Session]:
         ['test1', 'test2']
         >>> # Clean up
         >>> server.kill_session("test1")
-        Server(socket_path=/tmp/tmux-.../default)
+        Server(socket_name=libtmux_test...)
         >>> server.kill_session("test2")
-        Server(socket_path=/tmp/tmux-.../default)
+        Server(socket_name=libtmux_test...)
         """
         sessions: list[Session] = []
         with contextlib.suppress(Exception):
@@ -620,6 +641,36 @@ def windows(self) -> QueryList[Window]:
 
         This includes windows in all sessions.
 
+        Examples
+        --------
+        >>> # Clean up any existing test sessions
+        >>> for name in ["test_windows1", "test_windows2"]:
+        ...     if server.has_session(name):
+        ...         server.kill_session(name)
+        >>> # Create sessions with windows
+        >>> session1 = server.new_session(session_name="test_windows1")
+        >>> session2 = server.new_session(session_name="test_windows2")
+        >>> # Create additional windows
+        >>> _ = session1.new_window(window_name="win1")  # Create window
+        >>> _ = session2.new_window(window_name="win2")  # Create window
+        >>> # Each session should have 2 windows (default + new)
+        >>> len([w for w in server.windows if w.session.name == "test_windows1"])
+        2
+        >>> len([w for w in server.windows if w.session.name == "test_windows2"])
+        2
+        >>> # Verify window names
+        >>> wins1 = [w for w in server.windows if w.session.name == "test_windows1"]
+        >>> wins2 = [w for w in server.windows if w.session.name == "test_windows2"]
+        >>> sorted(w.name for w in wins1)
+        ['win1', ...]
+        >>> sorted(w.name for w in wins2)
+        ['win2', ...]
+        >>> # Clean up
+        >>> server.kill_session("test_windows1")
+        Server(socket_name=libtmux_test...)
+        >>> server.kill_session("test_windows2")
+        Server(socket_name=libtmux_test...)
+
         Access advanced filtering and retrieval with:
         :meth:`.windows.get() <libtmux._internal.query_list.QueryList.get()>` and
         :meth:`.windows.filter() <libtmux._internal.query_list.QueryList.filter()>`
@@ -640,6 +691,24 @@ def panes(self) -> QueryList[Pane]:
 
         This includes panes from all windows in all sessions.
 
+        Examples
+        --------
+        >>> # Clean up any existing test session
+        >>> if server.has_session("test_panes"):
+        ...     server.kill_session("test_panes")
+        >>> # Create a session and split some panes
+        >>> session = server.new_session(session_name="test_panes")
+        >>> window = session.attached_window
+        >>> # Split into two panes
+        >>> window.split_window()
+        Pane(%... Window(@... 1:..., Session($... test_panes)))
+        >>> # Each window starts with 1 pane, split creates another
+        >>> len([p for p in server.panes if p.window.session.name == "test_panes"])
+        2
+        >>> # Clean up
+        >>> server.kill_session("test_panes")
+        Server(socket_name=libtmux_test...)
+
         Access advanced filtering and retrieval with:
         :meth:`.panes.get() <libtmux._internal.query_list.QueryList.get()>` and
         :meth:`.panes.filter() <libtmux._internal.query_list.QueryList.filter()>`