Calculadora CLI

Uma calculadora simples para terminal (CLI) escrita em Python, com operações básicas de soma, subtração, multiplicação e divisão, validação de entradas do usuário e mensagens coloridas no console.

• Operações: soma, subtração, multiplicação e divisão.
• Validação de entrada: impede valores inválidos e divisão por zero.
• UX no terminal: limpeza de tela, pausa opcional e confirmação de saída.
• Mensagens coloridas: feedback informativo, de erro e confirmação.

• Python 3.10+ (testado em Windows; funciona também em Unix/macOS).

Verifique a versão instalada:

python --version

No Windows, o comando pode ser py --version.

1. Clone o repositório.
2. Execute como módulo (recomendado):

# Windows / macOS / Linux
python -m calculadora_cli

Ou diretamente pelo arquivo na raiz (se presente):

python __main__.py

Ao iniciar, você verá o menu de operações:

| =============================================================== |
|             Bem-vindo à Calculadora no Terminal!                |
| =============================================================== |
| Operações disponíveis:                                          |
| 1. Soma                                                         |
| 2. Subtração                                                    |
| 3. Multiplicação                                                |
| 4. Divisão                                                      |
| 5. Sair                                                         |
| =============================================================== |

• Escolha a operação digitando um número de 1 a 5.
• Informe os dois números (float) quando solicitado.
• O resultado é exibido em formato simples (sem notação científica desnecessária).
• Após cada operação, você pode confirmar a saída ou continuar usando a calculadora.

• Soma: escolha 1, digite 3 e 4 → Resultado: 7
• Divisão por zero: escolha 4, digite 10 e 0 → Alerta: "Divisão por zero não é permitida."

.
|-- LICENSE
|-- README.md
|-- calculadora_cli
|   |-- __init__.py
|   |-- __main__.py
|   |-- objects
|   |   |-- calculadora.py
|   |
|   |-- utils
|       |-- logger.py
|       |-- terminal.py
|       |-- user_input.py
|
|-- tests
    |-- test_calculadora.py

• calculadora_cli/__main__.py: ponto de entrada do pacote; permite python -m calculadora_cli.
• calculadora_cli/objects/calculadora.py: classe Calculadora (somar, subtrair, multiplicar, dividir, calcular).
• calculadora_cli/utils/user_input.py: leitura segura de números (ler_float) e opções (ler_opcao).
• calculadora_cli/utils/terminal.py: utilidades de terminal (cls, pause, finalizar_programa, confirmar_saida).
• calculadora_cli/utils/logger.py: mensagens coloridas (alertar, informar, confirmar).
• tests/test_calculadora.py: testes unitários do módulo.

• Calculadora.calcular(a, b, operador) encaminha para a operação correta.
• Proteção contra divisão por zero com alerta e retorno None.
• O resultado é impresso com formatação :g para evitar notação científica.
• O loop principal em main.py permite múltiplas operações até o usuário solicitar saída.

Execute os testes com pytest a partir da raiz do projeto:

pip install pytest
pytest

Não há dependências externas. Para rodar ferramentas de lint/format (opcionais):

pip install ruff black
ruff .
black .

Este projeto está licenciado sob a licença MIT. Consulte o arquivo LICENSE.

• Histórico das operações no runtime.
• Suporte a mais operações (potência, raiz, porcentagem).
• Configurar pyproject.toml para ferramentas (pytest, black, ruff).