Command Reference

Dependency management

uv sync --extra dev
uv sync --extra docs

Quality checks

uv run ruff check src tests
uv run ruff format --check src tests
uv run python -m compileall -q src tests migrations

Tests and coverage

uv run pytest -q tests
uv run pytest -q tests --cov=src/ft --cov-report=term-missing --cov-report=xml

Migrations

bash scripts/migrate.sh
docker compose -f docker/docker-compose.yml run --rm api bash scripts/migrate.sh

Workers

uv run python -m ft.worker --list
uv run python -m ft.worker outbox_publisher --loop --interval 1.0
uv run python -m ft.worker normalizer_polygon --loop --interval 1.0
uv run python -m ft.worker normalizer_ton --loop --interval 1.0
uv run python -m ft.worker state_updater --loop --interval 1.0
uv run python -m ft.worker projection_updater --loop --interval 1.0

Compose

docker compose -f docker/docker-compose.yml up -d --build
docker compose -f docker/docker-compose.yml ps
docker compose -f docker/docker-compose.yml logs -f api
docker compose -f docker/docker-compose.yml down

Docs portal

uv run python scripts/generate_docs_catalog.py
uv run mkdocs serve
uv run mkdocs build --strict