utoipa: Add annotations to /me/updates endpoints

Author: Turbo87

src/controllers/user/me.rs

@@ -69,7 +69,14 @@ pub async fn me(app: AppState, req: Parts) -> AppResult<Json<EncodableMe>> {
     }))
 }
 
-/// Handles the `GET /me/updates` route.
+/// List versions of crates that the authenticated user follows.
+#[utoipa::path(
+    get,
+    path = "/api/v1/me/updates",
+    operation_id = "get_authenticated_user_updates",
+    tag = "versions",
+    responses((status = 200, description = "Successful Response")),
+)]
 pub async fn updates(app: AppState, req: Parts) -> AppResult<ErasedJson> {
     let mut conn = app.db_read_prefer_primary().await?;
     let auth = AuthCheck::only_cookie().check(&req, &mut conn).await?;

src/router.rs

@@ -48,10 +48,10 @@ pub fn build_axum_router(state: AppState) -> Router<()> {
         .routes(routes!(user::other::stats))
         .routes(routes!(team::show_team))
         .routes(routes!(user::me::me))
+        .routes(routes!(user::me::updates))
         .split_for_parts();
 
     let mut router = router
-        .route("/api/v1/me/updates", get(user::me::updates))
         .route("/api/v1/me/tokens", get(token::list).put(token::new))
         .route(
             "/api/v1/me/tokens/:id",

src/snapshots/crates_io__openapi__tests__openapi_snapshot.snap

@@ -454,6 +454,20 @@ snapshot_kind: text
         ]
       }
     },
+    "/api/v1/me/updates": {
+      "get": {
+        "operationId": "get_authenticated_user_updates",
+        "responses": {
+          "200": {
+            "description": "Successful Response"
+          }
+        },
+        "summary": "List versions of crates that the authenticated user follows.",
+        "tags": [
+          "versions"
+        ]
+      }
+    },
     "/api/v1/teams/{team}": {
       "get": {
         "operationId": "get_team",