Primeiros Passos com FastAPI 🚀

Primeiros Passos com FastAPI 🚀

FastAPI é um framework moderno e rápido para criar APIs com Python. Neste guia, você aprenderá como configurar o ambiente, instalar as dependências e criar sua primeira aplicação. Vamos usar Poetry para gerenciar o ambiente virtual e as dependências.

1. Pré-requisitos 🛠️

Antes de começar, certifique-se de ter o seguinte instalado no seu sistema:

• Python: Versão 3.8 ou superior
• Poetry: Gerenciador de dependências e ambientes virtuais

Instalando o Python

• Windows:

  1. Baixe o instalador em python.org
  2. Durante a instalação, habilite a opção “Add Python to PATH”

• Linux (Ubuntu/Debian):

  sudo apt update
  sudo apt install python3 python3-pip

• macOS:

  brew install python

Instalando o Poetry

Recomendado via pipx (instale primeiro o pipx se necessário):

pipx install poetry

Verifique a instalação:

poetry --version

2. Criando o Projeto com FastAPI 🐍

Passo 1: Configurando o Ambiente Virtual

1. Crie uma pasta para o projeto:

   mkdir fastapi-app
   cd fastapi-app

2. Inicialize o projeto com Poetry:

   poetry init -n

3. Instale as dependências:

   poetry add fastapi "uvicorn[standard]"

3. Criando Sua Primeira Aplicação 🌟

Crie um arquivo main.py com:

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def home():
    return {"message": "Bem-vindo ao FastAPI!"}

@app.get("/hello/{name}")
def saudacao(name: str):
    return {"message": f"Olá, {name}!"}

4. Executando o Servidor 🖥️

Use o Poetry para executar dentro do ambiente virtual:

poetry run uvicorn main:app --reload

Acesse:

• http://127.0.0.1:8000 (Aplicação)
• http://127.0.0.1:8000/docs (Documentação interativa)

5. Testando Endpoints 🛠️

Via Terminal com HTTPie

Instale globalmente (recomendado):

pipx install httpie

Teste os endpoints:

http GET http://127.0.0.1:8000/hello/Mundo

6. Dicas Finais ✨

• Para exportar dependências:

  poetry self add poetry-plugin-export
  poetry export -f requirements.txt --output requirements.txt

• Comando útil no pyproject.toml:

  [tool.poetry.scripts]
  start = "uvicorn main:app --reload"

  Execute com:

  poetry run start

Referência 📚

Este tutorial foi inspirado no conteúdo do livro:

• FastAPI: Modern Python Web Development
• Autor: Bill Lubanovic
• Publicado por: O’Reilly Media
• ISBN: 978-1-098-13550-8