Add test name to window caption when running tests (#2386)

* Add make_window_caption helper in conftest.py

* Add test_name fixture for use in function-scoped fixtures

* Add caption argument to prepare_window in conftest.py

* Use test_name fixture in function-scoped fixtures

* Inline the test name fetching for static context (session-scoped) fixtures

tests/conftest.py

@@ -26,6 +26,21 @@
 OFFSCREEN = None
 
 
+def make_window_caption(request=None, prefix='Testing', sep=' - ') -> str:
+    """Centralizes test name customization.
+
+    It helps with:
+
+    1. Tests scoped as something other than function (can't use test_name fixture)
+    2. Local (non-CI) temp modifications of inter-test behavior
+    """
+    parts = [prefix]
+    if request is not None:
+        parts.append(request.node.name)
+
+    return sep.join(parts)
+
+
 def create_window(width=1280, height=720, caption="Testing", **kwargs):
     global WINDOW
     if not WINDOW:
@@ -39,14 +54,16 @@ def create_window(width=1280, height=720, caption="Testing", **kwargs):
     return WINDOW
 
 
-def prepare_window(window: arcade.Window):
+def prepare_window(window: arcade.Window, caption: str | None = None):
     # Check if someone has been naughty
     if window.has_exit:
         raise RuntimeError("Please do not close the global test window :D")
 
     window.switch_to()
     if window.get_size() < (800, 600):
         window.set_size(800, 600)
+    if caption:
+        window.set_caption(caption)
 
     ctx = window.ctx
     # ctx._atlas = None  # Clear the global atlas
@@ -75,8 +92,13 @@ def prepare_window(window: arcade.Window):
     window.on_update = lambda dt: None
 
 
+@pytest.fixture
+def test_name(request):
+    return make_window_caption(request)
+
+
 @pytest.fixture(scope="function")
-def ctx():
+def ctx(test_name):
     """
     Per function context.
 
@@ -85,25 +107,28 @@ def ctx():
     """
     window = create_window()
     arcade.set_window(window)
-    prepare_window(window)
+    prepare_window(window, caption=test_name)
     return window.ctx
 
 
 @pytest.fixture(scope="session")
-def ctx_static():
+def ctx_static(request):
     """
     Context that is shared between tests
     This is the same global context.
     Module scoped fixtures can inject this context.
     """
     window = create_window()
     arcade.set_window(window)
-    prepare_window(window)
+    # Can't use the test_name fixture here:
+    # 1. This fixture is session scoped
+    # 2. test_name is function scoped
+    prepare_window(window, caption=make_window_caption(request))
     return window.ctx
 
 
 @pytest.fixture(scope="function")
-def window():
+def window(test_name):
     """
     Global window that is shared between tests.
 
@@ -113,7 +138,7 @@ def window():
     """
     window = create_window()
     arcade.set_window(window)
-    prepare_window(window)
+    prepare_window(window, caption=test_name)
     return window
 
 
@@ -401,7 +426,7 @@ def assert_images_almost_equal(self, image1: PIL.Image.Image, image2: PIL.Image.
 
 
 @pytest.fixture(scope="function")
-def offscreen():
+def offscreen(test_name):
     """
     Offscreen rendering tools.
 
@@ -411,7 +436,7 @@ def offscreen():
 
     window = create_window()
     arcade.set_window(window)
-    prepare_window(window)
+    prepare_window(window, caption=test_name)
 
     if OFFSCREEN is None:
         OFFSCREEN = Offscreen()