Add minimal Python API deployable with Next/Vercel

.env

@@ -0,0 +1 @@
+PYTHONPATH=apps/api/src

.gitignore

@@ -34,3 +34,6 @@ yarn-error.log*
 
 # vercel
 .vercel
+
+# Python
+.venv

.vscode/settings.json

@@ -1,7 +1,9 @@
 {
-  "eslint.workingDirectories": [
-    {
-      "mode": "auto"
-    }
-  ]
+	"eslint.workingDirectories": [
+		{
+			"mode": "auto"
+		}
+	],
+	"python.envFile": "${workspaceFolder}/.env",
+	"python.defaultInterpreterPath": ".venv/bin/python",
 }

apps/api/.gitignore

@@ -0,0 +1 @@
+__pycache__

apps/api/README.md

@@ -0,0 +1,19 @@
+# IrvineHacks Site API
+
+This "app" contains the source code for the backend API used by the site.
+
+## Local Development
+
+For local development, run
+
+```shell
+python src/dev.py
+```
+
+which will start a Uvicorn server with auto-reload.
+
+## Deployment Configuration
+
+For deployment, the following environment variables need to be set:
+
+-   `PYTHONPATH=src/api` to properly import Python modules

apps/api/index.py

@@ -0,0 +1,12 @@
+import logging
+
+from fastapi import FastAPI
+
+from app import app as api
+
+# Override AWS Lambda logging configuration
+logging.basicConfig(level=logging.INFO, force=True)
+
+# This ASGI app is used by Vercel as a Serverless Function
+app = FastAPI()
+app.mount("/api", api)

apps/api/package.json

@@ -0,0 +1,7 @@
+{
+	"name": "api",
+	"private": true,
+	"scripts": {
+		"dev": "python src/dev.py"
+	}
+}

apps/api/requirements-dev.txt

@@ -0,0 +1 @@
+uvicorn[standard]==0.23.2

apps/api/requirements.txt

@@ -0,0 +1 @@
+fastapi==0.104.1

apps/api/src/app.py

@@ -0,0 +1,8 @@
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+async def root() -> dict[str, str]:
+    return {"message": "hello"}

apps/api/src/dev.py

@@ -0,0 +1,10 @@
+import uvicorn
+
+if __name__ == "__main__":
+    uvicorn.run(
+        "app:app",
+        log_level="info",
+        access_log=True,
+        use_colors=True,
+        reload=True,
+    )

apps/site/api/index.py

@@ -0,0 +1,5 @@
+"""
+This is an empty source file necessary for Vercel to recognize the existence of
+the Serverless Function for the backend API as defined in `vercel.json`.
+The contents will be replaced by that of `apps/api/index.py` during Turbo build.
+"""

apps/site/copy-api.sh

@@ -0,0 +1,4 @@
+# Copy API files from apps/api
+cp -R ../api/requirements.txt .
+cp -R ../api/src/ src/api/
+cp ../api/index.py api/index.py

apps/site/vercel.json

@@ -0,0 +1,11 @@
+{
+	"buildCommand": "cd ../.. && turbo run build --filter={apps/site} && cd apps/site && ./copy-api.sh",
+	"rewrites": [{ "source": "/api/(.*)", "destination": "api/index.py" }],
+	"functions": {
+		"api/index.py": {
+			"memory": 512,
+			"maxDuration": 10,
+			"excludeFiles": "{*.{js,ts,json},@(.next|.turbo|node_modules|public)/**,src/{*,!(api)/**}}"
+		}
+	}
+}

turbo.json

@@ -1,15 +1,15 @@
 {
-  "$schema": "https://turbo.build/schema.json",
-  "globalDependencies": ["**/.env.*local"],
-  "pipeline": {
-    "build": {
-      "dependsOn": ["^build"],
-      "outputs": [".next/**", "!.next/cache/**"]
-    },
-    "lint": {},
-    "dev": {
-      "cache": false,
-      "persistent": true
-    }
-  }
+	"$schema": "https://turbo.build/schema.json",
+	"globalDependencies": ["**/.env.*local"],
+	"pipeline": {
+		"build": {
+			"dependsOn": ["^build"],
+			"outputs": [".next/**", "!.next/cache/**"]
+		},
+		"lint": {},
+		"dev": {
+			"cache": false,
+			"persistent": true
+		}
+	}
 }