Publishing to PyPI

Este documento descreve como publicar o pacote django-rule-engine no PyPI usando GitHub Actions.

Configuração Inicial

1. Configurar Trusted Publishing no PyPI

O workflow usa o método de “Trusted Publishing” (OIDC) do PyPI, mais seguro que tokens longos.

Para PyPI (produção)

Acesse https://pypi.org/manage/account/publishing/
Clique em “Add a new pending publisher”
Preencha:
- PyPI Project Name: django-rule-engine
- Owner: kelsoncm
- Repository name: django-rule-engine
- Workflow name: publish-to-pypi.yml
- Environment name: pypi
Clique em “Add”

Para TestPyPI (testes)

Acesse https://test.pypi.org/manage/account/publishing/
Siga os mesmos passos acima, mas com:
- Environment name: testpypi

2. Configurar Environments no GitHub

Vá para Settings → Environments no seu repositório GitHub
Crie dois environments:
- pypi - para publicação em produção
- testpypi - para testes

Como Publicar

Método 1: Publicação Automática (Release)

A forma recomendada é criar uma release no GitHub:

Atualize a versão no arquivo pyproject.toml e src/django_rule_engine/__init__.py
Commit e push das mudanças
Crie uma tag de versão:
```
git tag v1.0.1
git push origin v1.0.1
```
Vá para GitHub → Releases → “Create a new release”
Selecione a tag criada e clique em “Publish release”

Método 2: Publicação Manual

Para testar no TestPyPI ou forçar uma publicação manual:

Vá para Actions → “Publish to PyPI” → “Run workflow”
Escolha a branch e a opção test_pypi se for um teste.

Testando a Publicação

# Instalar do TestPyPI
pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ django-rule-engine

# Testar a instalação
python -c "import django_rule_engine; print(django_rule_engine.__version__)"