Apostila de Flask: do Zero ao Projeto

October 16, 2026 · @gomes

Apresentação

Esta apostila leva você do zero até uma aplicação web Flask organizada, segura e pronta para produção. Ela tem duas partes: a Parte I explica os conceitos do framework; a Parte II constrói, passo a passo, um app de lista de tarefas aplicando cada conceito.

Pré-requisitos: Python 3.10 ou superior, noções de HTML e de linha de comando. Não é preciso saber nada de Flask.

Como estudar: leia um capítulo, digite os exemplos (não copie e cole) e rode-os. Na Parte II, cada passo começa com o conceito e termina com a página funcionando.

Parte	Capítulos	O que você aprende
I – Fundamentos	1 a 4	O que é Flask, primeiro app, rotas, requisições, templates
I – Arquitetura e dados	5 a 7	Factory, blueprints, banco de dados, validações
I – Produção	8 a 12	Segurança, desempenho, escalonamento, testes, boas práticas
II – Projeto guiado	Passos 1 a 6	App de tarefas com login, CRUD, testes e deploy

Parte I – Conceitos

Capítulo 1 – O que é Flask

Flask é um microframework web para Python: entrega o essencial (rotas, requisições, respostas, templates) e deixa o resto para extensões que você escolhe. "Micro" não significa limitado; significa um núcleo pequeno e explícito, sem impor banco de dados, ORM ou estrutura de pastas.

As peças por baixo

WSGI (Web Server Gateway Interface): o contrato padrão entre servidores web Python (Gunicorn, uWSGI) e aplicações. Um app Flask é, no fundo, um objeto WSGI chamável.
Werkzeug: biblioteca que implementa roteamento, objetos de requisição e resposta, servidor de desenvolvimento e utilitários de segurança (hash de senha, por exemplo).
Jinja2: motor de templates que gera HTML com variáveis, laços, herança e escape automático contra XSS.
Click: base da linha de comando flask.
itsdangerous: assina dados (como o cookie de sessão) para que não sejam adulterados.

Filosofia

Explícito é melhor que implícito: você vê de onde vem cada coisa (from flask import request).
Comece simples, cresça com estrutura: um arquivo serve para um protótipo; blueprints e factory organizam apps grandes.
Escolha suas ferramentas: SQLAlchemy ou outro ORM, WTForms ou Pydantic, Redis ou Memcached.