コンテンツにスキップ

デバッグ

Visual Studio CodeやPyCharmなどを使用して、エディター上でデバッガーと連携できます。

uvicorn の実行

FastAPIアプリケーション上で、uvicorn を直接インポートして実行します:

import uvicorn
from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def root():
    a = "a"
    b = "b" + a
    return {"hello world": b}


if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8000)

__name__ == "__main__" について

__name__ == "__main__" の主な目的は、ファイルが次のコマンドで呼び出されたときに実行されるコードを用意することです:

$ python myapp.py

ただし、次のように、別のファイルからインポートされるときには呼び出されません:

from myapp import app

より詳しい説明

ファイルの名前が myapp.py だとします。

以下の様に実行する場合:

$ python myapp.py

Pythonによって自動的に作成されたファイル内の内部変数 __name__ は、値として文字列 "__main__" を持ちます。

なので、以下:

    uvicorn.run(app, host="0.0.0.0", port=8000)

は実行されます。


そのモジュール (ファイル) をインポートした場合は、こうはなりません。

したがって、次のようなもう一つのファイル importer.py がある場合:

from myapp import app

# Some more code

myapp.py 内の自動変数には、値が "__main __" の変数 __name__ はありません。

したがって、以下の行:

    uvicorn.run(app, host="0.0.0.0", port=8000)

は実行されません。

情報

より詳しい情報は、公式Pythonドキュメントを参照してください。

デバッガーでコードを実行

コードから直接Uvicornサーバーを実行しているため、デバッガーから直接Pythonプログラム (FastAPIアプリケーション) を呼び出せます。


例えば、Visual Studio Codeでは、次のことが可能です:

  • 「デバッグ」パネルに移動。
  • 「構成の追加...」
  • 「Python」を選択。
  • オプション「Python: Current File (Integrated Terminal)」を指定してデバッガーを実行。

すると、FastAPI コードでサーバーが起動され、ブレークポイントで停止したりするでしょう。

以下の様な画面になります:


Pycharmを使用する場合、次のことが可能です:

  • 「実行」メニューをオープン。
  • オプション「デバッグ...」を選択。
  • 次にコンテキストメニューが表示される。
  • デバッグするファイル (ここでは main.py) を選択。

すると、FastAPI コードでサーバーが起動され、ブレークポイントで停止したりするでしょう。

以下の様な画面になります: