feat: configure the app timeout for pytest-ipywidgets using solara-server

Can be configured using PYTEST_IPYWIDGETS_SOLARA_APP_WAIT_TIMEOUT

Author: maartenbreddels

solara/test/pytest_plugin.py

@@ -37,6 +37,7 @@
 TEST_PORT_START = int(os.environ.get("PORT", "18765")) + 100  # do not interfere with the solara integration tests
 TEST_HOST = solara.server.settings.main.host
 TIMEOUT = float(os.environ.get("SOLARA_PW_TIMEOUT", "18"))
+PYTEST_IPYWIDGETS_SOLARA_APP_WAIT_TIMEOUT = int(os.environ.get("PYTEST_IPYWIDGETS_SOLARA_APP_WAIT_TIMEOUT", "10"))
 
 
 @pytest.fixture(scope="session")
@@ -192,7 +193,7 @@ def _solara_test(solara_server, solara_app, page_session: "playwright.sync_api.P
         run_events[id] = run_event = threading.Event()
         page_session.goto(solara_server.base_url + f"?id={id}")
         try:
-            assert run_event.wait(10)
+            assert run_event.wait(PYTEST_IPYWIDGETS_SOLARA_APP_WAIT_TIMEOUT)
             context = used_contexts[id]
             with context:
                 test_output_warmup = widgets.Output()

solara/website/pages/documentation/advanced/content/10-howto/30-testing.md

@@ -411,3 +411,7 @@ To configure the ports the socket is bound to when starting the test servers, us
 #### Vuetify warmup
 
 By default, we insert an ipyvuetify widget with an icon into the frontend to force loading all the vuetify assets, such as CSS and fonts. However, if you are using the solara test plugin to test pure ipywidgets or a 3rd ipywidget based party library you might not need this. Disable this vuetify warmup phase by passing the `--no-solara-vuetify-warmup` argument to pytest, or setting the environment variable `SOLARA_TEST_VUETIFY_WARMUP` to a falsey value (e.g. `SOLARA_TEST_VUETIFY_WARMUP=0`).
+
+#### Changing the application wait timeout
+
+By default, we wait for 10 seconds for the browser to connect to the server when the solara server is used for testing. On slower systems, this may be too short. To change this timeout, set the `PYTEST_IPYWIDGETS_SOLARA_APP_WAIT_TIMEOUT` environment variable to the desired value in seconds (e.g. `PYTEST_IPYWIDGETS_SOLARA_APP_WAIT_TIMEOUT=20`).