HTTP, Requests e Download de Arquivos em Python

Introdução ao HTTP

• HTTP é o protocolo base da Web: clientes (navegadores) ↔ servidores.
• Troca de mensagens requisição → resposta, com métodos, códigos de status, cabeçalhos e corpo.
• Versões: 0.9 → 1.0 → 1.1 (persistência) → HTTP/2 (desempenho) → HTTP/3 (QUIC).

Biblioteca requests (Python)

Interface simples e “pythônica” para HTTP.

pip install requests tqdm

import requests

r = requests.get("https://httpbin.org/get", timeout=10)
print(r.status_code)   # 200
print(r.headers["Content-Type"])
print(r.text[:120])    # corpo como string

Use timeout sempre que possível.

Analisando Respostas (requests)

• Status Code: sucesso/erro (response.status_code).
• Cabeçalhos: metadados (response.headers).
• Conteúdo: .json(), .text, .content.
• Encoding: response.encoding (ajuste se necessário).
• Cookies: response.cookies.

r = requests.get("https://httpbin.org/anything", timeout=10)
if r.status_code == 200:
    print(r.headers.get("Content-Type"))
    payload = r.json() if "application/json" in r.headers.get("Content-Type","") else r.text
else:
    print(f"Falha: {r.status_code}")

Download de Arquivos (HTTP)

• Use streaming para não carregar o arquivo inteiro na memória: stream=True.
• Leia em chunks (ex.: 1024 bytes) e grave em modo binário 'wb'.
• Exiba barra de progresso com tqdm usando Content-Length.
• Valide status (raise_for_status()) e verifique headers.

Download simples (stream + barra)

import requests
from tqdm import tqdm

url = "https://httpbin.org/image/png"
nome_arquivo = "imagem.png"

with requests.get(url, stream=True, timeout=30) as r:
    r.raise_for_status()
    total = int(r.headers.get("content-length", 0))
    with open(nome_arquivo, "wb") as f, tqdm(
        total=total, unit="B", unit_scale=True, desc=nome_arquivo
    ) as pbar:
        for chunk in r.iter_content(chunk_size=1024):
            if chunk:
                f.write(chunk)
                pbar.update(len(chunk))
print("Download concluído!")

Classe de Download com Callback

import requests
from tqdm import tqdm

class Download:
    def __init__(self, url: str, path_arquivo: str):
        self.url = url
        self.path_arquivo = path_arquivo
        self.callback = None  # def callback(total, progresso): ...

    def set_callback(self, cb):
        self.callback = cb

    def executa(self) -> int:
        try:
            with requests.get(self.url, stream=True, timeout=60) as r:
                r.raise_for_status()
                total = int(r.headers.get("content-length", 0))
                with open(self.path_arquivo, "wb") as f, tqdm(
                    total=total, unit="B", unit_scale=True, desc=self.path_arquivo
                ) as pbar:
                    for chunk in r.iter_content(chunk_size=1024):
                        if chunk:
                            f.write(chunk)
                            pbar.update(len(chunk))
                            if self.callback:
                                self.callback(total, pbar.n)
            print(f"OK: {self.path_arquivo} ({total} bytes)")
            return total
        except requests.exceptions.MissingSchema:
            raise Exception("URL inválida. Verifique o esquema (http/https).")
        except requests.exceptions.RequestException as e:
            raise Exception(f"Erro na conexão: {e}")

Uso da classe

def on_progress(total, atual):
    if total:
        pct = (atual / total) * 100
        # aqui você pode notificar UI/log etc.
        # print(f"{pct:.1f}%")

url1 = "https://httpbin.org/image/png"
down = Download(url1, "meu_arquivo.png")
down.set_callback(on_progress)
down.executa()

Checklist de Análise da Resposta

• Status code → 200 é sucesso típico; trate 4xx/5xx.
• Cabeçalhos → Content-Type, Content-Length, ETag.
• Conteúdo → .json() / .text / .content.
• Encoding → ajuste response.encoding quando necessário.
• Exceções → try/except RequestException + timeout.

Exercícios (Lab)

1. Faça um GET com parâmetros e imprima status, headers e os 200 primeiros caracteres do corpo.
2. Implemente um POST com json e trate exceções (timeout, HTTPError).
3. Baixe uma imagem (PNG/JPEG) exibindo a barra de progresso (tqdm).
4. Transforme o download em função reutilizável e depois em classe com callback.