Struct ModelMeta 

pub struct ModelMeta {

    pub name: String,
    pub table: String,
    pub fields: Vec<Column>,
    pub display: String,
    pub icon: String,
    pub database: Option<String>,
    pub singleton: bool,
    pub unique_together: Vec<Vec<String>>,
    pub indexes: Vec<Vec<String>>,
    pub ordering: Vec<(String, bool)>,
    pub m2m_relations: Vec<M2MRelation>,
    pub soft_delete: bool,
    pub app_label: String,
}

Static metadata for one registered model, copied off the Model trait’s consts when the user calls App::builder().model::<T>().

Owned (no lifetimes) so the registry can hold an arbitrary number without the lifetime contortions a slice of trait references would need. The cost is one Vec at App::build time; the win is registered_models() having a plain &'static [ModelMeta] signature.

Fields

name: String

The struct name (Model::NAME). Identifies the model across snapshot diffs even if the table is renamed.

table: String

The SQL table name (Model::TABLE).

fields: Vec<Column>

One owned column descriptor per field, in declaration order. Owned (Column, not the underlying static FieldSpec) so the snapshot round-trips cleanly through serde.

display: String

Human-readable display name from Model::DISPLAY. Defaults to Model::NAME when no #[umbral(display = "...")] is present.

icon: String

Lucide icon slug from Model::ICON. Defaults to "database".

database: Option<String>

Database alias from Model::DATABASE, when set. None means “fall back to the owning plugin’s Plugin::database(), then the default pool.” Captured here so App::build’s alias routing can read it without re-reaching into the trait at a later phase.

singleton: bool

Mirrors Model::SINGLETON. Closes BUG-9 in bugs/tests/testBugs.md. Default false; admin renderers read it to auto-redirect list-view to the edit form.

unique_together: Vec<Vec<String>>

Mirrors Model::UNIQUE_TOGETHER. Composite-UNIQUE constraints, each inner Vec<String> listing the columns of one constraint. Closes BUG-6.

indexes: Vec<Vec<String>>

Mirrors Model::INDEXES. Each inner Vec<String> lists the columns of one multi-column index. Closes BUG-7.

ordering: Vec<(String, bool)>

Mirrors Model::ORDERING. Each tuple is (column, descending) — descending == true lowers to ORDER BY col DESC. Closes BUG-8.

m2m_relations: Vec<M2MRelation>

Mirrors Model::M2M_RELATIONS. Many-to-many relations declared on this model. The migration engine uses this to auto-generate junction tables. Closes BUG-16.

soft_delete: bool

Mirrors Model::SOFT_DELETE (#[umbral(soft_delete)]). The dynamic / annotate paths read this to auto-exclude deleted_at IS NULL children from correlated counts and to drive trash-aware admin views without re-reaching into the typed trait. Shared enabler for gaps2 #35 + #39a.

app_label: String

The app label (Django’s app name), mirrors Model::APP_LABEL. Sourced from #[umbral(plugin = "...")]; "app" when absent. Authoritative for permission codenames (gaps2 #80g): replaces the old table-name-split heuristic that collided distinct models. The #[serde(default)] keeps pre-#80g snapshot JSON round-tripping.

Implementations

impl ModelMeta

pub fn pk_column(&self) -> Option<&Column>

The primary-key column on this model. Every umbral model has exactly one PK by construction (the derive enforces it), but the lookup is Option-shaped because nothing stops a hand-written ModelMeta (test fixtures, etc.) from omitting it.

pub fn for_<T: Model>() -> Self

Read static metadata off T: Model into an owned ModelMeta. Called from AppBuilder::model::<T>().

Trait Implementations

impl Clone for ModelMeta

fn clone(&self) -> ModelMeta

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ModelMeta

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ModelMeta

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ModelMeta

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ModelMeta

impl PartialEq for ModelMeta

fn eq(&self, other: &ModelMeta) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ModelMeta

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ModelMeta