Contribuindo¶
Obrigado por considerar contribuir.
O guia completo do contribuidor vive em CONTRIBUTING.md na raiz do repo. Resumo:
- Setup:
pip install -e ".[dev]"depoispre-commit install - Tests:
pytest(36 tests hoje) - Lint + types + format:
ruff check . && ruff format --check . && mypy src/engine - Conventional Commits:
feat:,fix:,refactor:,docs:,test:,chore: - Uma preocupação por PR
Checklist pra adicionar provider¶
- Implemente
engine.llm.<nome>_provider.pycasando o ProtocolLLMProvider - Adicione testes unitários em
tests/test_llm_<nome>.pyespelhandotests/test_llm_gemini.py - Adicione SDK como dep opcional em
pyproject.toml:[project.optional-dependencies] <nome> = ["sdk>=x"] - Documente em
docs/providers/index.md(ambos EN +.pt.md) - Adicione entrada no CHANGELOG sob
[Unreleased]
Reportando bugs¶
Issue no GitHub com: versão Python, OS, versão template-engine, repro mínimo, expected vs actual.
Pra issues de segurança veja SECURITY.md.