Bottle 'Hello World'

1 Was ist Bottle?

Bottle ist ein leichtgewichtiges, einteiliges Web-Framework für Python. Es verfügt über einen integrierten HTTP-Server, ein einfaches Routing-System, Templating sowie Hilfsmittel für Cookies, Header und Formulardaten. Betrachten Sie es als ein Taschenmesser, das in Ihre Tasche passt – keine schweren Abhängigkeiten.

Einteiliges Framework
Integrierter WSGI-Server
Routen, Request-/Response-Helfer und Templating
Großartig für Microservices, API-Endpunkte und schnelle Demos

Als Nächstes installieren wir Bottle und führen eine winzige App in weniger als einer Minute aus.

2 Voraussetzungen

Sie benötigen Python 3.8+ und pip installiert. Überprüfen Sie Ihre Versionen:

python --version
pip --version

3 Bottle installieren

Installieren Sie Bottle mit pip:

pip install bottle

Sie werden sehen, dass ein einzelnes Wheel heruntergeladen wird – keine Überraschungen.

4 Ihre erste App

Erstellen Sie eine Datei namens hello.py und fügen Sie den folgenden Code ein:

# 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 App ausführen

Starten Sie den Server:

python hello.py

Besuchen Sie http://127.0.0.1:8080/ in Ihrem Browser. Sie sollten "Hello, Bottle!" sehen.

6 Routen und Pfade

Fügen Sie ein paar Routen hinzu, um Muster in Aktion zu sehen:

from bottle import Bottle, template

app = Bottle()

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

@app.route("/hello/<name>")
def greet(name):
    # Gibt einen HTML-String zurück. Keine externe Templating-Engine für Grundlagen erforderlich.
    return template("<h1>Hello, !</h1>", name=name)

if __name__ == "__main__":
    # Automatisches Neuladen funktioniert gut mit debug=True während der Entwicklung.
    app.run(host="127.0.0.1", port=8080, debug=True, reloader=True)

7 Request-Parameter und Query-Strings

Bottle übergibt Routenparameter als Funktionsargumente und erfasst Query-Strings mit 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 und Statuscodes

Behandeln Sie POSTed JSON und setzen Sie einen HTTP-Statuscode:

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 Statische Dateien und ein Basis-Template

Servieren Sie statische Assets aus einem Ordner und verwenden Sie Bottles integrierte SimpleTemplate-Engine:

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

app = Bottle()

# Dateien aus ./static bereitstellen
@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)

Erstellen Sie templates/index.tpl mit Inhalt wie: <% title = "Index" %> ... und rendern Sie es dann mit template("index", title="Index"), wenn Sie Dateien bevorzugen.

10 Schnelles Testen

Verwenden Sie curl, um Antworten zu überprüfen, ohne das Terminal zu verlassen:

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 Nächste Schritte

Von hier aus können Sie Fehlerbehandlungsroutinen, Middleware und Routen-Dekoratoren hinzufügen. Schließen Sie einen Produktionsserver (gunicorn + uvicorn-Worker) an oder stellen Sie ihn hinter einem Reverse-Proxy bereit. Halten Sie es klein, halten Sie es schnell.

Tutorial Fortschritt