calculadora-manuesy-api 0.1.0

Uma calculadora básica com FastAPI

API Calculadora

Esta é uma API simples de calculadora construída usando FastAPI. A API fornece endpoints para realizar operações aritméticas básicas, como adição, subtração, multiplicação e divisão.

Funcionalidades

• Realizar operações aritméticas básicas:
  • Adição
  • Subtração
  • Multiplicação
  • Divisão
  • Fatorial
  • Exponencial
  • Raiz Quadrada
• Validação de entrada usando modelos do Pydantic.
• Lida com divisão por zero de forma adequada, com mensagens de erro apropriadas.

Requisitos

• Python 3.9 ou superior
• Dependências listadas no arquivo requirements.txt:
  • fastapi==0.95.2
  • pydantic==1.10.7
  • uvicorn==0.22.0

Instalação

1. Clone o repositório:

   git clone https://github.com/your-username/calculadora-fastapi.git
   cd calculadora-fastapi
   

2. Crie um ambiente virtual e ative-o:

   python -m venv venv
   source venv/bin/activate  # No Windows: venv\Scripts\activate
   

3. Instale as dependências:

   pip install -r requirements.txt
   

Executando a Aplicação

1. Inicie o servidor FastAPI usando o Uvicorn:

   uvicorn app.main:app --reload
   

2. Abra o navegador e navegue para:

   http://127.0.0.1:8000/docs
   

   Isso abrirá a documentação interativa da API (Swagger UI).

Endpoints da API

1. Adição

• Endpoint: /add
• Método: POST
• Corpo da Requisição:

  {
    "a": 5,
    "b": 3
  }
  

• Resposta:

  {
    "result": 8
  }
  

2. Subtração

• Endpoint: /subtract
• Método: POST
• Corpo da Requisição:

  {
    "a": 5,
    "b": 3
  }
  

• Resposta:

  {
    "result": 2
  }
  

3. Multiplicação

• Endpoint: /multiply
• Método: POST
• Corpo da Requisição:

  {
    "a": 5,
    "b": 3
  }
  

• Resposta:

  {
    "result": 15
  }
  

4. Divisão

• Endpoint: /divide
• Método: POST
• Corpo da Requisição:

  {
    "a": 6,
    "b": 3
  }
  

• Resposta:

  {
    "result": 2
  }
  

• Tratamento de Erros:
  • Se b for 0, a API retornará:

    {
      "detail": "Division by zero is not allowed"
    }
    

Estrutura do Projeto

calculadora-fastapi/
├── app/
│   ├── main.py          # Ponto de entrada da aplicação FastAPI
│   ├── models.py        # Modelos Pydantic para requisição e resposta
│   ├── operations.py    # Funções de operações aritméticas
├── requirements.txt     # Dependências do projeto
├── README.md            # Documentação do projeto

Licença

Este projeto está licenciado sob a Licença MIT. Consulte o arquivo LICENSE para mais detalhes.

Agradecimentos

• Construído com FastAPI
• Inspirado na simplicidade do Python para construir APIs.