<h2>はじめに</h2>
<p>Python ベースの Web マイクロフレームワークの一つ、<a href="https://fastapi.tiangolo.com/ja/">FastAPI</a>で API を作る機会があり、開発体験が良かったのでその感想です。</p>
<h2>良かった点</h2>
<h3>シンプルな設計</h3>
<p>大規模アプリケーションでなく、モック API や簡単な RESTful API を作るなどといった、ちょっとした用途でアプリケーションを作る場合は、<strong>できれば最小限のファイル・ディレクトリで構成したい</strong>というのが個人的な好みです。</p>
<p>例えば<a href="https://spring.io/projects/spring-boot">Spring Boot</a>でアプリケーションを作る場合、jvm 言語特有で「最初のプロジェクトから、複数のパッケージとファイルで構成されている」のですが、<code>FastAPI</code>では言ってしまえば、1 ファイルでアプリケーションを実行できます。<code>Node.js</code>の Web フレームワーク<a href="https://expressjs.com/ja/">Express</a>みたいに構成できるので嬉しいです。</p>
<p>例：GET リクエストを受け取るのみの API を作る場合、1 ファイルのみで以下のようにコードを記述するだけで OK</p>
<pre><code class="language-python">from fastapi import FastAPI, Query
from fastapi.responses import JSONResponse

app = FastAPI()

@app.get(&quot;/hoge&quot;)
def getHoge(id: str = Query(...)) -&gt; JSONResponse:
  # ここでクエリパラメータを受け取り、レスポンスを作る
  # jsonでレスポンスを返す
  return JSONResponse(status_code=200, content={&quot;body&quot;: &quot;hoge&quot;})
</code></pre>
<h3>直感的な理解のしやすさ</h3>
<p>アノテーションベースでリクエストハンドラーを書けるので、ぱっと見で何をやっているのか理解しやすいです。実際に上で書いたサンプルコードをみて、「<code>hoge</code>というエンドポイントに<code>id</code>というパラメータがついた URI でコールされたとき、中身 json で 200 のレスポンスが返る」と理解はできますよね。（引数<code>id</code>がクエリパラメータとぱっと見でわかるかどうかは、<code>Spring</code>や<code>NestJS</code>で書いたことがあるかによりそうな気がしないこともないが。。自分は<code>Spring</code>を業務で使っているのでスッと腑に落ちました）</p>
<h3>Pydantic との組み合わせることで受けられる恩恵の大きさ</h3>
<p><a href="https://pydantic-docs.helpmanual.io/">Pydantic</a>と<code>FastAPI</code>を組み合わせることで、</p>
<ul>
<li>型アノテーションを使用することで、バリデーション・シリアライズが容易</li>
<li><code>OpenAPI</code>スキーマの自動生成により、仕様書作成が容易</li>
</ul>
<p>が簡単に実現できます。特にリクエストボディに対して、バリデーション機構をスクラッチから書くことなく<code>Pydantic</code>の<code>BaseModel</code>と<code>FastAPI</code>の<code>Query</code>の組み合わせでかけるのはすごく楽。。</p>
<p>また、自動生成された<code>OpenAPI</code>スキーマを<a href="https://swagger.io/tools/swagger-ui/">SwaggerUI</a>・<a href="https://redocly.github.io/redoc/">Redoc</a>でドキュメント化できるのもクールです！！（当然 description など全てコード内に書いてあげる必要はありますが）</p>
<h2>最後に</h2>
<p>機械学習のモデルを利用した API や簡単なモックを作る必要があるときは<code>FastAPI</code>を採用したいです。<code>FastAPI</code>はいいぞ。</p>
<p>というかまず<code>Python</code>が型アノテーションの追加などでさらに書きやすくなってて嬉しかったです！久々書いてて「これよこれ」と実家に帰った感覚がありました。</p>
<p><code>FastAPI</code>は現在いまだにバージョン 0.X.X の状態なので、開発が本当に盛んです。ぜひ興味があればコントリビュートしてみてはいかがでしょうか！！</p>


# FastAPI

FastAPIの開発体験が良かった話