Struct ModelColumn 

#[non_exhaustive]
pub struct ModelColumn {
    pub name: &'static str,
    pub sql_decl: &'static str,
    pub rust_type: RustType,
    pub nullable: bool,
    pub primary_key: bool,
    pub flags: SchemaFlags,
    pub admin_label: Option<&'static str>,
    pub admin_widget: Option<&'static str>,
}

One column in a model’s contract.

All fields are &'static references because the contract is built at compile time by #[derive(RustioModel)] (commit 2) and lives in static memory. No allocations on the hot path.

#[non_exhaustive] so future fields (e.g. references for FKs, default for column defaults) can be added without breaking.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: &'static str

Column name as it appears in SQL.

sql_decl: &'static str

Verbatim DDL fragment from the operator’s #[rustio(sql = "...")] attribute. The validator parses this when comparing against information_schema.columns. Examples: "BIGSERIAL PRIMARY KEY", "TEXT NOT NULL", "NUMERIC(12,2) NOT NULL DEFAULT 0".

rust_type: RustType

Rust type kind. The compatibility check goes through RustType::is_compatible_with.

nullable: bool

Whether the Rust field is Option<T>. When true, the validator expects PG to allow NULL on this column; mismatch is a validator error.

primary_key: bool

Whether this column is the table’s primary key. Exactly one column per ModelSchema should set this to true. Validation of that invariant is the validator’s job (commit 3).

flags: SchemaFlags

Admin / search flags.

admin_label: Option<&'static str>

Optional admin display label override. None means use the humanised column name ("full_name" → "Full name").

admin_widget: Option<&'static str>

Optional admin form widget hint ("textarea", "email", "tel", …). None means use the default for the RustType — <input type="text"> for String, <input type="number"> for I64, etc.

Implementations

impl ModelColumn

pub const fn new( name: &'static str, sql_decl: &'static str, rust_type: RustType, ) -> Self

Minimal column constructor — name, SQL DDL, Rust type. All flags default to false / None. Builder-style setters below opt into the rest.

const fn so the macro in commit 2 can use this directly inside static SCHEMA: ModelSchema = ... initialisers, and so external callers (tests, the future examples/freelance/ crate) can construct columns despite the #[non_exhaustive] attribute.

const ID: ModelColumn =
    ModelColumn::new("id", "BIGSERIAL PRIMARY KEY", RustType::I64)
        .primary_key();

pub const fn nullable(self) -> Self

Mark this column as nullable (the Rust field is Option<T>). The validator will require PG to allow NULL on the column.

pub const fn primary_key(self) -> Self

Mark this column as the table’s primary key. Exactly one column per ModelSchema should set this. The validator checks the invariant in commit 3.

pub const fn with_flags(self, flags: SchemaFlags) -> Self

Replace the column’s flags wholesale. Pair with SchemaFlags::searchable() / SchemaFlags::empty() / a struct literal (within the crate).

pub const fn with_label(self, label: &'static str) -> Self

Override the admin display label. None (the default) means the chrome humanises the column name (full_name → Full name).

pub const fn with_widget(self, widget: &'static str) -> Self

Override the admin form widget. Useful for upgrading a String column to <textarea> or to a typed input ("email", "tel").

Trait Implementations

impl Clone for ModelColumn

fn clone(&self) -> ModelColumn

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelColumn

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

Formats the value using the given formatter.