adding a dummy fastapi app for now

Author: socraticDevBlog

backend/Dockerfile

@@ -0,0 +1,16 @@
+FROM python:3.13.3-slim
+
+WORKDIR /app
+
+COPY Pipfile Pipfile.lock ./
+COPY app ./app
+
+RUN pip install --no-cache-dir pipenv
+
+ENV PIPENV_VENV_IN_PROJECT=1
+
+RUN pipenv install --dev
+
+EXPOSE 8000
+
+CMD ["pipenv", "run", "uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]

backend/Pipfile

@@ -5,3 +5,6 @@ name = "pypi"
 
 [packages]
 fastapi = {extras = ["standard"], version = "*"}
+
+[dev-packages]
+black = "*"

backend/Pipfile.lock

@@ -1,7 +1,15 @@
 ![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=for-the-badge&logo=fastapi)
+
 # pastebin.backend
 
-## setup pipenv
+## dependencies management
+
+| tool                                                    | why                   |
+| ------------------------------------------------------- | --------------------- |
+| [pyenv](https://github.com/pyenv/pyenv)                 | manage python version |
+| [pipenv](https://docs.pipenv.org/en/latest/basics.html) | manage dependencies   |
+
+### setup pipenv
 
 when working on the fastapi backend, you want to be using the
 `/backend/Pipfile` with `pipenv`
@@ -17,3 +25,24 @@ export PIPENV_PIPFILE=$(pwd)/Pipfile
 export PIPENV_VENV_IN_PROJECT=1
 ```
 
+## run api in dev mode
+
+```
+pipenv run fastapi dev
+```
+
+## Docker
+
+build the image locally
+```
+docker build -t pastebin-backend .
+```
+
+run the container
+```
+docker run -p 8000:8000 pastebin-backend
+```
+
+FastAPI app is available on: [http://localhost:8000](http://localhost:8000)
+
+

backend/README.md

@@ -0,0 +1,15 @@
+from typing import Union
+
+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: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}