Merge branch 'main' of github.com:HackAtUCI/irvinehacks-site-2024 int…

…o setup/about

.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