rustango_cms/admin/
model_admin.rs1use std::future::Future;
18use std::pin::Pin;
19
20use rustango::core::ModelSchema;
21use rustango::sql::Pool;
22
23pub type ListRowsFn = fn(Pool) -> Pin<Box<dyn Future<Output = Vec<serde_json::Value>> + Send>>;
28
29pub struct ModelAdmin {
31 pub slug: &'static str,
33 pub label: &'static str,
35 pub schema: &'static ModelSchema,
37 pub list_rows: ListRowsFn,
39}
40
41inventory::collect!(ModelAdmin);
42
43#[must_use]
45pub fn registered() -> Vec<&'static ModelAdmin> {
46 let mut v: Vec<_> = inventory::iter::<ModelAdmin>.into_iter().collect();
47 v.sort_by_key(|m| m.slug);
48 v
49}
50
51#[must_use]
53pub fn find(slug: &str) -> Option<&'static ModelAdmin> {
54 inventory::iter::<ModelAdmin>
55 .into_iter()
56 .find(|m| m.slug == slug)
57}
58
59#[must_use]
64pub fn list_columns(schema: &ModelSchema) -> Vec<(String, String)> {
65 let names: Vec<&'static str> = schema
66 .admin
67 .map(|a| a.list_display)
68 .filter(|d| !d.is_empty())
69 .map(<[&'static str]>::to_vec)
70 .unwrap_or_else(|| {
71 schema
72 .display
73 .map(|d| vec![d])
74 .unwrap_or_else(|| schema.fields.iter().take(4).map(|f| f.name).collect())
75 });
76 names
77 .iter()
78 .map(|n| {
79 let label = schema
80 .field(n)
81 .map_or_else(|| (*n).to_owned(), |f| f.display_label().to_owned());
82 ((*n).to_owned(), label)
83 })
84 .collect()
85}
86
87#[must_use]
91pub fn row_cell(row: &serde_json::Value, col: &str) -> String {
92 match row.get(col) {
93 Some(serde_json::Value::String(s)) => s.clone(),
94 None | Some(serde_json::Value::Null) => String::new(),
95 Some(other) => other.to_string(),
96 }
97}
98
99#[macro_export]
110macro_rules! register_model_admin {
111 ($ty:ty, $slug:expr, $label:expr $(,)?) => {
112 $crate::inventory::submit! {
113 $crate::admin::model_admin::ModelAdmin {
114 slug: $slug,
115 label: $label,
116 schema: <$ty as $crate::__private::Model>::SCHEMA,
117 list_rows: |pool: $crate::__private::Pool| {
118 ::std::boxed::Box::pin(async move {
119 use $crate::__private::FetcherPool as _;
120 let rows: ::std::vec::Vec<$ty> =
121 <$ty>::objects().fetch(&pool).await.unwrap_or_default();
122 rows.iter()
123 .filter_map(|r| $crate::__private::serde_json::to_value(r).ok())
124 .collect::<::std::vec::Vec<$crate::__private::serde_json::Value>>()
125 })
126 },
127 }
128 }
129 };
130}
131
132#[cfg(test)]
133mod tests {
134 use super::*;
135
136 crate::register_model_admin!(crate::locale::Locale, "__test_locale", "Test Locales");
139
140 #[test]
141 fn macro_registers_and_find_resolves() {
142 let ma = find("__test_locale").expect("registered");
143 assert_eq!(ma.label, "Test Locales");
144 assert_eq!(ma.schema.table, "cms_locale");
145 assert!(registered().iter().any(|m| m.slug == "__test_locale"));
146 }
147
148 #[test]
149 fn columns_come_from_list_display_with_labels() {
150 use rustango::core::Model as _;
151 let cols = list_columns(crate::locale::Locale::SCHEMA);
152 assert!(!cols.is_empty(), "a model with admin hints yields columns");
153 assert!(cols.iter().all(|(n, l)| !n.is_empty() && !l.is_empty()));
155 }
156
157 #[test]
158 fn row_cell_stringifies_by_json_kind() {
159 let row = serde_json::json!({"code": "en", "sort_order": 3, "active": true, "x": null});
160 assert_eq!(row_cell(&row, "code"), "en"); assert_eq!(row_cell(&row, "sort_order"), "3"); assert_eq!(row_cell(&row, "active"), "true"); assert_eq!(row_cell(&row, "x"), ""); assert_eq!(row_cell(&row, "missing"), ""); }
166}