Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
66 lines (47 loc) · 1.43 KB

CONTRIBUTING.md

File metadata and controls

66 lines (47 loc) · 1.43 KB
Raw

Contributing to Handler

Prerequisites

  • Python 3.11+
  • uv for dependency management
  • just for running commands

Setup

git clone https://github.com/alDuncanson/handler.git
cd handler
just install

Development

Run just to see all available commands.

Common Commands

just check    # Run lint, format check, and typecheck
just fix      # Auto-fix lint and format issues
just test     # Run tests

Running Handler Locally

uv run handler --help          # Run any CLI command
uv run handler tui             # Launch the TUI
uv run handler server run push # Start the push notification webhook server

Working on the docs

The Mintlify docs source lives in docs/.

npm i -g mint
cd docs
mint dev

When the Mintlify GitHub app is connected to this repository, pushes to the default branch redeploy the docs automatically.

Code Style

  • Formatting: ruff format
  • Linting: ruff check
  • Type Checking: ty check
  • Testing: pytest

Verifying a Release

Every tagged build is attested. To check that an artifact really came from this repository's release workflow:

gh attestation verify dist/a2a_handler-*.whl --repo alDuncanson/Handler
uvx pypi-attestations verify pypi --repository https://github.com/alDuncanson/Handler \
  pypi:a2a_handler-<version>-py3-none-any.whl