From b2e9fe79e86a47082490af1d524b0daf1f5f8aaa Mon Sep 17 00:00:00 2001 From: Manuel Cillero Date: Mon, 19 Oct 2026 07:20:50 +0200 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20(auth):=20Documenta=20la=20conve?= =?UTF-8?q?nci=C3=B3n=20de=20las=20claves?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Los ejemplos usaban `.` como separador, pero las extensiones usan `extensión:permiso` (p. ej. `user:admin_users`). Se unifican ejemplos y se documenta la convención en `Permission::key()`. --- src/auth.rs | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/src/auth.rs b/src/auth.rs index 6016f584..6a9fdc67 100644 --- a/src/auth.rs +++ b/src/auth.rs @@ -188,14 +188,16 @@ impl CurrentUser { /// impl Permission for MyPermission { /// fn key(&self) -> CowStr { /// match self { -/// Self::EditPosts => "my_extension.edit_posts".into(), -/// Self::DeletePosts => "my_extension.delete_posts".into(), +/// Self::EditPosts => "my_extension:edit_posts".into(), +/// Self::DeletePosts => "my_extension:delete_posts".into(), /// } /// } /// } /// ``` pub trait Permission: Send + Sync { - /// Clave única del permiso (p. ej. `"my_extension.edit_posts"`). + /// Clave única del permiso. Por convención, el nombre de la extensión y el del permiso + /// separados por `:` (p. ej. `"my_extension:edit_posts"`), para que no coincida con la de otra + /// extensión. fn key(&self) -> CowStr; /// Descripción breve para humanos (p. ej. en una pantalla de asignación de permisos a roles). @@ -306,7 +308,7 @@ impl CheckPermission { /// # #[derive(Clone, Copy, Debug)] /// # enum MyPermission { Edit } /// # impl Permission for MyPermission { -/// # fn key(&self) -> CowStr { "myapp.edit".into() } +/// # fn key(&self) -> CowStr { "myapp:edit".into() } /// # } /// async fn my_handler(request: HttpRequest) -> Result { /// if !has_permission(&request, &MyPermission::Edit) { @@ -349,7 +351,7 @@ pub fn has_permission(request: &HttpRequest, perm: PermissionRef) -> bool { /// # #[derive(Clone, Copy, Debug)] /// # enum MyPermission { Edit } /// # impl Permission for MyPermission { -/// # fn key(&self) -> CowStr { "myapp.edit".into() } +/// # fn key(&self) -> CowStr { "myapp:edit".into() } /// # } /// async fn my_handler(request: HttpRequest) -> Result { /// // Comprueba si la petición está autorizada.