Prática: montar um projeto isolado

Montar o projeto do zero

Esta aula é para fazer junto, no seu computador, no Prompt de Comando ou no PowerShell. Nada aqui roda no Playground, porque a prática inteira gira em torno de ambiente virtual e pip. Vamos montar um projetinho que usa o requests para buscar um dado de uma API de teste e mostrar na tela. Não importa que seja simples: o objetivo é fixar o fluxo profissional completo, do jeito que você vai repetir em todo projeto novo daqui para frente. Faça cada passo com calma, na ordem.

# 1) criar a pasta e entrar nela
mkdir meu-projeto
cd meu-projeto

# 2) criar e ativar o ambiente virtual
python -m venv .venv
.venv\Scripts\activate

# 3) instalar o pacote necessario
pip install requests

Passos 1 a 3: pasta, ambiente virtual ativo e o pacote instalado na despensa.

Depois do terceiro passo, você tem uma pasta de projeto com um ambiente virtual ativo (repare no prefixo .venv no terminal) e o requests instalado só ali dentro. Já é um projeto isolado de verdade. Antes de escrever qualquer código, é bom hábito congelar a receita, para que o projeto nasça reprodutível. Assim, se alguém pegar essa pasta depois, ou se você abrir em outro computador, o ambiente se recria com um comando. A receita se gera com o mesmo pip freeze que você já conhece.

Congelar a receita e rodar o script

# 4) congelar a receita do projeto
pip freeze > requirements.txt

Passo 4: a lista de dependências, pronta para versionar junto do código.

Com a receita salva, crie um arquivo chamado app.py na pasta do projeto, pelo seu editor de código, e escreva o script abaixo. Ele importa o requests, faz um GET a uma API pública de teste, confere o código de status e, se der certo, mostra um campo dos dados. É o mesmo raciocínio da aula anterior, agora dentro do seu próprio projeto. Note que o script trata o caso de erro: se o status não for 200, ele avisa em vez de quebrar tentando ler dados que não vieram.

import requests

def buscar_tarefa(numero):
    url = f"https://jsonplaceholder.typicode.com/todos/{numero}"
    resposta = requests.get(url, timeout=10)
    if resposta.status_code != 200:
        return None
    return resposta.json()

tarefa = buscar_tarefa(1)
if tarefa is None:
    print("Nao foi possivel buscar a tarefa.")
else:
    print("Titulo:", tarefa["title"])
    print("Concluida?", "sim" if tarefa["completed"] else "nao")

O arquivo app.py: uma função pequena que busca e trata a resposta com cuidado.

Agora rode o script. No terminal, ainda com o ambiente ativo, digite python app.py e aperte Enter. Se tudo estiver certo, o programa imprime o título da tarefa e se ela está concluída. Se o requests não estiver instalado ou o ambiente não estiver ativo, o Python reclama que não encontrou o módulo, e essa é a dica para você conferir o (.venv). Rode algumas vezes, mude o número da tarefa na chamada buscar_tarefa e veja a saída mudar. Você acabou de percorrer o fluxo completo de um projeto Python.

# 5) rodar o script, com o ambiente ativo
python app.py

Passo 5: executar o programa dentro da despensa do projeto.

Checklist do projeto isolado

Para fechar, uma lista de conferência. Sempre que montar um projeto novo, passe os olhos por estes pontos. Eles resumem tudo que você viu no módulo e garantem que o projeto nasce isolado, reprodutível e limpo. Com o tempo, esse checklist deixa de ser uma lista para consultar e vira um reflexo: você faz na ordem sem pensar. É o hábito que separa um monte de scripts soltos de projetos que você e outras pessoas conseguem retomar meses depois sem sofrimento.