【python】FastAPIのフォルダ構成など

こんにちは。

FastAPIを使ってみました。
公式サイトにあるように、下記コードを作成後、uvicorn main:app --reloadを実行して、動作確認いたしました。

python
1from fastapi import FastAPI
2
3app = FastAPI()
4
5
6@app.get("/")
7def read_root():
8    return {"Hello": "World"}
9
10
11@app.get("/items/{item_id}")
12def read_item(item_id: int, q: str = None):
13    return {"item_id": item_id, "q": q}

基本的な質問で申し訳ないのですが、これはリクエスト用のurlは１つのファイルに複数書いていくということで宜しいでしょうか。
uvicornで指定するモジュールが１つだけの様なので。
（それとも、ファイルの中で自分でクラス分けしていくとか？）
その辺りの、簡単なファイル - フォルダ構成などを教えて頂けると有難いです。
あと、参考になりそうなコードなどあれば。。

PydanticやSQLAlchemy（？）なども組み合わせて使用するのが、一般的と言うことで宜しいでしょうか。

質問が多くなりまして、申し訳ございません。
java servletだと、１つのファイルに1urlが一般的だった様な気がしたので。。

宜しくお願い致します。

行動規範の内容に同意します

回答1件

ベストアンサー

基本的な質問で申し訳ないのですが、これはリクエスト用のurlは１つのファイルに複数書いていくということで宜しいでしょうか。

はい、とも言えるし、いいえ、とも言えます。

FastAPIは同じPythonで有名なDjangoや、JavaだとSpringフレームワークのようにガチガチに構成が決まっているわけではありません。
自分で好きな構成にできるため、宜しいでしょうか？と聞かれたら、答えは「よろしくもあるし、よろしくなくもある」ということになります。
が、Bigger Applications - Multiple Filesを見ると、「If you are building an application or a web API, it's rarely the case that you can put everything on a single file.」(機械翻訳：アプリケーションまたはWebAPIを構築している場合、すべてを1つのファイルに入れることができることはめったにありません。)と書いてありますので、ファイルを分ける方が一般的です。
個人的には1ファイルに全部書くとわかりにくいと思うので、分けた方が無難だと思います。

その辺りの、簡単なファイル - フォルダ構成などを教えて頂けると有難いです。

探しましたが無いですね。
FastAPIはFlaskやらをより便利にするよう進化したもので、だいたいFlaskと同じなので、Flaskのディレクトリ構造が使えると思います。

古いですが、以下のサイトが参考になると思います。
【Flask】ディレクトリ構成を考える

有名なところだと、templates, static, viewsは1つでその中に全部入れるのと、
application(機能：ログイン機能とかユーザ管理機能とか)をディレクトリ1個にまとめて配置する方法
の2個の配置方法があった気がします。
私は前者ばかり使います(Flaskは実装の都合でなんか面倒なので)が、Djangoは後者だったと思います。