revanced-api/api/donations.py

"""
This module provides a blueprint for the donations endpoint.

Routes:
    - GET /donations: Get ReVanced donation links and wallets.
"""

from sanic import Blueprint, Request
from sanic.response import JSONResponse, json
from sanic_ext import openapi

from api.models.donations import DonationsResponseModel
from config import donation_info, api_version

donations: Blueprint = Blueprint("donations", version=api_version)


@donations.get("/donations")
@openapi.definition(
    summary="Get ReVanced donation links and wallets",
    response=[DonationsResponseModel],
)
async def root(request: Request) -> JSONResponse:
    """
    Returns a JSONResponse with a dictionary containing ReVanced donation links and wallets.

    **Returns:**
        - JSONResponse: A Sanic JSONResponse instance containing a dictionary with the donation links and wallets.
    """
    data: dict[str, dict] = {"donations": donation_info}
    return json(data, status=200)