Struct Catalog 

pub struct Catalog {
    pub tables: Vec<RegisteredTable>,
    pub edges: Vec<RegisteredEdge>,
    pub filter_columns: Vec<FilterColumn>,
}

In-memory catalog of registered tables, edges, and filter columns.

Fields

tables: Vec<RegisteredTable>

Registered node tables.

edges: Vec<RegisteredEdge>

Registered edge mappings.

filter_columns: Vec<FilterColumn>

Optional filter columns indexed at query time.

Implementations

impl Catalog

pub fn new() -> Self

Creates an empty catalog.

pub const fn validate_for_build(&self) -> Result<(), CatalogError>

Returns whether registration is sufficient to run a snapshot rebuild.

Errors

Returns CatalogError::EmptyCatalog when no tables are registered.

Performance

This method is O(1).

pub fn add_table(&mut self, table: RegisteredTable) -> Result<(), CatalogError>

Registers a node table after validating uniqueness.

Errors

Returns CatalogError when ids or names collide.

Performance

This method is O(t) where t is the number of registered tables.

pub fn add_edge(&mut self, edge: RegisteredEdge) -> Result<(), CatalogError>

Registers an edge mapping after validating endpoint tables exist.

Errors

Returns CatalogError when endpoints are missing or ids collide.

Performance

This method is O(t + e).

pub fn add_filter_column( &mut self, column: FilterColumn, ) -> Result<(), CatalogError>

Registers a filter column for search indexing.

Errors

Returns CatalogError when the table id is unknown.

Performance

This method is O(t + f).

pub fn table(&self, id: TableId) -> Option<&RegisteredTable>

Looks up a registered table by id.

pub fn from_registration_rows( tables: impl IntoIterator<Item = RegisteredTable>, edges: impl IntoIterator<Item = RegisteredEdge>, filter_columns: impl IntoIterator<Item = FilterColumn>, ) -> Result<Self, CatalogError>

Hydrates a catalog from registration rows (SPI adapters collect rows first).

Errors

Returns CatalogError when any registration row violates catalog invariants.

Performance

This method is O(t + e + f) for table, edge, and filter row counts.

Trait Implementations

impl Clone for Catalog

fn clone(&self) -> Catalog

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Catalog

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

Formats the value using the given formatter.

impl Default for Catalog

fn default() -> Catalog

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Catalog

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Catalog

fn eq(&self, other: &Catalog) -> 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 Catalog

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Catalog

impl StructuralPartialEq for Catalog