コンポーネント＠Flask¶
はじめに¶
本サイトにつきまして、以下をご認識のほど宜しくお願いいたします。
01. App¶
Flaskクラス¶
▼ Flaskクラスとは¶
WSGIアプリケーションの実行に関するメソッドを持つ。
クラスの引数に、グローバル変数の『__name__』あるいはエントリーポイントのパスを直接的に設定する。
環境変数のFLASK_APPで指定したエントリーポイントでは、必ずFlaskクラスのインスタンスを作成する必要がある。
from flask import Flask
app = Flask(__name__)
# src/app.py
# app = Flask(src)
routeメソッド¶
▼ routeメソッド¶
Flaskクラスにエンドポイントを追加する。
from flask import Flask
app = Flask(__name__)
PREFIX_FOO = "foo"
@app.route("/{PREFIX}/show", methods=["GET"])
def show():
# DBへのアクセス処理
...
runメソッド¶
▼ runメソッドとは¶
設定されたルーティングを元に、Werkzeugによるwebサーバーを起動する。
開発環境のみで推奨される方法である。
from flask import Flask
app = Flask(__name__)
PREFIX_FOO = "foo"
@app.route("/{PREFIX}/show", methods=["GET"])
def show():
# DBへのアクセス処理
app.run()
▼ 引数¶
| 引数 | 説明 |
|---|---|
debug |
エラーログをブラウザ上に表示するか否かを設定する。 |
host |
受信する通信のIPアドレスを設定する。全てのIPアドレスの場合は、0.0.0.0とする。 |
load_dotenv |
dotenvパッケージを読み込むか否かを設定する。これを有効化すれば、他の引数は環境変数から設定できる。 |
port |
インバウンド通信を待ち受けるポート番号を設定する。 |
use_reloader |
ホットリロードを有効化するか否かを設定する。 |
02. 環境変数¶
App¶
▼ FLASK_APP¶
アプリケーションのエントリーポイントを設定する。
FLASK_APPの値 |
説明 |
|---|---|
module:name |
モジュール名 (ファイル名) とインスタンス名を設定する。 |
module:function() |
モジュール名 (ファイル名) と関数名を設定する。 |
module |
モジュール名 (ファイル名) を設定する。 |
file.py |
ファイル名を設定する。 |
03. ベストプラクティス¶
アプリケーションファクトリーパターン¶
▼ アプリケーションファクトリーパターンとは¶
Pythonのコードを配置するディレクトリに__init__.pyファイルを配置し、ここでFlaskクラスのインスタンスを作成するメソッドを定義する。
# __init__.py
from flask import Flask
def create_app():
app = Flask(__name__)
@app.route('/')
def index():
return 'Hello World'
return app
▼ エントリーポイント¶
プロジェクトのルートディレクトリに、create_appメソッドを実行するエントリーポイント (例：main.pyファイル) を配置する。
名前空間を判定する条件分の外でcreate_appメソッドを実行しないと、uwsgiがapp変数を見つけられない。
from src import create_app
app = create_app()
if __name__ == '__main__':
app.run()
▼ 開発環境と本番環境の違い¶
本番環境では、アプリケーションの実行にrun関数とflask runコマンドを使用しないようにする。
代わりとして、uWSGIやgunicornを使用して、エントリーポイントの関数を直接的にコールする。
本番環境と開発環境を同様にするために、本番環境のみでなく開発環境でもコマンドを使用しないようにしても良い。