basetenlabs§truss

Imported from gencau/test-practices-agent-configurations (dataset/repos/basetenlabs§truss/AGENTS.md). Install upstream with npx skills add gencau/test-practices-agent-configurations --skill basetenlabs§truss. Copyright stays with the author.

Truss Development Guide

Package Management

Use uv for all Python operations:

uv run pytest ...          # Run tests
uv run ruff check .        # Lint
uv run ruff format .       # Format
uv run truss <command>     # Run truss CLI

Linting & Formatting

Always run before committing:

uv run ruff check <files>
uv run ruff format <files>

Code Style

• No inline imports - Always place imports at the top of the file in global scope, never inside functions.

Testing

# Unit tests
uv run pytest truss/tests/path/to/test.py -v

# Integration tests (requires Docker)
uv run pytest truss/tests/test_custom_server.py -v -m integration

# Run specific test
uv run pytest truss/tests/test_config.py::test_name -v

Test fixtures: Use test_data_path fixture (from conftest.py) for config files in truss/tests/test_data/.

Key Code Locations

Architecture Notes

• docker_server deployments use supervisord to manage processes
• Config is validated via Pydantic models in truss_config.py
• Image build generates Dockerfile from Jinja templates