Installation¶

Requirements¶

Python 3.10, 3.11, or 3.12
A SQLAlchemy-supported database to target. SQLite needs nothing extra; PostgreSQL support is an optional install.

The recommended install is with pipx, which puts the tdw command on your path in an isolated environment:

pipx install test-data-workbench

Or into an existing environment with pip:

pip install test-data-workbench

PostgreSQL support pulls in the database driver:

pip install "test-data-workbench[postgres]"

For development (running the test suite):

git clone https://github.com/VolanticSystems/test-data-workbench.git
cd test-data-workbench
pip install -e ".[dev]"
pytest

tdw --version
tdw demo --seed 42

The demo command builds a small SQLite database and runs the full analyze- and-deploy flow against it, which confirms the install end to end.