From 79655932d0146ee4681284fcb9417f99f3fc5a3d Mon Sep 17 00:00:00 2001 From: Manuel Cillero Date: Tue, 13 Oct 2026 00:12:13 +0200 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Ejemplos=20de=20documentaci?= =?UTF-8?q?=C3=B3n=20usando=20`prelude`?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- extensions/pagetop-admin/src/action.rs | 6 +++--- extensions/pagetop-user/src/permission.rs | 3 +-- src/base/component/table/column.rs | 5 ++--- src/html/sort_dir.rs | 18 ++++++------------ src/util.rs | 12 ++++++------ 5 files changed, 18 insertions(+), 26 deletions(-) diff --git a/extensions/pagetop-admin/src/action.rs b/extensions/pagetop-admin/src/action.rs index 2d9670e8..99117a3b 100644 --- a/extensions/pagetop-admin/src/action.rs +++ b/extensions/pagetop-admin/src/action.rs @@ -79,7 +79,7 @@ impl ActionBag { /// # Ejemplo /// /// ```rust,no_run -/// use pagetop::locale::Lc; +/// use pagetop::prelude::*; /// use pagetop_admin::action::{DeclareAdminSections, SectionBag}; /// use pagetop_admin::registry::AdminSection; /// @@ -191,7 +191,7 @@ impl DeclareAdminPages { /// # Ejemplo /// /// ```rust,no_run -/// use pagetop::locale::Lc; +/// use pagetop::prelude::*; /// use pagetop_admin::action::{DeclareAdminTasks, TaskBag}; /// use pagetop_admin::registry::AdminTask; /// @@ -244,7 +244,7 @@ impl DeclareAdminTasks { /// # Ejemplo /// /// ```rust,no_run -/// use pagetop::locale::Lc; +/// use pagetop::prelude::*; /// use pagetop_admin::action::{DeclareAdminActions, ActionBag}; /// use pagetop_admin::registry::AdminAction; /// diff --git a/extensions/pagetop-user/src/permission.rs b/extensions/pagetop-user/src/permission.rs index 2b5f0a9a..85db7794 100644 --- a/extensions/pagetop-user/src/permission.rs +++ b/extensions/pagetop-user/src/permission.rs @@ -25,8 +25,7 @@ use crate::LOCALES_USER; /// # Ejemplo /// /// ```rust,no_run -/// # use pagetop::auth::Permission; -/// # use pagetop::CowStr; +/// # use pagetop::prelude::*; /// # use pagetop_user::permission::{DeclarePermissions, PermissionRegistry}; /// #[derive(Clone, Copy, Debug)] /// enum MyPermission { diff --git a/src/base/component/table/column.rs b/src/base/component/table/column.rs index e7c0cc91..3af8b2ba 100644 --- a/src/base/component/table/column.rs +++ b/src/base/component/table/column.rs @@ -10,10 +10,9 @@ use crate::prelude::*; /// sería necesario llamar a [`Column::new()`] de forma explícita. /// /// ```rust -/// use pagetop::locale::Lc; -/// use pagetop::base::component::table::Column; +/// use pagetop::prelude::*; /// -/// let column: Column = Lc::n("User").into(); +/// let column: table::Column = Lc::n("User").into(); /// assert_eq!(column.label().get(), Some("User".to_string())); /// assert!(column.sort().is_none()); /// ``` diff --git a/src/html/sort_dir.rs b/src/html/sort_dir.rs index f11480a0..c9a61ea0 100644 --- a/src/html/sort_dir.rs +++ b/src/html/sort_dir.rs @@ -25,8 +25,7 @@ impl SortDir { /// reconocido) se interpreta como [`Asc`](Self::Asc). /// /// ```rust - /// use pagetop::html::SortDir; - /// + /// # use pagetop::prelude::*; /// assert_eq!(SortDir::from_query(Some("desc")), SortDir::Desc); /// assert_eq!(SortDir::from_query(Some("asc")), SortDir::Asc); /// assert_eq!(SortDir::from_query(Some("")), SortDir::Asc); @@ -44,8 +43,7 @@ impl SortDir { /// (`"asc"`/`"desc"`). /// /// ```rust - /// use pagetop::html::SortDir; - /// + /// # use pagetop::prelude::*; /// assert_eq!(SortDir::Asc.as_str(), "asc"); /// assert_eq!(SortDir::Desc.as_str(), "desc"); /// ``` @@ -60,8 +58,7 @@ impl SortDir { /// Devuelve la dirección contraria a esta. /// /// ```rust - /// use pagetop::html::SortDir; - /// + /// # use pagetop::prelude::*; /// assert_eq!(SortDir::Asc.toggled(), SortDir::Desc); /// assert_eq!(SortDir::Desc.toggled(), SortDir::Asc); /// ``` @@ -81,8 +78,7 @@ impl SortDir { /// [`Asc`](Self::Asc), sea cual sea la dirección vigente del listado en conjunto. /// /// ```rust - /// use pagetop::html::SortDir; - /// + /// # use pagetop::prelude::*; /// // Otro campo determina el orden vigente: el próximo clic aquí empieza en ascendente. /// assert_eq!(SortDir::next_for(None), SortDir::Asc); /// @@ -104,8 +100,7 @@ impl SortDir { /// equivalente `alter_param()`, sin tener que escribir `.as_str()` a mano. /// /// ```rust -/// use pagetop::html::SortDir; -/// +/// # use pagetop::prelude::*; /// assert_eq!(SortDir::Asc.as_ref(), "asc"); /// assert_eq!(SortDir::Desc.as_ref(), "desc"); /// ``` @@ -120,8 +115,7 @@ impl AsRef for SortDir { /// escribir `as_str().to_owned()` a mano. /// /// ```rust -/// use pagetop::html::SortDir; -/// +/// # use pagetop::prelude::*; /// assert_eq!(String::from(SortDir::Asc), "asc"); /// assert_eq!(String::from(SortDir::Desc), "desc"); /// ``` diff --git a/src/util.rs b/src/util.rs index 9155a55f..c81ef5fd 100644 --- a/src/util.rs +++ b/src/util.rs @@ -59,7 +59,7 @@ pub enum NormalizeAsciiError { /// # Ejemplo /// /// ```rust -/// # use pagetop::util; +/// # use pagetop::prelude::*; /// assert_eq!(util::non_blank(" hello "), Some("hello")); /// assert_eq!(util::non_blank(" "), None); /// assert_eq!(util::non_blank(""), None); @@ -94,7 +94,7 @@ pub fn non_blank(s: &str) -> Option<&str> { /// # Ejemplo /// /// ```rust -/// # use pagetop::util; +/// # use pagetop::prelude::*; /// assert_eq!( /// util::normalize_ascii_non_blank(" Foo\tBAR CLi\r\n").unwrap().as_ref(), /// "foo bar cli" @@ -185,7 +185,7 @@ pub fn normalize_ascii_non_blank(input: &str) -> Result, NormalizeA /// # Ejemplo /// /// ```rust -/// # use pagetop::util; +/// # use pagetop::prelude::*; /// assert_eq!( /// util::normalize_ascii(" Foo\tBAR CLi\r\n").unwrap().as_ref(), /// "foo bar cli" @@ -219,7 +219,7 @@ pub fn normalize_ascii(input: &str) -> Option> { /// # Ejemplo /// /// ```rust -/// # use pagetop::util; +/// # use pagetop::prelude::*; /// assert_eq!(util::normalize_property(" Flex-Basis "), Some("flex-basis".to_string())); /// assert_eq!(util::normalize_property(" "), None); /// ``` @@ -241,7 +241,7 @@ pub fn normalize_property(property: impl AsRef) -> Option { /// # Ejemplo /// /// ```rust -/// # use pagetop::util; +/// # use pagetop::prelude::*; /// assert_eq!(util::normalize_token(" My Id "), Some("my_id".to_string())); /// assert_eq!(util::normalize_token("AÑO\tNuevo"), Some("año_nuevo".to_string())); /// assert_eq!(util::normalize_token("a b"), Some("a___b".to_string())); @@ -270,7 +270,7 @@ pub fn normalize_token(s: impl AsRef) -> Option { /// # Ejemplo /// /// ```rust -/// # use pagetop::util; +/// # use pagetop::prelude::*; /// assert!(util::url_looks_external("https://example.com")); /// assert!(util::url_looks_external("mailto:info@example.com")); /// assert!(util::url_looks_external("HTTPS://EXAMPLE.COM"));