Merge branch '2025-project'

Author: egges

2025/project/.env.example

@@ -0,0 +1,2 @@
+db_user=your_db_user
+db_password=your_db_password

2025/project/.python-version

@@ -0,0 +1 @@
+3.13

2025/project/Dockerfile

@@ -0,0 +1,24 @@
+FROM python:3.13-slim-bookworm
+
+RUN apt-get update && apt-get install --no-install-recommends -y \
+        build-essential && \
+    apt-get clean && rm -rf /var/lib/apt/lists/*
+
+ADD https://astral.sh/uv/install.sh /install.sh
+RUN chmod -R 755 /install.sh && /install.sh && rm /install.sh
+
+# Set up the UV environment path correctly
+ENV PATH="/root/.local/bin:${PATH}"
+
+WORKDIR /app
+
+COPY . .
+
+RUN uv sync
+
+ENV PATH="/app/.venv/bin:{$PATH}"
+
+# Expose the specified port for FastAPI
+EXPOSE $PORT
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]

2025/project/README.md

@@ -0,0 +1,39 @@
+Starting the server:
+
+uv run uvicorn app.main:app --reload
+
+Example requests:
+
+Here’s a set of simple curl examples you can use to interact with your FastAPI app once it’s running (default at http://localhost:8000):
+
+1️⃣ Create a User
+
+curl -X POST "http://localhost:8000/api/v1/users" \
+     -H "Content-Type: application/json" \
+     -d '{"name": "Ada Lovelace"}'
+
+
+2️⃣ Get All Users
+
+curl -X GET "http://localhost:8000/api/v1/users"
+
+
+3️⃣ Get a User by ID
+
+(Replace 1 with the actual ID from the create response)
+
+curl -X GET "http://localhost:8000/api/v1/users/1"
+
+
+4️⃣ Update a User
+
+curl -X PUT "http://localhost:8000/api/v1/users/1" \
+     -H "Content-Type: application/json" \
+     -d '{"name": "Grace Hopper"}'
+
+
+⸻
+
+5️⃣ Delete a User
+
+curl -X DELETE "http://localhost:8000/api/v1/users/1"

2025/project/app/api/v1/user.py

@@ -0,0 +1,47 @@
+from fastapi import APIRouter, Depends, HTTPException
+
+from app.db.schema import SessionLocal
+from app.models.user import UserCreate, UserRead
+from app.services.user_service import UserService
+
+router = APIRouter()
+
+
+def get_user_service() -> UserService:
+    return UserService(session=SessionLocal())
+
+
+@router.get("/users", response_model=list[UserRead])
+def get_users(service: UserService = Depends(get_user_service)):
+    return service.list_users()
+
+
+@router.post("/users", response_model=UserRead)
+def create_user(user: UserCreate, service: UserService = Depends(get_user_service)):
+    return service.create_user(user.name)
+
+
+@router.get("/users/{user_id}", response_model=UserRead)
+def get_user(user_id: int, service: UserService = Depends(get_user_service)):
+    user = service.get_user(user_id)
+    if not user:
+        raise HTTPException(status_code=404, detail="User not found")
+    return user
+
+
+@router.put("/users/{user_id}", response_model=UserRead)
+def update_user(
+    user_id: int, user: UserCreate, service: UserService = Depends(get_user_service)
+):
+    updated = service.update_user(user_id, user.name)
+    if not updated:
+        raise HTTPException(status_code=404, detail="User not found")
+    return updated
+
+
+@router.delete("/users/{user_id}")
+def delete_user(user_id: int, service: UserService = Depends(get_user_service)):
+    success = service.delete_user(user_id)
+    if not success:
+        raise HTTPException(status_code=404, detail="User not found")
+    return {"success": True}

2025/project/app/core/config.py

@@ -0,0 +1,19 @@
+from dotenv import load_dotenv
+from pydantic_settings import BaseSettings
+
+load_dotenv()
+
+
+class Config(BaseSettings):
+    app_name: str = "ScalableFastAPIProject"
+    debug: bool = False
+    db_user: str = ""
+    db_password: str = ""
+    db_name: str = "test.db"
+
+    @property
+    def db_url(self):
+        return f"sqlite:///./{self.db_name}"
+
+
+config = Config()

2025/project/app/core/logging.py

@@ -0,0 +1,7 @@
+import logging
+
+def setup_logging():
+    logging.basicConfig(
+        level=logging.INFO,
+        format="%(asctime)s %(levelname)s [%(name)s] %(message)s"
+    )

2025/project/app/db/schema.py

@@ -0,0 +1,18 @@
+from sqlalchemy import String, create_engine
+from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, sessionmaker
+
+from app.core.config import config
+
+engine = create_engine(config.db_url, connect_args={"check_same_thread": False})
+SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+class User(Base):
+    __tablename__ = "users"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    name: Mapped[str] = mapped_column(String, index=True)

2025/project/app/main.py

@@ -0,0 +1,15 @@
+from fastapi import FastAPI
+
+from app.api.v1 import user
+from app.core.config import config
+from app.core.logging import setup_logging
+from app.db.schema import Base, engine
+
+setup_logging()
+Base.metadata.create_all(bind=engine)
+
+app = FastAPI(title=config.app_name)
+
+
+# Register routes
+app.include_router(user.router, prefix="/api/v1")

2025/project/app/models/user.py

@@ -0,0 +1,10 @@
+from pydantic import BaseModel
+
+
+class UserCreate(BaseModel):
+    name: str
+
+
+class UserRead(BaseModel):
+    id: int
+    name: str