setup FastAPI server

Author: ks6088ts

Makefile

@@ -58,7 +58,7 @@ jupyterlab: ## run Jupyter Lab
 # ---
 DOCKER_REPO_NAME ?= ks6088ts
 DOCKER_IMAGE_NAME ?= template-fastapi
-DOCKER_COMMAND ?=
+DOCKER_COMMAND ?= fastapi run main.py --help
 
 # Tools
 TOOLS_DIR ?= /usr/local/bin
@@ -103,3 +103,20 @@ docs-serve: ## serve documentation
 
 .PHONY: ci-test-docs
 ci-test-docs: docs ## run CI test for documentation
+
+# ---
+# Project
+# ---
+
+.PHONY: run
+run: ## run FastAPI server
+	uv run fastapi run main.py \
+		--host 0.0.0.0 \
+		--port 8000
+
+.PHONY: dev
+dev: ## run FastAPI server in development mode
+	uv run fastapi dev main.py \
+		--host 0.0.0.0 \
+		--port 8000 \
+		--reload

docs/index.md

@@ -1 +1,5 @@
 # template-fastapi
+
+## FastAPI
+
+- [FastAPI](https://fastapi.tiangolo.com/)

main.py

@@ -0,0 +1,13 @@
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: str | None = None):
+    return {"item_id": item_id, "q": q}

pyproject.toml

@@ -4,7 +4,9 @@ version = "0.0.1"
 description = "A GitHub template repository for Python"
 readme = "README.md"
 requires-python = ">=3.10"
-dependencies = []
+dependencies = [
+    "fastapi[standard]>=0.115.12",
+]
 
 [project.optional-dependencies]
 docs = [