Add AllCoffeeDonations schema.

app/donations/__init__.py

@@ -7,7 +7,7 @@
 from database import get_db
 from database.crud import create_donation, get_donation
 from database.models import Donation
-from database.schemas import NewDonation
+from database.schemas import CoffeeDonation, AllCoffeeDonations
 
 router = APIRouter(prefix="/donation", tags=["donations"])
 
@@ -16,9 +16,9 @@
     "/",
     summary="New BuyMeACoffee donation",
     description="Save record of new donation to persistent ledger.",
-    response_model=NewDonation,
+    response_model=CoffeeDonation,
 )
-async def accept_donation(donation: NewDonation, db: Session = Depends(get_db)) -> NewDonation:
+async def accept_donation(donation: CoffeeDonation, db: Session = Depends(get_db)) -> CoffeeDonation:
     """
     Save BuyMeACoffee donation to database.
 
@@ -40,9 +40,9 @@ async def accept_donation(donation: NewDonation, db: Session = Depends(get_db))
     "/",
     summary="Delete BuyMeACoffee donation record",
     description="Delete BuyMeACoffee donation transaction by ID.",
-    response_model=NewDonation,
+    response_model=CoffeeDonation,
 )
-async def delete_donation(donation: NewDonation, db: Session = Depends(get_db)) -> NewDonation:
+async def delete_donation(donation: CoffeeDonation, db: Session = Depends(get_db)) -> CoffeeDonation:
     """
     Delete BuyMeACoffee donation from database.
 
@@ -60,10 +60,7 @@ async def delete_donation(donation: NewDonation, db: Session = Depends(get_db))
     return create_donation(db, donation)
 
 
-@router.get(
-    "/",
-    summary="Get all existing donations.",
-)
+@router.get("/", summary="Get all existing donations.", response_model=AllCoffeeDonations)
 async def get_donations(db: Session = Depends(get_db)):
     """
     Test endpoint for fetching comments joined with user info.

database/crud.py

@@ -6,11 +6,11 @@
 from sqlalchemy.orm import Session
 
 from database.models import Account, Donation
-from database.schemas import NewDonation
+from database.schemas import CoffeeDonation
 from log import LOGGER
 
 
-def get_donation(db: Session, donation: NewDonation) -> Optional[NewDonation]:
+def get_donation(db: Session, donation: CoffeeDonation) -> Optional[CoffeeDonation]:
     """
     Fetch BuyMeACoffee donation by ID.
 
@@ -26,7 +26,7 @@ def get_donation(db: Session, donation: NewDonation) -> Optional[NewDonation]:
     return None
 
 
-def create_donation(db: Session, donation: NewDonation) -> Donation:
+def create_donation(db: Session, donation: CoffeeDonation) -> Donation:
     """
     Create new BuyMeACoffee donation record.
 

database/schemas.py

@@ -6,7 +6,7 @@
 from pydantic import BaseModel, EmailStr, Field
 
 
-class NewDonation(BaseModel):
+class CoffeeDonation(BaseModel):
     """`BuyMeACoffee` donation."""
 
     # fmt: off
@@ -24,11 +24,39 @@ class Config:
             "email": "fake@example.com",
             "count": 1,
             "message": "Great tutorials but this is a test message.",
-            "link": "https://buymeacoffee.com/hackersslackers",
+            "link": "https://buymeacoffee.com/hackersslackers/c/405127",
             "coffee_id": 405127,
         }
 
 
+class AllCoffeeDonations(BaseModel):
+    """All `BuyMeACoffee` donations."""
+
+    # fmt: off
+    all_donations: List[CoffeeDonation]
+    # fmt: on
+
+    class Config:
+        json_schema_extra = [
+            {
+                "name": "Fake Todd",
+                "email": "fake@example.com",
+                "count": 1,
+                "message": "Great tutorials but this is a test message.",
+                "link": "https://buymeacoffee.com/hackersslackers/c/100000",
+                "coffee_id": 100000,
+            },
+            {
+                "name": "Firstname Lastname",
+                "email": "firstname.lastname@example.com",
+                "count": 2,
+                "message": "Thank you for the tutorials!",
+                "link": "https://buymeacoffee.com/hackersslackers/c/100001",
+                "coffee_id": 100001,
+            },
+        ]
+
+
 class NewComment(BaseModel):
     """User comment on a post."""