utoipa: Add annotations to /users/{id}/resend endpoints

Author: Turbo87

src/controllers/user.rs

@@ -1,6 +1,6 @@
 pub mod me;
 pub mod other;
-mod resend;
+pub mod resend;
 pub mod session;
 pub mod update;
 

src/controllers/user/resend.rs

@@ -14,7 +14,14 @@ use diesel_async::scoped_futures::ScopedFutureExt;
 use diesel_async::{AsyncConnection, RunQueryDsl};
 use http::request::Parts;
 
-/// Handles `PUT /user/:user_id/resend` route
+/// Regenerate and send an email verification token.
+#[utoipa::path(
+    put,
+    path = "/api/v1/users/{id}/resend",
+    operation_id = "resend_email_verification",
+    tag = "users",
+    responses((status = 200, description = "Successful Response")),
+)]
 pub async fn regenerate_token_and_send(
     state: AppState,
     Path(param_user_id): Path<i32>,

src/router.rs

@@ -1,5 +1,5 @@
 use axum::response::IntoResponse;
-use axum::routing::{delete, get, post, put};
+use axum::routing::{delete, get, post};
 use axum::{Json, Router};
 use http::{Method, StatusCode};
 use utoipa_axum::routes;
@@ -58,13 +58,10 @@ pub fn build_axum_router(state: AppState) -> Router<()> {
         .routes(routes!(user::me::update_email_notifications))
         .routes(routes!(summary::summary))
         .routes(routes!(user::me::confirm_user_email))
+        .routes(routes!(user::resend::regenerate_token_and_send))
         .split_for_parts();
 
     let mut router = router
-        .route(
-            "/api/v1/users/:user_id/resend",
-            put(user::regenerate_token_and_send),
-        )
         .route(
             "/api/v1/site_metadata",
             get(site_metadata::show_deployed_sha),

src/snapshots/crates_io__openapi__tests__openapi_snapshot.snap

@@ -636,6 +636,20 @@ snapshot_kind: text
         ]
       }
     },
+    "/api/v1/users/{id}/resend": {
+      "put": {
+        "operationId": "resend_email_verification",
+        "responses": {
+          "200": {
+            "description": "Successful Response"
+          }
+        },
+        "summary": "Regenerate and send an email verification token.",
+        "tags": [
+          "users"
+        ]
+      }
+    },
     "/api/v1/users/{id}/stats": {
       "get": {
         "description": "This currently only returns the total number of downloads for crates owned\nby the user.",