Bottle 'Hello World'

1 O que é Bottle?

Bottle é um framework web leve e de arquivo único para Python. Ele possui um servidor HTTP integrado, um sistema de roteamento simples, templates, utilitários para cookies, cabeçalhos e dados de formulário. Pense nele como um canivete suíço que cabe no seu bolso — sem dependências pesadas.

Framework de arquivo único
Servidor WSGI integrado
Rotas, auxiliares de requisição/resposta e templates
Ótimo para microsserviços, endpoints de API e demonstrações rápidas

Em seguida, instalaremos o Bottle e executaremos um aplicativo minúsculo em menos de um minuto.

2 Pré-requisitos

Você precisará do Python 3.8+ e do pip instalados. Verifique suas versões:

python --version
pip --version

3 Instale o Bottle

Instale o Bottle usando pip:

pip install bottle

Você verá que ele baixa uma única "wheel" — sem surpresas.

4 Seu primeiro aplicativo

Crie um arquivo chamado hello.py e cole o código abaixo:

# hello.py
from bottle import Bottle, run

app = Bottle()

@app.route("/")
def hello():
    return "Hello, Bottle!"

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

5 Execute o aplicativo

Inicie o servidor:

python hello.py

Visite http://127.0.0.1:8080/ no seu navegador. Você deve ver “Hello, Bottle!”

6 Rotas e caminhos

Adicione algumas rotas para ver os padrões em ação:

from bottle import Bottle, template

app = Bottle()

@app.route("/")
def index():
    return "Home"

@app.route("/hello/<name>")
def greet(name):
    # Retorna uma string HTML. Nenhum motor de template externo é necessário para o básico.
    return template("<h1>Hello, !</h1>", name=name)

if __name__ == "__main__":
    # A recarga automática funciona bem com debug=True durante o desenvolvimento.
    app.run(host="127.0.0.1", port=8080, debug=True, reloader=True)

7 Parâmetros de requisição e strings de consulta

Bottle passa parâmetros de rota como argumentos de função e captura strings de consulta com request.query:

from bottle import Bottle, request

app = Bottle()

@app.route("/sum/<a>/<b>")
def add(a, b):
    return f"{a} + {b} = {int(a) + int(b)}"

@app.route("/search")
def search():
    q = request.query.get("q", "")
    return f"Searching for: {q}"

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

8 POST, JSON e códigos de status

Manipule JSON postado e defina um código de status HTTP:

from bottle import Bottle, request, response
import json

app = Bottle()

@app.route("/echo", method="POST")
def echo():
    response.content_type = "application/json"
    response.status = 201
    body = request.json or {}
    return json.dumps({"you_sent": body})

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

9 Arquivos estáticos e um template básico

Sirva ativos estáticos de uma pasta e use o motor SimpleTemplate integrado do Bottle:

# Arquivo: app.py
from bottle import Bottle, static_file, template, run

app = Bottle()

# Sirva arquivos de ./static
@app.route("/static/<filepath:path>")
def static(filepath):
    return static_file(filepath, root="./static")

@app.route("/")
def index():
    return template("<h1>Hello from .</h1>", title="Bottle")

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

Crie um arquivo templates/index.tpl com conteúdo como: <% title = "Index" %> ... e então renderize-o com template("index", title="Index") se preferir arquivos.

10 Testando rapidamente

Use o curl para verificar respostas sem sair do terminal:

curl http://127.0.0.1:8080/
curl "http://127.0.0.1:8080/hello/World"
curl "http://127.0.0.1:8080/search?q=potato"
curl -X POST http://127.0.0.1:8080/echo -H "Content-Type: application/json" -d '{"msg":"hi"}'

11 Próximos passos

A partir daqui, adicione manipuladores de erro, middleware e decoradores de rota. Conecte um servidor de produção (gunicorn + workers uvicorn) ou implante atrás de um proxy reverso. Mantenha-o pequeno, mantenha-o rápido.

Progresso do Tutorial