utoipa: Add annotations to /tokens/current endpoints

Author: Turbo87

src/controllers/token.rs

@@ -220,7 +220,17 @@ pub async fn revoke(app: AppState, Path(id): Path<i32>, req: Parts) -> AppResult
     Ok(json!({}))
 }
 
-/// Handles the `DELETE /tokens/current` route.
+/// Revoke the current API token.
+///
+/// This endpoint revokes the API token that is used to authenticate
+/// the request.
+#[utoipa::path(
+    delete,
+    path = "/api/v1/tokens/current",
+    operation_id = "revoke_current_api_token",
+    tag = "api_tokens",
+    responses((status = 200, description = "Successful Response")),
+)]
 pub async fn revoke_current(app: AppState, req: Parts) -> AppResult<Response> {
     let mut conn = app.db_write().await?;
     let auth = AuthCheck::default().check(&req, &mut conn).await?;

src/router.rs

@@ -51,10 +51,10 @@ pub fn build_axum_router(state: AppState) -> Router<()> {
         .routes(routes!(user::me::updates))
         .routes(routes!(token::list, token::new))
         .routes(routes!(token::show, token::revoke))
+        .routes(routes!(token::revoke_current))
         .split_for_parts();
 
     let mut router = router
-        .route("/api/v1/tokens/current", delete(token::revoke_current))
         .route(
             "/api/v1/me/crate_owner_invitations",
             get(crate_owner_invitation::list),

src/snapshots/crates_io__openapi__tests__openapi_snapshot.snap

@@ -534,6 +534,21 @@ snapshot_kind: text
         ]
       }
     },
+    "/api/v1/tokens/current": {
+      "delete": {
+        "description": "This endpoint revokes the API token that is used to authenticate\nthe request.",
+        "operationId": "revoke_current_api_token",
+        "responses": {
+          "200": {
+            "description": "Successful Response"
+          }
+        },
+        "summary": "Revoke the current API token.",
+        "tags": [
+          "api_tokens"
+        ]
+      }
+    },
     "/api/v1/users/{id}/stats": {
       "get": {
         "description": "This currently only returns the total number of downloads for crates owned\nby the user.",