Bottle 'Hello World'

1 Qu'est-ce que Bottle ?

Bottle est un framework web Python léger, constitué d'un seul fichier. Il possède un serveur HTTP intégré, un système de routage simple, la gestion des templates, et des utilitaires pour les cookies, les en-têtes et les données de formulaire. Pensez-y comme à un couteau suisse de poche : aucune dépendance lourde.

Framework en un seul fichier
Serveur WSGI intégré
Routage, helpers pour requêtes/réponses, et templating
Idéal pour les microservices, les points d'API et les démonstrations rapides

Ensuite, nous installerons Bottle et exécuterons une petite application en moins d'une minute.

2 Prérequis

Vous aurez besoin de Python 3.8+ et de pip installés. Vérifiez vos versions :

python --version
pip --version

3 Installer Bottle

Installez Bottle en utilisant pip :

pip install bottle

Vous verrez qu'il télécharge une seule wheel — aucune surprise.

4 Votre première application

Créez un fichier nommé hello.py et collez-y le code ci-dessous :

# 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 Exécuter l'application

Démarrez le serveur :

python hello.py

Visitez http://127.0.0.1:8080/ dans votre navigateur. Vous devriez voir « Hello, Bottle ! ».

6 Routes et chemins

Ajoutez quelques routes pour voir les modèles en action :

from bottle import Bottle, template

app = Bottle()

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

@app.route("/hello/<name>")
def greet(name):
    # Retourne une chaîne HTML. Aucun moteur de template externe requis pour les bases.
    return template("<h1>Hello, !</h1>", name=name)

if __name__ == "__main__":
    # Le rechargement automatique fonctionne bien avec debug=True pendant le développement.
    app.run(host="127.0.0.1", port=8080, debug=True, reloader=True)

7 Paramètres de requête et chaînes de requête

Bottle passe les paramètres de route comme arguments de fonction et capture les chaînes de requête avec 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 et codes de statut

Gérez le JSON posté et définissez un code de statut 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 Fichiers statiques et un template basique

Servez des assets statiques depuis un dossier et utilisez le moteur SimpleTemplate intégré à Bottle :

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

app = Bottle()

# Sert les fichiers depuis ./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)

Créez templates/index.tpl avec un contenu comme : <% title = "Index" %> ... puis rendez-le avec template("index", title="Index") si vous préférez les fichiers.

10 Tester rapidement

Utilisez curl pour vérifier les réponses sans quitter le 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 Prochaines étapes

À partir de là, ajoutez des gestionnaires d'erreurs, des middlewares et des décorateurs de route. Connectez un serveur de production (workers gunicorn + uvicorn) ou déployez derrière un proxy inverse. Gardez-le petit, gardez-le rapide.

Progression du Tutoriel