sda.dashboard.app#

SDA Dashboard – FastAPI application entry point.

Functions#

is_port_in_use(host, port)

Return True if port on host is already bound.

run_api_dashboard([test_name, debug, port, host, ...])

Start the SDA Dashboard (FastAPI + React).

run_dev_server([port, host, open_browser, vite_port])

Start SDA in developer mode: FastAPI hot-reload + Vite HMR, side by side.

Module Contents#

sda.dashboard.app.is_port_in_use(host, port)#

Return True if port on host is already bound.

sda.dashboard.app.run_api_dashboard(test_name=None, debug=False, port=8051, host='127.0.0.1', open_browser=True, verbose=False, auto_find_port=True, skip_invalid=False, source='local')#

Start the SDA Dashboard (FastAPI + React).

Parameters:

  • test_name – Test(s) to pre-load on startup.

  • debug – Enable verbose logging and FastAPI interactive docs at /api/docs.

  • port – Port to bind the server to.

  • host – Host address to bind the server to.

  • open_browser – Open the browser automatically once the server is ready.

  • verbose – Enable verbose pipeline logging.

  • auto_find_port – Try incrementing the port if the preferred one is in use.

  • skip_invalid – When True, tests that fail to load are skipped with a warning instead of aborting the whole multi-test load.

  • source – Data access mode: "local" (default), "default" (local + cloud fallback), or "cloud" (always from SharePoint).

sda.dashboard.app.run_dev_server(port=8051, host='127.0.0.1', open_browser=True, vite_port=5173)#

Start SDA in developer mode: FastAPI hot-reload + Vite HMR, side by side.

Both servers run in parallel subprocesses. Ctrl+C stops both cleanly. Open http://localhost:<vite_port> in your browser — Vite proxies every /api request to FastAPI on <port>.

Parameters:

  • port – Port for the FastAPI backend (default 8051).

  • host – Host address for the FastAPI backend.

  • open_browser – Automatically open the Vite dev URL in the browser after startup.

  • vite_port – Port for the Vite dev server (default 5173).