.env.template

# Local development environment for the DataLab-Web Python test suite.
#
# Copy this file to ``.env`` and adjust ``PYTHONPATH`` to point at your
# local sibling checkouts of Sigima and guidata (or remove those entries
# entirely if you used ``scripts/sigima_dependency.py install`` and want to
# exercise the manifest-selected packages instead). Sibling paths always take
# priority over packages installed in the virtual environment.
#
# The Python interpreter itself is the project-local virtualenv created
# with::
#
#     py -3.11 -m venv .venv
#     .\.venv\Scripts\python scripts\sigima_dependency.py install
#
# ``scripts/run_with_env.py`` automatically picks up ``.venv\Scripts\python``
# when no ``PYTHON`` override is set. Set ``PYTHON=...`` here only if you
# want to bypass the project venv.
#
# Python 3.11+ is required: ``src/runtime/processor.py`` relies on
# ``isinstance(list[T], type)`` returning ``False``, which is broken under
# CPython 3.9 and 3.10 (both report ``True``) and was fixed in 3.11.

PYTHONPATH=.;..\Sigima;..\guidata;..\DataLab-Capsule\src

# Pyodide cannot import sibling source trees through PYTHONPATH. During rapid
# local iteration, build the sibling checkout under ../Sigima/dist and point
# Vite at it with an absolute /@fs/ URL (use forward slashes). This local value
# overrides both fields in sigima-dependency.json for browser runtimes only:
# VITE_SIGIMA_INSTALL_SPEC=/@fs/C:/path/to/Sigima/dist/sigima-X.Y.Z-py3-none-any.whl
# The same override exists for guidata (guidata-dependency.json):
# VITE_GUIDATA_INSTALL_SPEC=/@fs/C:/path/to/guidata/dist/guidata-X.Y.Z-py3-none-any.whl
#
# DataLab-Capsule (provenance) is optional in the browser: without this value
# the runtime keeps processing and reports provenance as unavailable.
# VITE_DATALAB_CAPSULE_INSTALL_SPEC=/@fs/C:/path/to/DataLab-Capsule/dist/datalab_capsule-X.Y.Z-py3-none-any.whl