apexdevkit 1.16.3__tar.gz → 1.16.5__tar.gz

{apexdevkit-1.16.3 → apexdevkit-1.16.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: apexdevkit
-Version: 1.16.3
+Version: 1.16.5
 Summary: Apex Development Tools for python.
 Author: Apex Dev
 Author-email: dev@apex.ge

{apexdevkit-1.16.3 → apexdevkit-1.16.5}/apexdevkit/fastapi/resource.py

@@ -49,6 +49,15 @@ class RestfulResource:
 
         return endpoint
 
+    def read_many(self, Service, QueryParams) -> _Endpoint:  # type: ignore
+        def endpoint(service: Service, params: QueryParams) -> _Response:
+            try:
+                return self.response.found_many(list(service.read_many(**dict(params))))
+            except ForbiddenError as e:
+                return JSONResponse(self.response.forbidden(e), 403)
+
+        return endpoint
+
     def read_all(self, Service) -> _Endpoint:  # type: ignore
         def endpoint(service: Service) -> _Response:
             try:

{apexdevkit-1.16.3 → apexdevkit-1.16.5}/apexdevkit/fastapi/router.py

@@ -2,15 +2,16 @@ from dataclasses import dataclass, field
 from functools import cached_property
 from typing import Annotated, Any, Protocol, Self, TypeVar
 
-from fastapi import APIRouter, Depends, Path
+from fastapi import APIRouter, Depends, Path, Query
 from fastapi.responses import JSONResponse
 
 from apexdevkit.fastapi.builder import RestfulServiceBuilder
 from apexdevkit.fastapi.name import RestfulName
 from apexdevkit.fastapi.resource import RestfulResource
 from apexdevkit.fastapi.response import RestfulResponse
-from apexdevkit.fastapi.schema import RestfulSchema, SchemaFields
+from apexdevkit.fastapi.schema import RestfulSchema, Schema, SchemaFields
 from apexdevkit.fastapi.service import RawCollection, RawItem, RestfulService
+from apexdevkit.fluent import FluentDict
 
 _Response = JSONResponse | dict[str, Any]
 
@@ -135,6 +136,30 @@ class RestfulRouter:
 
         return self
 
+    def with_read_many_endpoint(
+        self,
+        dependency: Dependency,
+        query: FluentDict[Any],
+        is_documented: bool = True,
+    ) -> Self:
+        self.router.add_api_route(
+            "",
+            self.resource.read_many(
+                Service=dependency.as_dependable(),
+                QueryParams=Annotated[
+                    Schema(self.name).optional_schema_for("ReadMany", query), Query()
+                ],
+            ),
+            methods=["GET"],
+            status_code=200,
+            responses={},
+            response_model=self.schema.for_collection(),
+            include_in_schema=is_documented,
+            summary="Read Many",
+        )
+
+        return self
+
     def with_read_all_endpoint(
         self,
         dependency: Dependency,

{apexdevkit-1.16.3 → apexdevkit-1.16.5}/apexdevkit/fastapi/schema.py

@@ -46,13 +46,7 @@ class RestfulSchema:
 
     def _schema_for(self, action: str, fields: dict[str, Any]) -> type[BaseModel]:
         if action not in self.schemas:
-            self.schemas[action] = create_model(
-                self.name.singular.capitalize() + action,
-                **{
-                    field_name: (field_type, ...)
-                    for field_name, field_type in fields.items()
-                },
-            )
+            self.schemas[action] = Schema(self.name).schema_for(action, fields)
 
         return self.schemas[action]
 
@@ -134,3 +128,28 @@ class RestfulSchema:
             return [dict(item) for item in request.model_dump()[self.name.plural]]
 
         return _
+
+
+@dataclass(frozen=True)
+class Schema:
+    name: RestfulName
+
+    def schema_for(self, action: str, fields: dict[str, Any]) -> type[BaseModel]:
+        return create_model(
+            self.name.singular.capitalize() + action,
+            **{
+                field_name: (field_type, ...)
+                for field_name, field_type in fields.items()
+            },
+        )
+
+    def optional_schema_for(
+        self, action: str, fields: dict[str, Any]
+    ) -> type[BaseModel]:
+        return create_model(
+            self.name.singular.capitalize() + action,
+            **{
+                field_name: (field_type | None, None)
+                for field_name, field_type in fields.items()
+            },
+        )

{apexdevkit-1.16.3 → apexdevkit-1.16.5}/apexdevkit/fastapi/service.py

@@ -30,6 +30,9 @@ class RestfulService(ABC):  # pragma: no cover
     def read_one(self, item_id: str) -> RawItem:
         raise NotImplementedError(self.read_one.__name__)
 
+    def read_many(self, **params: Any) -> RawCollection:
+        raise NotImplementedError(self.read_many.__name__)
+
     def read_all(self) -> RawCollection:
         raise NotImplementedError(self.read_all.__name__)
 

{apexdevkit-1.16.3 → apexdevkit-1.16.5}/apexdevkit/testing/rest.py

@@ -42,6 +42,13 @@ class _RestResource:
             ),
         )
 
+    def read_many(self, **params: Any) -> _TestRequest:
+        http = self.http.with_endpoint(self.name.plural)
+        for p, v in params.items():
+            http = http.with_param(p, v)
+
+        return _TestRequest(self.name, HttpRequest(HttpMethod.get, http))
+
     def read_all(self) -> _TestRequest:
         return _TestRequest(
             self.name,

{apexdevkit-1.16.3 → apexdevkit-1.16.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "apexdevkit"
-version = "1.16.3"
+version = "1.16.5"
 description = "Apex Development Tools for python."
 authors = ["Apex Dev <dev@apex.ge>"]
 readme = "README.md"