Skip to content

RodrigoMA21/calculation-toolkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧮 Calculation Toolkit

Python Status License Deploy

🌐 API Online:
👉 https://calculation-toolkit-api.onrender.com


Aplicação desenvolvida em Python que oferece utilitários de cálculo via CLI interativo e também através de uma API REST com Flask.

Este projeto demonstra boas práticas de desenvolvimento, organização de código e evolução de um sistema simples para uma aplicação mais robusta.


🚀 Funcionalidades

💻 CLI (Terminal)

  • Conversão de temperatura (Celsius → Fahrenheit)
  • Cálculo de fatorial
  • Validação de entrada do usuário
  • Mensagens coloridas no terminal

🌐 API REST

  • Endpoint para conversão de temperatura
  • Endpoint para cálculo de fatorial
  • Retorno em formato JSON
  • Tratamento de erros

📁 Estrutura do projeto

calculation-toolkit/
│
├── main.py
├── api.py
├── services/
├── utils/
├── tests/
├── assets/
└── README.md

▶️ Como executar

🔹 CLI

python main.py

🔹 API

python api.py

A API estará disponível em:

http://127.0.0.1:5000

🌐 Endpoints

📌 Converter temperatura

GET /temperatura?celsius=25

Resposta:

{
  "celsius": 25,
  "fahrenheit": 77.0
}

📌 Calcular fatorial

GET /fatorial?numero=5

Resposta:

{
  "numero": 5,
  "fatorial": 120
}

📸 Exemplos

💻 CLI

CLI


🌡️ Conversão de temperatura

Temperatura


🔢 Cálculo de fatorial

Fatorial


📚 Conceitos aplicados

  • Entrada de dados com input()
  • Conversão de tipos (int, float)
  • Tratamento de exceções (try/except)
  • Modularização de código
  • Uso de bibliotecas padrão (math)
  • Criação de API com Flask
  • Estruturação de projeto (clean code)

📈 Melhorias futuras

  • Deploy da API na nuvem
  • Interface gráfica (GUI)
  • Testes automatizados mais avançados
  • Documentação com Swagger

👨‍💻 Autor

Desenvolvido por Rodrigo Mayer Alves

About

CLI application in Python for temperature conversion and factorial calculation

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages