Bottleハローワールドチュートリアル

1 Bottleとは？

BottleはPython向けの軽量なシングルファイルWebフレームワークです。組み込みHTTPサーバー、シンプルなルーティングシステム、テンプレート、Cookie、ヘッダー、フォームデータ用のユーティリティを備えています。ポケットに入るスイスアーミーナイフのようなものと考えてください。重い依存関係はありません。

シングルファイルフレームワーク
組み込みWSGIサーバー
ルート、リクエスト/レスポンスヘルパー、テンプレート
マイクロサービス、APIエンドポイント、クイックデモに最適

次に、Bottleをインストールし、1分以内に簡単なアプリを実行します。

2 前提条件

Python 3.8+とpipがインストールされている必要があります。バージョンを確認してください:

python --version
pip --version

3 Bottleのインストール

pipを使ってBottleをインストールします:

pip install bottle

1つのホイールがダウンロードされるのが表示されるはずです。驚くことはありません。

4 最初のアプリ

hello.py という名前のファイルを作成し、以下のコードを貼り付けてください:

# 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 アプリの実行

サーバーを起動します:

python hello.py

ブラウザで http://127.0.0.1:8080/ にアクセスしてください。「Hello, Bottle!」と表示されるはずです。

6 ルートとパス

いくつかのルートを追加して、パターンの動作を見てみましょう:

from bottle import Bottle, template

app = Bottle()

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

@app.route("/hello/<name>")
def greet(name):
    # HTML文字列を返します。基本的な操作では外部テンプレートエンジンは不要です。
    return template("<h1>Hello, !</h1>", name=name)

if __name__ == "__main__":
    # debug=True と共に自動リロードは、開発中に便利です。
    app.run(host="127.0.0.1", port=8080, debug=True, reloader=True)

7 リクエストパラメータとクエリ文字列

Bottleはルートパラメータを関数引数として渡し、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、ステータスコード

POSTされたJSONを処理し、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 静的ファイルと基本的なテンプレート

フォルダから静的アセットを配信し、Bottleの組み込みSimpleTemplateエンジンを使用します:

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

app = Bottle()

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

templates/index.tpl を作成し、内容を <% title = "Index" %> ... とし、ファイルを使いたい場合は template("index", title="Index") でレンダリングします。

10 素早いテスト

curl を使用して、ターミナルを離れずにレスポンスを確認します:

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 次のステップ

ここから、エラーハンドラー、ミドルウェア、ルートデコレータを追加します。プロダクションサーバー（gunicorn + uvicornワーカー）を接続するか、リバースプロキシの背後にデプロイします。小さく、速く保ちましょう。