feat(storage): expose a path to access local storage

app/config.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from enum import Enum
 from typing import Annotated, Any
 
-from pydantic import Field, ValidationInfo, field_validator
+from pydantic import Field, HttpUrl, ValidationInfo, field_validator
 from pydantic_settings import BaseSettings, NoDecode, SettingsConfigDict
 
 
@@ -65,6 +65,7 @@ class Settings(BaseSettings):
     port: int = 8000
     debug: bool = False
     private_api_secret: str = "your_private_api_secret_here"
+    server_url: HttpUrl = HttpUrl("http://localhost:8000")
 
     # SignalR 设置
     signalr_negotiate_timeout: int = 30
@@ -74,7 +75,10 @@ class Settings(BaseSettings):
     fetcher_client_id: str = ""
     fetcher_client_secret: str = ""
     fetcher_scopes: Annotated[list[str], NoDecode] = ["public"]
-    fetcher_callback_url: str = "http://localhost:8000/fetcher/callback"
+
+    @property
+    def fetcher_callback_url(self) -> str:
+        return f"{self.server_url}fetcher/callback"
 
     # 日志设置
     log_level: str = "INFO"

app/router/__init__.py

@@ -4,6 +4,7 @@ from app.signalr import signalr_router as signalr_router
 
 from .auth import router as auth_router
 from .fetcher import fetcher_router as fetcher_router
+from .file import file_router as file_router
 from .private import private_router as private_router
 from .v2.router import router as api_v2_router
 
@@ -11,6 +12,7 @@ __all__ = [
     "api_v2_router",
     "auth_router",
     "fetcher_router",
+    "file_router",
     "private_router",
     "signalr_router",
 ]

app/router/file.py

@@ -0,0 +1,26 @@
+from __future__ import annotations
+
+from app.dependencies.storage import get_storage_service
+from app.storage import LocalStorageService, StorageService
+
+from fastapi import APIRouter, Depends, HTTPException
+from fastapi.responses import FileResponse
+
+file_router = APIRouter(prefix="/file")
+
+
+@file_router.get("/{path:path}")
+async def get_file(path: str, storage: StorageService = Depends(get_storage_service)):
+    if not isinstance(storage, LocalStorageService):
+        raise HTTPException(404, "Not Found")
+    if not await storage.is_exists(path):
+        raise HTTPException(404, "Not Found")
+
+    try:
+        return FileResponse(
+            path=storage._get_file_path(path),
+            media_type="application/octet-stream",
+            filename=path.split("/")[-1],
+        )
+    except FileNotFoundError:
+        raise HTTPException(404, "Not Found")

app/router/v2/__init__.py

@@ -1,7 +1,5 @@
 from __future__ import annotations
 
-from app.signalr import signalr_router as signalr_router
-
 from . import (  # pyright: ignore[reportUnusedImport]  # noqa: F401
     beatmap,
     beatmapset,

app/storage/local.py

@@ -2,6 +2,8 @@ from __future__ import annotations
 
 from pathlib import Path
 
+from app.config import settings
+
 from .base import StorageService
 
 import aiofiles
@@ -75,4 +77,4 @@ class LocalStorageService(StorageService):
         return full_path.exists() and full_path.is_file()
 
     async def get_file_url(self, file_path: str) -> str:
-        return str(self.storage_path / file_path)
+        return f"{settings.server_url}file/{file_path.lstrip('/')}"