Entrar Ainda não tem acesso?
3
respostas

[Sugestão] Criando o main.py(Difícil de compreender)

Referente ao curso Python: persistência de dados com arquivos, bancos de dados e APIs REST, no capítulo Persistência com PostgreSQL e FastAPI e atividade Criando o main.py

por Joanevan Bezerra Da Silva Oliveira
| 36.4k xp | 16 posts

Boa tarde!

Escrevo para endossar a sugestão de melhoria feita recentemente por outro aluno no fórum e para tentar ser um pouco mais específica sobre a dificuldade que encontrei.

O curso começou muito bem, e com alguma pesquisa adicional, consegui acompanhar e entender os conceitos iniciais, notando a calma e a boa didática do professor até este ponto. No entanto, ao chegar especificamente na aula sobre a criação do arquivo main.py, houve uma quebra abrupta no meu entendimento. A dificuldade é tão grande que, mesmo com pesquisas adicionais externas, o conteúdo não se encaixa. Entendo que alunos com um nível de conhecimento mais elevado na área podem não enfrentar essa dificuldade, mas para quem está aprendendo do zero, a sensação é de que o conteúdo passou de compreensível para completamente inacessível, mesmo com pesquisa adicional (peço desculpas pela franqueza, mas é como se a incompreensão fosse total a ponto de não conseguirmos sequer formular uma pergunta). Por isso, gostaria de solicitar, humildemente, que a equipe reavalie o conteúdo e a apresentação dessa aula específica, buscando introduzir mais passos intermediários ou explicações fundamentais. Também ficaria grata se pudessem sugerir materiais de estudo complementares que seriam importantes para ter uma base sólida e compreender esse assunto em particular. Vou tentar reassistir a aula pela quarta vez amanhã, mas aguardo ansiosamente por uma sugestão ou reavaliação para prosseguir.

Sou Grata a dedicação do professor até aqui, mas essa quebra precisa de uma ponte para que os iniciantes consigam finalizar o curso com sucesso.

Agradeço a atenção e o esforço de vocês em tornar o curso mais acessível!

3 respostas
por Carlos Miguel
| 23k xp | 1 posts

concordo! , consegui entender com ajuda de ia mas de começo complicado

por Joanevan Bezerra Da Silva Oliveira
| 36.4k xp | 16 posts

E ai? Não teremos mesmo nenhuma resposta da Alura?

por Lorena Garcia
| 13799.8k xp | 20403 posts
Instrutor

Oii, Joanevan.

Desculpe pela demora em responder, esse tópico acabou saindo do nosso radar.

Entendo perfeitamente o seu sentimento. Quando estamos aprendendo o desenvolvimento Web com Python, a transição do código lógico simples para a estrutura de uma API (como o FastAPI) com banco de dados (SQLAlchemy) parece um salto no escuro. São muitos conceitos novos "conversando" ao mesmo tempo.

Pra construir essa ponte que você mencionou, vamos decompor o main.py em três pilares fundamentais. Imagine que sua API é um restaurante:

  1. A portaria (Rotas/Endpoints): Onde o cliente (navegador) faz o pedido.
  2. O garçom (Funções): Quem leva o pedido para a cozinha e traz o prato.
  3. A despensa (Banco de Dados): Onde os ingredientes (dados) ficam guardados.

1. As importações: trazendo as ferramentas

Pense nas importações como preparar a bancada de trabalho. Sem elas, o Python não sabe o que é uma API ou uma Sessão de banco de dados.

  • FastAPI, Depends, HTTPException: O motor da nossa aplicação. O Depends é como um assistente que garante que o banco de dados esteja pronto antes de a função rodar.
  • Session: É o objeto que nos permite "conversar" com o banco (adicionar, deletar, buscar).
  • Models e Schemas: Models define como a tabela é no banco. Schemas define como o dado entra e sai da API (validação).

2. A conexão: o túnel para o banco

O trecho do get_db costuma ser o mais confuso. Vamos simplificar:

def get_db():
    db = SessionLocal() # Abre a porta da despensa
    try:
        yield db        # Entrega a chave para quem pediu
    finally:
        db.close()      # Garante que a porta seja trancada depois do uso

O yield é como um "pausa". Ele entrega a conexão para a rota usar e, assim que a rota termina o trabalho, o código volta para o finally e fecha a conexão. Isso evita que o banco de dados fique sobrecarregado.

3. Criando dados (POST): o fluxo da informação

Quando você envia um estudante para a API, o caminho é este:

  1. Validação: O FastAPI olha para o schemas.EstudanteCreate e verifica: "O nome é texto? A idade é número?". Se estiver errado, ele nem deixa entrar.
  2. Conversão: O **student.model_dump() transforma os dados que vieram da internet em um formato que o banco de dados entende.
  3. Persistência: * db.add: Coloca o estudante na "fila".
    • db.commit: Aperta o botão "Salvar" definitivamente.
    • db.refresh: Atualiza o objeto com o ID que o banco gerou automaticamente.

Dicas para não travar no estudo:

Pra que o conteúdo se torne acessível, sugiro focar nestes temas antes de tentar decorar o código do main.py:

  • Decoradores em Python: Entenda o que o @app.post faz (ele avisa ao Python que aquela função pertence a uma URL específica).
  • Tipagem de Dados (Type Hinting): Entenda por que escrevemos db: Session. Isso ajuda o editor a te dar sugestões e o FastAPI a validar os dados.

Sugestão de Material Complementar:

Não se sinta mal por precisar ver a aula várias vezes. A curva de aprendizado em APIs é íngreme no começo, mas assim que você entende o "fluxo" do dado (da URL para a função, da função para o banco), tudo começa a fazer sentido.

Se tiver alguma dúvida mais específica, pode mandar que te ajudarei.

Obrigada por compartilhar seu relato.

Alura Conte com o apoio da comunidade Alura na sua jornada. Abraços e bons estudos!

Tópicos relacionados

Mostrar mais tópicos Mostrar menos tópicos

Conteúdos Alura com o tema

Trilhas por carreira

Carreiras de IA

Carreiras de Dados

Carreiras de Cyber

Carreiras de DevOps & Cloud

Carreiras de UX & UI

Carreiras de Mobile & Front-End

Carreiras de Back-End

Carreiras de Negócios

Cursos universitários FIAP

Graduação | Pós-graduação | MBA