67 lines
2.4 KiB
Markdown
67 lines
2.4 KiB
Markdown
# Test environment
|
|
|
|
## Setup
|
|
|
|
Create a venv at the repo root and install the root dev extras plus the
|
|
packages exercised by the tests you're running:
|
|
|
|
```bash
|
|
# Linux/macOS
|
|
python3 -m venv .venv
|
|
.venv/bin/pip install -e ".[dev]"
|
|
.venv/bin/pip install -e packages/node -e packages/tracker -e packages/gateway
|
|
```
|
|
|
|
```powershell
|
|
# Windows (native, no WSL)
|
|
python -m venv .venv
|
|
.venv\Scripts\python.exe -m pip install -e ".[dev]"
|
|
.venv\Scripts\python.exe -m pip install -e packages\node -e packages\tracker -e packages\gateway
|
|
```
|
|
|
|
`conftest.py` at the repo root adds every `packages/*` source directory to
|
|
`sys.path`, so tests can `import meshnet_node`, `import meshnet_tracker`, etc.
|
|
without an editable install. That only resolves first-party modules, though —
|
|
each package's own third-party dependencies (e.g. `cryptography` for
|
|
`meshnet_node.wallet` and `meshnet_tracker.wallet_proof`) still need to be
|
|
installed in the venv, either via `pip install -e packages/<pkg>` or by
|
|
depending on the root `dev` extra covering them.
|
|
|
|
`cryptography>=41` is declared in `packages/node/pyproject.toml` (and
|
|
`packages/p2p/pyproject.toml`) and is also pulled in by the root `dev` extra,
|
|
so `pip install -e ".[dev]"` alone is enough to run the wallet-related tests
|
|
even without installing `packages/node`.
|
|
|
|
## Running tests
|
|
|
|
```bash
|
|
.venv/bin/python -m pytest
|
|
```
|
|
|
|
## Dashboard test runner
|
|
|
|
For the opt-in tracker dashboard **Testing** tab (suites, env gates, VS Code
|
|
launch config, and real-inference safeguards), see
|
|
[dashboard-test-runner.md](dashboard-test-runner.md).
|
|
|
|
## Optional-dependency tests
|
|
|
|
Some tests import heavyweight or optional third-party packages and guard
|
|
themselves with `pytest.importorskip(...)` — they skip cleanly if the
|
|
dependency isn't installed:
|
|
|
|
- `tests/test_real_model_backend.py` — `torch`, `transformers`, `safetensors`,
|
|
`accelerate`, `bitsandbytes`
|
|
- `tests/test_devnet_treasury.py` — `solders`, `spl.token.instructions`
|
|
|
|
`tests/test_openai_gateway.py` is the exception: it imports `openai` and
|
|
`langchain_openai` directly inside test functions with no `importorskip`
|
|
guard, so it hard-fails if those aren't installed. They're included in the
|
|
root `dev` extra, so a normal `pip install -e ".[dev]"` covers it. If you
|
|
deliberately install a minimal environment without the `dev` extra, skip it
|
|
explicitly:
|
|
|
|
```bash
|
|
.venv/bin/python -m pytest --ignore=tests/test_openai_gateway.py
|
|
```
|