Merge pull request #95 from socraticDevBlog/20250418-fastapibackend

feature: new fastapi backend

Author: socraticDevBlog

backend/Pipfile

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

backend/Pipfile.lock

@@ -20,9 +20,6 @@ avoid trouble by setting up these two environment variable before using `pipenv`
 # tell pipenv to use the /backend/Pipfile
 export PIPENV_PIPFILE=$(pwd)/Pipfile
 
-# tell pipenv to create and use the .venv directory for virtual environment
-# in this directory here
-export PIPENV_VENV_IN_PROJECT=1
 ```
 
 ## run api in dev mode
@@ -34,15 +31,25 @@ 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)
 
+## API - locally
+
+use built-in swagger
+
+```
+pipenv run uvicorn app.main:app --reload
+```
 
+<http://127.0.0.1:8000/docs>

backend/README.md

@@ -1,15 +1,7 @@
-from typing import Union
-
 from fastapi import FastAPI
+from app.routes import router
 
 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}
+# Include the routes from the `routes.py` file
+app.include_router(router)

backend/app/__init__.py

@@ -0,0 +1 @@
+mock_db = {}

backend/app/main.py

@@ -0,0 +1,49 @@
+import time
+from typing import Optional
+
+from pydantic import BaseModel
+from app.utils import hash_value
+
+
+class PasteModel(BaseModel):
+    """
+    Paste model for creating and retrieving pastes
+    with FastAPI.
+
+    Attributes:
+        content (str): Content of the paste.
+        workspace (Optional[str]): Optional workspace identifier.
+    """
+
+    content: str
+    workspace: Optional[str]
+
+
+class PasteDataAware:
+    """
+    Paste data model for creating and retrieving pastes
+    with actual database
+
+    Attributes:
+        id (str): Unique identifier for the paste.
+        content (str): Content of the paste.
+        client_id (str): Identifier for the client creating the paste.
+        created_at (int): Timestamp of when the paste was created.
+    """
+
+    id: str
+    content: str
+    client_id: str
+    created_at: int
+
+    def __init__(
+        self,
+        content: str,
+        client_id: str,
+        created_at: Optional[int] = None,
+        id: str = None,
+    ):
+        self.id = hash_value(value=content) if id is None else id
+        self.content = content
+        self.client_id = client_id
+        self.created_at = int(time.time()) if created_at is None else created_at

backend/app/mock_db.py

@@ -0,0 +1,61 @@
+from typing import Optional
+from fastapi import APIRouter, HTTPException, Request
+
+from app.models import PasteModel, PasteDataAware
+from app.mock_db import mock_db
+
+router = APIRouter()
+
+
+@router.get("/api/v1/pastes")
+async def get_pastes(client_id: Optional[str] = None, request: Request = None):
+    """
+    GET /api/pastes
+    Retrieve pastes for a specific client.
+    """
+    if not client_id:
+        client_id = request.client.host  # Use client IP as fallback
+    client_pastes = [
+        paste for paste in mock_db.values() if paste.get("client_id") == client_id
+    ]
+    return {"pastes": client_pastes}
+
+
+@router.get("/api/v1/{id}")
+async def get_paste(id: str, request: Request):
+    """
+    GET /api/v1/{id}
+    Retrieve a specific paste by ID.
+    """
+    paste = mock_db.get(id)
+    if not paste:
+        raise HTTPException(status_code=404, detail="Paste not found")
+    user_agent = request.headers.get("User-Agent", "")
+    is_web_browser = "Mozilla" in user_agent or "AppleWebKit" in user_agent
+    return {"paste": paste, "is_web_browser": is_web_browser}
+
+
+@router.post("/api/v1")
+async def create_paste(paste: PasteModel, request: Request):
+    """
+    POST /api/v1
+    Create a new paste.
+    """
+    client_id = paste.workspace if paste.workspace != "" else request.client.host
+    data = PasteDataAware(content=paste.content, client_id=client_id)
+    mock_db[data.id] = {
+        "id": data.id,
+        "content": data.content,
+        "client_id": data.client_id,
+        "created_at": data.created_at,
+    }
+    return {"id": data.id}
+
+
+@router.options("/api/v1")
+async def options_api():
+    """
+    OPTIONS /api
+    Return allowed methods for the /api route.
+    """
+    return {"methods": ["GET", "POST", "OPTIONS"]}

backend/app/models.py

@@ -0,0 +1,9 @@
+import hashlib
+
+
+def hash_value(value: str, encoding: str = "utf-8") -> str:
+
+    value_bytes = str(value).encode(encoding=encoding)
+    hash_object = hashlib.md5()
+    hash_object.update(value_bytes)
+    return hash_object.hexdigest()