feat: add search

Author: giancarloromeo

services/web/server/src/simcore_service_webserver/api/v0/openapi.yaml

@@ -3670,6 +3670,33 @@ paths:
           type: boolean
           default: false
           title: Include Extras
+      - name: search
+        in: query
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Search
+      - name: filters
+        in: query
+        required: false
+        schema:
+          anyOf:
+          - type: string
+            contentMediaType: application/json
+            contentSchema: {}
+          - type: 'null'
+          title: Filters
+      - name: order_by
+        in: query
+        required: false
+        schema:
+          type: string
+          contentMediaType: application/json
+          contentSchema: {}
+          default: '{"field":"modified_at","direction":"desc"}'
+          title: Order By
       - name: limit
         in: query
         required: false

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

@@ -166,6 +166,10 @@ async def list_functions(request: web.Request) -> web.Response:
         pagination_limit=query_params.limit,
         pagination_offset=query_params.offset,
         order_by=OrderBy.model_construct(**query_params.order_by.model_dump()),
+        search_by_function_title=(
+            query_params.filters.search_by_title if query_params.filters else None
+        ),
+        search_by_multi_columns=query_params.search,
     )
 
     chunk: list[RegisteredFunctionGet] = []

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

@@ -1,13 +1,16 @@
+from typing import Annotated
+
 from models_library.basic_types import IDStr
 from models_library.functions import FunctionID
 from models_library.rest_base import RequestParameters
+from models_library.rest_filters import Filters, FiltersQueryParameters
 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
+from pydantic import BaseModel, ConfigDict, Field
 
 from ...models import AuthenticatedRequestContext
 
@@ -19,25 +22,51 @@ class FunctionPathParams(BaseModel):
     model_config = ConfigDict(populate_by_name=True, extra="forbid")
 
 
-class _FunctionQueryParams(BaseModel):
+class FunctionQueryParams(BaseModel):
     include_extras: bool = False
 
 
-class FunctionGetQueryParams(_FunctionQueryParams): ...
+class FunctionGetQueryParams(FunctionQueryParams): ...
+
+
+class FunctionFilters(Filters):
+    search_by_title: Annotated[
+        str | None,
+        Field(
+            description="A search query to filter functions by their title. This field performs a case-insensitive partial match against the function title field.",
+        ),
+    ] = None
 
 
-_FunctionOrderQueryParams: type[RequestParameters] = create_ordering_query_model_class(
-    ordering_fields={
-        "created_at",
-        "modified_at",
-        "name",
-    },
-    default=OrderBy(field=IDStr("modified_at"), direction=OrderDirection.DESC),
+FunctionListOrderQueryParams: type[RequestParameters] = (
+    create_ordering_query_model_class(
+        ordering_fields={
+            "created_at",
+            "modified_at",
+            "name",
+        },
+        default=OrderBy(field=IDStr("modified_at"), direction=OrderDirection.DESC),
+    )
 )
 
 
+class FunctionsListExtraQueryParams(RequestParameters):
+    search: Annotated[
+        str | None,
+        Field(
+            description="Multi column full text search",
+            max_length=100,
+            examples=["My Function"],
+        ),
+    ] = None
+
+
 class FunctionsListQueryParams(
-    PageQueryParameters, _FunctionOrderQueryParams, _FunctionQueryParams  # type: ignore[misc, valid-type]
+    PageQueryParameters,
+    FunctionListOrderQueryParams,  # type: ignore[misc, valid-type]
+    FiltersQueryParameters[FunctionFilters],
+    FunctionsListExtraQueryParams,
+    FunctionQueryParams,
 ): ...