Contributing

Development setup

git clone https://github.com/hitoshyamamoto/soapbar
cd soapbar
uv sync --group dev --group lint --group type

# Run tests
uv run pytest tests/ -v

# Lint
uv run ruff check src/ tests/

# Type check
uv run mypy src/

Optionally, run the fuzz harness locally (Atheris needs CPython 3.12+):

uv run --group fuzz python fuzz/fuzz_parsing.py -max_total_time=60

Run the example server (requires FastAPI + uvicorn):

pip install fastapi uvicorn
uvicorn examples.calculator_fastapi:app --reload --port 8000

Then fetch the WSDL: curl http://localhost:8000/soap?wsdl

Contributing guide

See the full contributing guide at CONTRIBUTING.md on GitHub.