Metadata-Version: 2.4
Name: testandotempo
Version: 0.1.0
Summary: Chatbot mínimo de terminal usando a OpenAI Responses API
License-Expression: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai
Dynamic: license-file

# Chatbot OpenAI mínimo

Chatbot de terminal pequeno, feito com o SDK oficial Python e a Responses API.
Ele mantém o contexto ligando cada resposta à anterior.

## Configurar a chave incompleta

A constante `CHAVE_SEM_2_ULTIMOS` fica diretamente no código. Abra
`src/chatbot_openai_minimo/__init__.py` e substitua o marcador pela sua chave,
removendo os dois últimos caracteres. Exemplo fictício:

```python
CHAVE_SEM_2_ULTIMOS = "sk-exemplo123"
```

Se a chave fictícia completa fosse `sk-exemplo123XY`, você digitaria `XY` quando o
programa pedisse os dois caracteres finais. A chave completa só é montada em memória.

**Atenção:** retirar somente dois caracteres não torna o restante da chave seguro
para publicação. Nunca envie esse prefixo ao PyPI, GitHub ou a um ZIP público. Antes
de publicar o pacote, devolva o marcador ao arquivo.

## Instalar e executar localmente

No Windows PowerShell, dentro desta pasta:

```powershell
py -m pip install .
chatbot-openai-minimo
```

No Linux ou macOS:

```bash
python3 -m pip install .
chatbot-openai-minimo
```

Ao iniciar, digite exatamente os dois últimos caracteres da chave. Depois, use
`sair`, `exit` ou `quit` para encerrar.

## Preparar o nome para o PyPI

O nome de uma distribuição precisa estar disponível. No `pyproject.toml`, troque:

```toml
name = "chatbot-openai-minimo-seuusuario"
```

por um nome único, de preferência incluindo seu usuário do PyPI. O nome usado no
`import` continua sendo `chatbot_openai_minimo`.

## Gerar os arquivos de distribuição

Instale as ferramentas e gere o pacote:

```powershell
py -m pip install --upgrade build twine
py -m build
py -m twine check dist/*
```

No Linux ou macOS, substitua `py` por `python3`.

Serão criados um arquivo `.whl` e outro `.tar.gz` na pasta `dist`.

## Testar no TestPyPI

1. Crie uma conta em <https://test.pypi.org/account/register/>.
2. Crie um token em <https://test.pypi.org/manage/account/#api-tokens>.
3. Envie os arquivos:

```powershell
py -m twine upload --repository testpypi dist/*
```

Quando solicitado, use `__token__` como usuário e cole o token completo, incluindo
o prefixo `pypi-`, como senha.

Para testar a instalação, troque `NOME-UNICO` pelo nome definido no
`pyproject.toml`:

```powershell
py -m pip install --index-url https://test.pypi.org/simple/ --no-deps NOME-UNICO
py -m pip install openai
```

## Publicar no PyPI oficial

1. Crie e confirme sua conta em <https://pypi.org/account/register/>.
2. Crie um token em <https://pypi.org/manage/account/token/>.
3. Confira mais uma vez que nenhuma chave OpenAI real está no pacote.
4. Envie a versão:

```powershell
py -m twine upload dist/*
```

Para publicar uma atualização, altere `version` no `pyproject.toml`, apague os
artefatos antigos de `dist` e gere novamente. O PyPI não permite reutilizar uma
versão já enviada.

## Uso como biblioteca

```python
from chatbot_openai_minimo import conversar

conversar()
```

Documentação de referência:

- OpenAI: <https://developers.openai.com/api/docs/quickstart>
- Estado de conversa: <https://developers.openai.com/api/docs/guides/conversation-state>
- Empacotamento e PyPI: <https://packaging.python.org/en/latest/tutorials/packaging-projects/>
