Sandbox

Introduction

Acquire sources.

git clone https://github.com/pyveci/supertask
cd supertask

It is recommended to use a Python virtualenv for the subsequent operations. If you something gets messed up during development, it is easy to nuke the installation, and start from scratch.

uv venv --python 3.13 --seed .venv
source .venv/bin/activate

Install project in sandbox mode.

uv pip install --upgrade --editable='.[test,develop]'

Start service containers needed for running the test suite completely.

docker run --rm --name=cratedb \
  --publish=4200:4200 --publish=5432:5432 \
  --env=CRATE_HEAP_SIZE=2g \
  crate/crate:nightly \
  -Cdiscovery.type=single-node

docker run --rm --name=postgresql \
  --publish=5433:5432 \
  --env "POSTGRES_HOST_AUTH_METHOD=trust" \
  postgres:17 postgres -c log_statement=all

Run linters and software tests.

poe check

Format code.

poe format