Flask 'Olá Mundo'

1 Introdução ao Flask

Flask é um framework web WSGI leve para Python. Ele oferece o essencial — roteamento, tratamento de requisição/resposta, templating (via Jinja2) e um sólido ecossistema de extensões — sem a complexidade de uma plataforma full-stack.

Por que as pessoas escolhem o Flask:

Núcleo minimalista com extensões "batteries-available".
Layout de projeto flexível — de um único arquivo a aplicações modulares.
Código-fonte legível e acessível.
Pronto para produção quando combinado com um servidor WSGI como o Gunicorn.

Clique em "Próximo" para configurar seu ambiente.

2 Pré-requisitos: Python e pip

Instale o Python 3.8 ou mais recente, e confirme com:

python --version

Precisa do Python? Baixe em python.org.

3 Criar um ambiente virtual

Isole dependências com um ambiente virtual.

python -m venv .venv

Ative-o:

# macOS/Linux
source .venv/bin/activate

# Windows (Prompt de Comando)
.venv\Scripts\activate

Você verá (.venv) no seu prompt quando estiver ativo.

4 Instalar o Flask

Com seu ambiente virtual ativo, instale o Flask.

pip install Flask

Confirme a instalação:

pip list | grep -i flask

5 Escrever uma aplicação Flask mínima

Crie um arquivo chamado app.py com este conteúdo:

from flask import Flask

app = Flask(__name__)

@app.get("/")
def hello():
    return "Hello from Flask!"

@app.get("/hello/")
def hello_name(name: str):
    # Conversores de URL: string, int, float, path (o padrão é string)
    return f"Hello, {name}!"

if __name__ == "__main__":
    # Apenas para desenvolvimento local
    app.run(host="127.0.0.1", port=5000, debug=True)

Decoradores de rota mapeiam métodos HTTP para funções Python. O segmento entre colchetes angulares captura um parâmetro de caminho.

6 Executar a aplicação

Inicie o servidor de desenvolvimento:

python app.py

Você deve ver uma saída apontando para http://127.0.0.1:5000. O terminal ficará bloqueado; pare-o com Ctrl+C.

7 Testar os endpoints

Abra seu navegador:

http://127.0.0.1:5000/ — “Hello from Flask!”
http://127.0.0.1:5000/hello/Flask — “Hello, Flask!”

Você também pode usar o curl:

curl http://127.0.0.1:5000/
curl http://127.0.0.1:5000/hello/World

8 Usar o modo de depuração do Flask

Em desenvolvimento, debug=True ativa a recarga ao vivo do código e melhores rastreamentos de erro — muito útil ao iterar.

Se você não o ativou antes, altere as últimas linhas em app.py:

if __name__ == "__main__":
    app.run(host="127.0.0.1", port=5000, debug=True)

Nota: não use o servidor embutido em produção. Para produção, execute atrás de um servidor WSGI real (ex: Gunicorn) atrás de um proxy reverso (ex: Nginx).

9 Estrutura de projeto (opcional)

À medida que os projetos crescem, um layout organizado ajuda:

hello-flask/
├─ app/
│  ├─ __init__.py
│  └─ routes.py
├─ requirements.txt
└─ run.py

Exemplo de app/__init__.py:

from flask import Flask

def create_app():
    app = Flask(__name__)
    from .routes import bp
    app.register_blueprint(bp, url_prefix="/")
    return app

Exemplo de app/routes.py:

from flask import Blueprint

bp = Blueprint("main", __name__)

@bp.get("/")
def hello():
    return "Hello from Flask!"

@bp.get("/hello/")
def hello_name(name: str):
    return f"Hello, {name}!"

Exemplo de run.py:

from app import create_app

app = create_app()

if __name__ == "__main__":
    app.run(host="127.0.0.1", port=5000, debug=True)

Salve as dependências com pip freeze > requirements.txt.

10 Próximos passos e armadilhas comuns

Templates: use render_template("index.html", name=name) com arquivos Jinja2.
Arquivos estáticos: sirva CSS/JS de uma pasta static/.
Configuração: mantenha segredos fora do código; use variáveis de ambiente.
Produção: execute atrás de Gunicorn ou uWSGI, atrás de um proxy reverso.
O servidor de depuração não recarregará no Windows com git-bash + virtualenv — use o Prompt de Comando ou PowerShell para ativar o venv lá.

Agora você tem uma aplicação Flask funcionando. A partir daqui, você pode adicionar templates, formulários e uma estrutura de projeto real sem alterar a ideia principal.

Progresso do Tutorial