docs: update pytest-plugin docs to include new examples

Author: tony

docs/pytest-plugin/advanced-techniques.md

@@ -59,83 +59,29 @@ This page covers advanced testing techniques using the libtmux pytest plugin for
 :pyobject: set_home
 ```
 
-## Testing Across tmux Server Restarts
-
-For testing functionality that needs to persist across server restarts:
-
-```python
-def test_persist_across_restart(session):
-    """Test functionality across server restarts."""
-    # Set up initial state
-    window = session.new_window(window_name="persist-test")
-    pane = window.active_pane
-    pane.send_keys("echo 'Data to persist' > /tmp/test-data.txt", enter=True)
-    time.sleep(0.5)
-    
-    # Get server info for reconnecting
-    socket_path = session.server.socket_path
-    session_id = session.id
-    
-    # Kill the server
-    session.server.kill_server()
-    
-    # Create a new server with the same socket
-    new_server = libtmux.Server(socket_path=socket_path)
-    new_server.new_session(session_name="restart-test")
-    
-    # Verify data persisted
-    new_session = new_server.get_by_id(session_id)
-    assert new_session is None  # Old session should not exist
-    
-    # But our file should still exist
-    new_pane = new_server.sessions[0].attached_window.active_pane
-    new_pane.send_keys("cat /tmp/test-data.txt", enter=True)
-    time.sleep(0.5)
-    
-    output = new_pane.capture_pane()
-    assert any("Data to persist" in line for line in output)
-    
-    # Clean up
-    new_pane.send_keys("rm /tmp/test-data.txt", enter=True)
-```
-
 ## Testing with Complex Layouts
 
 Creating and testing more complex window layouts:
 
-```python
-def test_complex_layouts(session):
-    """Test creating and interacting with complex window layouts."""
-    # Create a window with multiple panes in a specific layout
-    window = session.new_window(window_name="complex-layout")
-    
-    # Start with a simple pane
-    main_pane = window.active_pane
-    
-    # Split into a left pane and right column
-    left_pane = main_pane
-    right_top = window.split(direction="right", percent=50)
-    
-    # Split the right column into top and bottom
-    right_bottom = right_top.split(direction="below", percent=50)
-    
-    # Apply a layout
-    window.select_layout("main-vertical")
-    
-    # Verify the layout was applied
-    assert window.get("window_layout") != None
-    
-    # Send unique commands to each pane for identification
-    left_pane.send_keys("echo 'Left Pane'", enter=True)
-    right_top.send_keys("echo 'Right Top'", enter=True)
-    right_bottom.send_keys("echo 'Right Bottom'", enter=True)
-    
-    time.sleep(0.5)
-    
-    # Verify each pane has the correct content
-    assert any("Left Pane" in line for line in left_pane.capture_pane())
-    assert any("Right Top" in line for line in right_top.capture_pane())
-    assert any("Right Bottom" in line for line in right_bottom.capture_pane())
+```{literalinclude} ../../tests/pytest_examples/test_complex_layouts.py
+:language: python
+:pyobject: test_complex_layouts
+```
+
+For an even more advanced layout, you can create a tiled configuration:
+
+```{literalinclude} ../../tests/pytest_examples/test_complex_layouts.py
+:language: python
+:pyobject: test_tiled_layout
+```
+
+## Testing Across Server Restarts
+
+When you need to test functionality that persists across server restarts:
+
+```{literalinclude} ../../tests/pytest_examples/test_server_restart.py
+:language: python
+:pyobject: test_persist_across_restart
 ```
 
 ## Best Practices

docs/pytest-plugin/fixtures.md

@@ -122,6 +122,20 @@ def test_multiple_servers(TestServer):
     assert session2.server is server2
 ```
 
+For more advanced usage with custom configuration:
+
+```{literalinclude} ../../tests/pytest_examples/test_direct_testserver.py
+:language: python
+:pyobject: test_custom_server_config
+```
+
+You can also use TestServer directly as a context manager:
+
+```{literalinclude} ../../tests/pytest_examples/test_direct_testserver.py
+:language: python
+:pyobject: test_testserver_direct_usage
+```
+
 ### Environment fixtures
 
 These fixtures help manage the testing environment:

docs/pytest-plugin/usage-examples.md

@@ -108,6 +108,88 @@ This page provides practical code examples for testing with the libtmux pytest p
 :pyobject: test_pane_layout
 ```
 
+## Window Management
+
+Window management is a common task when working with tmux. Here are some examples:
+
+### Window Renaming
+
+```{literalinclude} ../../tests/pytest_examples/test_window_management.py
+:language: python
+:pyobject: test_window_renaming
+```
+
+### Moving Windows
+
+```{literalinclude} ../../tests/pytest_examples/test_window_management.py
+:language: python
+:pyobject: test_window_moving
+```
+
+### Switching Between Windows
+
+```{literalinclude} ../../tests/pytest_examples/test_window_management.py
+:language: python
+:pyobject: test_window_switching
+```
+
+### Killing Windows
+
+```{literalinclude} ../../tests/pytest_examples/test_window_management.py
+:language: python
+:pyobject: test_window_killing
+```
+
+## Pane Operations
+
+Panes are the subdivisions within windows where commands are executed:
+
+### Advanced Pane Functions
+
+```{literalinclude} ../../tests/pytest_examples/test_pane_operations.py
+:language: python
+:pyobject: test_pane_functions
+```
+
+### Resizing Panes
+
+```{literalinclude} ../../tests/pytest_examples/test_pane_operations.py
+:language: python
+:pyobject: test_pane_resizing
+```
+
+### Capturing Pane Content
+
+```{literalinclude} ../../tests/pytest_examples/test_pane_operations.py
+:language: python
+:pyobject: test_pane_capturing
+```
+
+## Process Control
+
+Working with processes in tmux panes:
+
+### Process Detection
+
+```{literalinclude} ../../tests/pytest_examples/test_process_control.py
+:language: python
+:pyobject: test_process_detection
+```
+
+### Handling Command Output
+
+```{literalinclude} ../../tests/pytest_examples/test_process_control.py
+:language: python
+:pyobject: test_command_output_scrollback
+```
+
+### Background Processes
+
+```{literalinclude} ../../tests/pytest_examples/test_process_control.py
+:language: python
+:pyobject: test_running_background_process
+```
+
 ## Custom Configuration Testing
 
 ### Creating a Custom Configuration