feat: generate Pydantic v2 models from OpenAPI spec

Author: jackharrhy

justfile

@@ -1,6 +1,8 @@
+stackcoin_root := env("STACKCOIN_ROOT", "../StackCoin")
+
 generate:
   datamodel-codegen \
-    --input ../../openapi.json \
+    --input {{stackcoin_root}}/openapi.json \
     --input-file-type openapi \
     --output-model-type pydantic_v2.BaseModel \
     --output stackcoin/stackcoin/models.py \

stackcoin/stackcoin/models.py

@@ -0,0 +1,176 @@
+# generated by datamodel-codegen:
+#   filename:  openapi.json
+#   timestamp: 2026-03-05T03:46:00+00:00
+
+from __future__ import annotations
+
+from pydantic import AwareDatetime, BaseModel, Field
+
+
+class CreateRequestParams(BaseModel):
+    amount: int = Field(..., description="Amount of STK to request")
+    label: str | None = Field(None, description="Optional request label")
+
+
+class Requester(BaseModel):
+    id: int | None = Field(None, description="Requester user ID")
+    username: str | None = Field(None, description="Requester username")
+
+
+class Responder(BaseModel):
+    id: int | None = Field(None, description="Responder user ID")
+    username: str | None = Field(None, description="Responder username")
+
+
+class CreateRequestResponse(BaseModel):
+    amount: int = Field(..., description="Requested amount")
+    request_id: int = Field(..., description="Created request ID")
+    requested_at: AwareDatetime = Field(..., description="Request timestamp")
+    requester: Requester
+    responder: Responder
+    status: str = Field(..., description="Request status")
+    success: bool = Field(..., description="Whether the operation succeeded")
+
+
+class DiscordGuild(BaseModel):
+    designated_channel_snowflake: str | None = Field(
+        None, description="Designated channel snowflake ID"
+    )
+    id: int = Field(..., description="Guild ID")
+    last_updated: AwareDatetime = Field(..., description="Last updated timestamp")
+    name: str = Field(..., description="Guild name")
+    snowflake: str = Field(..., description="Discord guild snowflake ID")
+
+
+class DiscordGuildResponse(BaseModel):
+    designated_channel_snowflake: str | None = Field(
+        None, description="Designated channel snowflake ID"
+    )
+    id: int = Field(..., description="Guild ID")
+    last_updated: AwareDatetime = Field(..., description="Last updated timestamp")
+    name: str = Field(..., description="Guild name")
+    snowflake: str = Field(..., description="Discord guild snowflake ID")
+
+
+class Pagination(BaseModel):
+    limit: int | None = Field(None, description="Items per page")
+    page: int | None = Field(None, description="Current page")
+    total: int | None = Field(None, description="Total items")
+    total_pages: int | None = Field(None, description="Total pages")
+
+
+class DiscordGuildsResponse(BaseModel):
+    guilds: list[DiscordGuild] | None = Field(None, description="The guilds list")
+    pagination: Pagination | None = None
+
+
+class ErrorResponse(BaseModel):
+    error: str = Field(..., description="Error message")
+
+
+class Request(BaseModel):
+    amount: int = Field(..., description="Requested amount")
+    id: int = Field(..., description="Request ID")
+    label: str | None = Field(None, description="Request label")
+    requested_at: AwareDatetime = Field(..., description="Request timestamp")
+    requester: Requester
+    resolved_at: AwareDatetime | None = Field(None, description="Resolution timestamp")
+    responder: Responder
+    status: str = Field(..., description="Request status")
+    transaction_id: int | None = Field(None, description="Associated transaction ID")
+
+
+class RequestActionResponse(BaseModel):
+    request_id: int = Field(..., description="Request ID")
+    resolved_at: AwareDatetime = Field(..., description="Resolution timestamp")
+    status: str = Field(..., description="New request status")
+    success: bool = Field(..., description="Whether the operation succeeded")
+    transaction_id: int | None = Field(None, description="Associated transaction ID")
+
+
+class RequestResponse(BaseModel):
+    amount: int = Field(..., description="Requested amount")
+    id: int = Field(..., description="Request ID")
+    label: str | None = Field(None, description="Request label")
+    requested_at: AwareDatetime = Field(..., description="Request timestamp")
+    requester: Requester
+    resolved_at: AwareDatetime | None = Field(None, description="Resolution timestamp")
+    responder: Responder
+    status: str = Field(..., description="Request status")
+    transaction_id: int | None = Field(None, description="Associated transaction ID")
+
+
+class RequestsResponse(BaseModel):
+    pagination: Pagination | None = None
+    requests: list[Request] | None = Field(None, description="The requests list")
+
+
+class SendStkParams(BaseModel):
+    amount: int = Field(..., description="Amount of STK to send")
+    label: str | None = Field(None, description="Optional transaction label")
+
+
+class SendStkResponse(BaseModel):
+    amount: int = Field(..., description="Amount sent")
+    from_new_balance: int = Field(..., description="Sender's new balance")
+    success: bool = Field(..., description="Whether the operation succeeded")
+    to_new_balance: int = Field(..., description="Recipient's new balance")
+    transaction_id: int = Field(..., description="Created transaction ID")
+
+
+class From(BaseModel):
+    id: int | None = Field(None, description="From user ID")
+    username: str | None = Field(None, description="From username")
+
+
+class To(BaseModel):
+    id: int | None = Field(None, description="To user ID")
+    username: str | None = Field(None, description="To username")
+
+
+class Transaction(BaseModel):
+    amount: int = Field(..., description="Transaction amount")
+    from_: From = Field(..., alias="from")
+    id: int = Field(..., description="Transaction ID")
+    label: str | None = Field(None, description="Transaction label")
+    time: AwareDatetime = Field(..., description="Transaction timestamp")
+    to: To
+
+
+class TransactionResponse(BaseModel):
+    amount: int = Field(..., description="Transaction amount")
+    from_: From = Field(..., alias="from")
+    id: int = Field(..., description="Transaction ID")
+    label: str | None = Field(None, description="Transaction label")
+    time: AwareDatetime = Field(..., description="Transaction timestamp")
+    to: To
+
+
+class TransactionsResponse(BaseModel):
+    pagination: Pagination | None = None
+    transactions: list[Transaction] | None = Field(None, description="The transactions list")
+
+
+class User(BaseModel):
+    admin: bool = Field(..., description="Whether user is an admin")
+    balance: int = Field(..., description="User's STK balance")
+    banned: bool = Field(..., description="Whether user is banned")
+    id: int | None = Field(None, description="User ID")
+    inserted_at: AwareDatetime | None = Field(None, description="Creation timestamp")
+    updated_at: AwareDatetime | None = Field(None, description="Update timestamp")
+    username: str = Field(..., description="Username")
+
+
+class UserResponse(BaseModel):
+    admin: bool = Field(..., description="Whether user is an admin")
+    balance: int = Field(..., description="User's STK balance")
+    banned: bool = Field(..., description="Whether user is banned")
+    id: int | None = Field(None, description="User ID")
+    inserted_at: AwareDatetime | None = Field(None, description="Creation timestamp")
+    updated_at: AwareDatetime | None = Field(None, description="Update timestamp")
+    username: str = Field(..., description="Username")
+
+
+class UsersResponse(BaseModel):
+    pagination: Pagination | None = None
+    users: list[User] | None = Field(None, description="The users list")