feat: add ordering

Author: giancarloromeo

services/web/server/src/simcore_service_webserver/functions/_controller/_functions_rest.py

@@ -17,6 +17,7 @@
     RegisteredSolverFunction,
 )
 from models_library.products import ProductName
+from models_library.rest_ordering import OrderBy
 from models_library.rest_pagination import Page
 from models_library.rest_pagination_utils import paginate_data
 from models_library.users import UserID
@@ -164,6 +165,7 @@ async def list_functions(request: web.Request) -> web.Response:
         product_name=req_ctx.product_name,
         pagination_limit=query_params.limit,
         pagination_offset=query_params.offset,
+        order_by=OrderBy.model_construct(**query_params.order_by.model_dump()),
     )
 
     chunk: list[RegisteredFunctionGet] = []

services/web/server/src/simcore_service_webserver/functions/_controller/_functions_rest_schemas.py

@@ -1,4 +1,11 @@
+from models_library.basic_types import IDStr
 from models_library.functions import FunctionID
+from models_library.rest_base import RequestParameters
+from models_library.rest_ordering import (
+    OrderBy,
+    OrderDirection,
+    create_ordering_query_model_class,
+)
 from models_library.rest_pagination import PageQueryParameters
 from pydantic import BaseModel, ConfigDict
 
@@ -19,7 +26,19 @@ class _FunctionQueryParams(BaseModel):
 class FunctionGetQueryParams(_FunctionQueryParams): ...
 
 
-class FunctionsListQueryParams(PageQueryParameters, _FunctionQueryParams): ...
+_FunctionOrderQueryParams: type[RequestParameters] = create_ordering_query_model_class(
+    ordering_fields={
+        "name",
+        "created_at",
+        "modified_at",
+    },
+    default=OrderBy(field=IDStr("modified_at"), direction=OrderDirection.DESC),
+)
+
+
+class FunctionsListQueryParams(
+    PageQueryParameters, _FunctionOrderQueryParams, _FunctionQueryParams
+): ...
 
 
 __all__: tuple[str, ...] = ("AuthenticatedRequestContext",)