Bottle 'Hola Mundo'

1 ¿Qué es Bottle?

Bottle es un framework web ligero de un solo archivo para Python. Tiene un servidor HTTP integrado, un sistema de enrutamiento simple, plantillas, utilidades para cookies, encabezados y datos de formularios. Piénsalo como una navaja suiza que cabe en tu bolsillo, sin dependencias pesadas.

Framework de un solo archivo
Servidor WSGI integrado
Rutas, ayudantes de solicitud/respuesta y plantillas
Ideal para microservicios, puntos finales de API y demostraciones rápidas

A continuación, instalaremos Bottle y ejecutaremos una pequeña aplicación en menos de un minuto.

2 Requisitos previos

Necesitarás Python 3.8+ y pip instalados. Verifica tus versiones:

python --version
pip --version

3 Instalar Bottle

Instala Bottle usando pip:

pip install bottle

Verás que descarga una sola rueda (wheel), sin sorpresas.

4 Tu primera aplicación

Crea un archivo llamado hello.py y pega el siguiente código:

# 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 Ejecutar la aplicación

Inicia el servidor:

python hello.py

Visita http://127.0.0.1:8080/ en tu navegador. Deberías ver "Hello, Bottle!".

6 Rutas y caminos

Agrega algunas rutas para ver los patrones en acción:

from bottle import Bottle, template

app = Bottle()

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

@app.route("/hello/<name>")
def greet(name):
    # Devuelve una cadena HTML. No se requiere un motor de plantillas externo para lo básico.
    return template("<h1>Hello, !</h1>", name=name)

if __name__ == "__main__":
    # La recarga automática funciona bien con debug=True durante el desarrollo.
    app.run(host="127.0.0.1", port=8080, debug=True, reloader=True)

7 Parámetros de solicitud y cadenas de consulta

Bottle pasa los parámetros de ruta como argumentos de función y captura las cadenas de consulta con 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 y códigos de estado

Maneja JSON POSTeado y establece un código de estado 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 Archivos estáticos y una plantilla básica

Sirve activos estáticos desde una carpeta y usa el motor SimpleTemplate integrado de Bottle:

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

app = Bottle()

# Sirve archivos desde ./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)

Crea templates/index.tpl con contenido como: <% title = "Index" %> ... luego reprodúcelo con template("index", title="Index") si prefieres archivos.

10 Prueba rápida

Usa curl para verificar las respuestas sin salir de la 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 pasos

A partir de aquí, agrega manejadores de errores, middleware y decoradores de rutas. Conecta un servidor de producción (trabajadores gunicorn + uvicorn) o despliega detrás de un proxy inverso. Mantenlo pequeño, mantenlo rápido.

Progreso del tutorial