Struct RelationRegistry 

pub struct RelationRegistry { /* private fields */ }

Relation lookup tables for one snapshot of the schema.

Build once per schema reload and consume by &-reference from every admin handler that needs it. Pure data — no interior mutability, no cached queries, no hidden state.

belongs_to[("Appointment", "patient_id")] → ResolvedRelation {
    target_model: "Patient",
    target_table: "patients",
    target_display_field: Some("full_name"),
    …
}

has_many["Patient"] → [
    InverseRelation { source_model: "Appointment", source_field: "patient_id", … },
    InverseRelation { source_model: "Invoice",     source_field: "patient_id", … },
]

Implementations

impl RelationRegistry

pub fn empty() -> Self

Empty registry. Every lookup returns None. Useful as a safe default when the schema file is missing or fails to parse — the admin falls back to raw-id rendering.

pub fn from_schema(schema: &Schema) -> Self

Build the registry from a Schema. Silent on unknown targets / display fields — call validate after if you want those surfaced as errors. Building is intentionally lenient so a single typo in rustio.schema.json doesn’t blank out the entire registry.

pub fn belongs_to(&self, model: &str, field: &str) -> Option<&ResolvedRelation>

The ResolvedRelation for (model, field), if any.

pub fn belongs_to_of(&self, model: &str) -> &[ResolvedRelation]

Every forward relation owned by a source model. Used by the list handler to enumerate FK columns for prefetch + filters. Returns an empty slice when the model declares none.

pub fn has_many(&self, model: &str) -> &[InverseRelation]

Every incoming edge into model. Used by the inverse-panel renderer and the delete guard.

pub fn is_empty(&self) -> bool

true if the registry knows no relations at all. Cheap check used by list / detail handlers to skip the prefetch machinery entirely when the project has no annotations.

pub fn validate(&self, schema: &Schema) -> Vec<RegistryError>

Walk every stored relation and report declarations that reference models or columns not present in the schema. The macro’s compile-time checks already catch these for declared fields; this pass also covers hand-edited rustio.schema.json files (the AI pipeline writes those).

pub fn iter_belongs_to(&self) -> impl Iterator<Item = &ResolvedRelation>

A forward iterator over every ResolvedRelation in the registry, in deterministic order. Not called on hot paths; convenient for tests and CLI introspection commands.

Trait Implementations

impl Clone for RelationRegistry

fn clone(&self) -> RelationRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RelationRegistry

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

Formats the value using the given formatter.

impl Default for RelationRegistry

fn default() -> RelationRegistry

Returns the “default value” for a type.