store-api-py 0.1.0__tar.gz → 0.2.0__tar.gz

{store_api_py-0.1.0 → store_api_py-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: store-api-py
-Version: 0.1.0
+Version: 0.2.0
 Summary: FastAPI adapter that auto-generates RESTful APIs for py-store schemas (schema-driven CRUD over GQL)
 License: MIT
 Keywords: py-store,storepy,fastapi,rest,crud,gql

{store_api_py-0.1.0 → store_api_py-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "store-api-py"
-version = "0.1.0"
+version = "0.2.0"
 description = "FastAPI adapter that auto-generates RESTful APIs for py-store schemas (schema-driven CRUD over GQL)"
 readme = "README.md"
 requires-python = ">=3.10"

{store_api_py-0.1.0 → store_api_py-0.2.0}/src/store_api_py/app.py

@@ -11,7 +11,7 @@ import json
 from typing import Any, Callable
 
 from fastapi import FastAPI, Request
-from fastapi.responses import JSONResponse
+from fastapi.responses import JSONResponse, Response
 
 from .errors import (
     StoreApiError,
@@ -49,6 +49,8 @@ def create_app(
     context_provider: ContextProvider | None = None,
     resources: list[str] | None = None,
     permission_error: type[BaseException] | None = None,
+    file_field: str = "file",
+    file_resolver: Callable[[Request, dict, str], Any] | None = None,
 ) -> FastAPI:
     """为 store（py-store 的 store 实例，需已 init + register）生成 RESTful FastAPI 应用。
 
@@ -97,7 +99,7 @@ def create_app(
         # 显式投影（spec/01+02）：GQL 省略投影段 = 只返回 _id（三端 core 契约）。
         # 列表路由仅在 q 缺失时用它；q 存在时投影完全由 q 决定，适配层不追加。
         proj = _schema_projection(store, name)
-        _register_resource(app, store, name, prefix, id_field, permission_error, proj)
+        _register_resource(app, store, name, prefix, id_field, permission_error, proj, file_field, file_resolver)
 
     return app
 
@@ -153,6 +155,8 @@ def _register_resource(
     id_field: str,
     permission_error: type[BaseException] | None,
     proj: str,
+    file_field: str,
+    file_resolver: Callable[[Request, dict, str], Any] | None,
 ) -> None:
     # 工厂函数隔离闭包：handler 签名只含 Request 与路径参数，
     # 否则 FastAPI 会把捕获变量解析成查询参数（缺参即 422）
@@ -174,6 +178,27 @@ def _register_resource(
             raise not_found(f"记录不存在: {id_field}={rid}")
         return {"data": data}
 
+    @app.get(base + "/{rid}/file")
+    @_guard(permission_error)
+    async def get_file(rid: str, request: Request):
+        rec = await store.query_one(f"{name}($condition: @c0){proj}", {"c0": {id_field: rid}})
+        if rec is None:
+            raise not_found(f"记录不存在: {id_field}={rid}")
+        raw = rec.get(file_field)
+        if raw is None:
+            raise not_found(f"文件不存在: {file_field}={rid}")
+        if file_resolver is not None:
+            out = file_resolver(request, rec, rid)
+            if inspect.isawaitable(out):
+                out = await out
+        else:
+            out = {"body": str(raw), "contentType": "text/plain; charset=utf-8", "fileName": f"{name}-{rid}"}
+        return Response(
+            content=out["body"],
+            media_type=out.get("contentType", "application/octet-stream"),
+            headers={"content-disposition": f'attachment; filename="{out.get("fileName", "file")}"'},
+        )
+
     @app.post(base, status_code=201)
     @_guard(permission_error)
     async def create_resource(request: Request):

{store_api_py-0.1.0 → store_api_py-0.2.0}/src/store_api_py.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: store-api-py
-Version: 0.1.0
+Version: 0.2.0
 Summary: FastAPI adapter that auto-generates RESTful APIs for py-store schemas (schema-driven CRUD over GQL)
 License: MIT
 Keywords: py-store,storepy,fastapi,rest,crud,gql

{store_api_py-0.1.0 → store_api_py-0.2.0}/tests/test_smoke.py

@@ -223,3 +223,23 @@ def test_x_cache_header():
     store.cache_status = lambda: "HIT"
     hit = client.get("/api/user")
     assert hit.headers["x-cache"] == "HIT"
+
+
+def test_file_download_route():
+    """文件下载路由：200 + 头；记录/字段缺失 → 404（spec/01+03+05）"""
+    store = MockStore()
+    client = TestClient(build_app(store))
+
+    created = client.post("/api/user", json={"name": "a", "age": 1})
+    rid = created.json()["data"]["_id"]
+    store.rows[rid]["file"] = "hello"
+
+    file = client.get(f"/api/user/{rid}/file")
+    assert file.status_code == 200
+    assert file.headers["content-type"] == "text/plain; charset=utf-8"
+    assert file.headers["content-disposition"] == f'attachment; filename="user-{rid}"'
+    assert file.content == b"hello"
+
+    missing = client.get("/api/user/nope/file")
+    assert missing.status_code == 404
+    assert missing.json()["error"]["code"] == "NOT_FOUND"