adds get user

Author: pcrespov

api/specs/web-server/_users.py

@@ -15,6 +15,7 @@
     MyTokenCreate,
     MyTokenGet,
     MyUserGet,
+    MyUsersGetParams,
     MyUsersSearchQueryParams,
     UserGet,
     UsersSearchQueryParams,
@@ -47,7 +48,7 @@ async def get_my_profile():
     "/me",
     status_code=status.HTTP_204_NO_CONTENT,
 )
-async def update_my_profile(_profile: MyProfilePatch):
+async def update_my_profile(_body: MyProfilePatch):
     ...
 
 
@@ -57,7 +58,7 @@ async def update_my_profile(_profile: MyProfilePatch):
     deprecated=True,
     description="Use PATCH instead",
 )
-async def replace_my_profile(_profile: MyProfilePatch):
+async def replace_my_profile(_body: MyProfilePatch):
     ...
 
 
@@ -67,7 +68,7 @@ async def replace_my_profile(_profile: MyProfilePatch):
 )
 async def set_frontend_preference(
     preference_id: PreferenceIdentifier,
-    body_item: PatchRequestBody,
+    _body: PatchRequestBody,
 ):
     ...
 
@@ -85,23 +86,25 @@ async def list_tokens():
     response_model=Envelope[MyTokenGet],
     status_code=status.HTTP_201_CREATED,
 )
-async def create_token(_token: MyTokenCreate):
+async def create_token(_body: MyTokenCreate):
     ...
 
 
 @router.get(
     "/me/tokens/{service}",
     response_model=Envelope[MyTokenGet],
 )
-async def get_token(_params: Annotated[_TokenPathParams, Depends()]):
+async def get_token(
+    _path: Annotated[_TokenPathParams, Depends()],
+):
     ...
 
 
 @router.delete(
     "/me/tokens/{service}",
     status_code=status.HTTP_204_NO_CONTENT,
 )
-async def delete_token(_params: Annotated[_TokenPathParams, Depends()]):
+async def delete_token(_path: Annotated[_TokenPathParams, Depends()]):
     ...
 
 
@@ -117,7 +120,9 @@ async def list_user_notifications():
     "/me/notifications",
     status_code=status.HTTP_204_NO_CONTENT,
 )
-async def create_user_notification(_notification: UserNotificationCreate):
+async def create_user_notification(
+    _body: UserNotificationCreate,
+):
     ...
 
 
@@ -126,8 +131,8 @@ async def create_user_notification(_notification: UserNotificationCreate):
     status_code=status.HTTP_204_NO_CONTENT,
 )
 async def mark_notification_as_read(
-    _params: Annotated[_NotificationPathParams, Depends()],
-    _notification: UserNotificationPatch,
+    _path: Annotated[_NotificationPathParams, Depends()],
+    _body: UserNotificationPatch,
 ):
     ...
 
@@ -140,12 +145,20 @@ async def list_user_permissions():
     ...
 
 
+@router.get(
+    "/me/users/{user_id}",
+    response_model=Envelope[MyUserGet],
+)
+async def get_user(_path: Annotated[MyUsersGetParams, Depends()]):
+    ...
+
+
 @router.get(
     "/me/users:search",
     response_model=Envelope[list[MyUserGet]],
     description="Search among users who are publicly visible to the caller (i.e., me) based on their privacy settings.",
 )
-async def search_users(_params: Annotated[MyUsersSearchQueryParams, Depends()]):
+async def search_users(_query: Annotated[MyUsersSearchQueryParams, Depends()]):
     ...
 
 
@@ -157,7 +170,7 @@ async def search_users(_params: Annotated[MyUsersSearchQueryParams, Depends()]):
     response_model=Envelope[list[UserGet]],
     tags=_extra_tags,
 )
-async def search_users_as_admin(_params: Annotated[UsersSearchQueryParams, Depends()]):
+async def search_users_as_admin(_query: Annotated[UsersSearchQueryParams, Depends()]):
     # NOTE: see `Search` in `Common Custom Methods` in https://cloud.google.com/apis/design/custom_methods
     ...
 

packages/models-library/src/models_library/api_schemas_webserver/users.py

@@ -196,6 +196,10 @@ def _validate_user_name(cls, value: str):
 #
 
 
+class MyUsersGetParams(BaseModel):
+    user_id: UserID
+
+
 class MyUsersSearchQueryParams(BaseModel):
     match_: Annotated[
         str,

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

@@ -1323,6 +1323,28 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Envelope_list_MyPermissionGet__'
+  /v0/me/users/{user_id}:
+    get:
+      tags:
+      - user
+      summary: Get User
+      operationId: get_user
+      parameters:
+      - name: user_id
+        in: path
+        required: true
+        schema:
+          type: integer
+          exclusiveMinimum: true
+          title: User Id
+          minimum: 0
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Envelope_MyUserGet_'
   /v0/me/users:search:
     get:
       tags:
@@ -8231,6 +8253,19 @@ components:
           title: Error
       type: object
       title: Envelope[MyTokenGet]
+    Envelope_MyUserGet_:
+      properties:
+        data:
+          anyOf:
+          - $ref: '#/components/schemas/MyUserGet'
+          - type: 'null'
+        error:
+          anyOf:
+          - {}
+          - type: 'null'
+          title: Error
+      type: object
+      title: Envelope[MyUserGet]
     Envelope_NodeCreated_:
       properties:
         data: