ZoneFlow

Testing and the sandbox

You can try ZoneFlow, or check a change to it, without opening a real valve. The project ships three tools for that, from the most thorough to the most hands-on.

The test suite

The tests/ folder holds a pytest suite. Install its requirements with pip install -r requirements-test.txt, then run pytest tests/ -q.

The tests start a real Home Assistant core inside the test process and move the clock forward, so they can exercise every gate and watchdog, interrupted cycles, sensors dropping out, several zones handing a pump to each other, and whole-season scenarios.

The season simulator

scripts/simulate_season.py is a quick pure-Python simulator. Choose a scenario with --scenario dry, monsoon or mixed to see how ZoneFlow behaves over weeks or months without waiting for them.

The Docker sandbox

The sandbox/ folder is a Docker Compose setup with its own isolated Home Assistant. Its valves, pumps, rain, temperature and soil probes are simulated and you move them with sliders. It is the way to learn the real interface before connecting hardware.

If you just want to look around, the live demo runs in your browser with nothing to install.