Manager & SeaORM helpers

SeaORM + Objects Manager

Runique uses SeaORM with a Django-like manager via the impl_objects! macro.

The macro is automatically generated by the daemon in each entity file (runique makemigrations). No manual declaration needed.

Note: impl_objects! is pure syntactic sugar. It does not modify the generated queries — the SQL produced is identical to native SeaORM.

use demo_app::entities::users;

// Retrieve all users
let all_users = users::Entity::objects
    .all()
    .all(&db)
    .await?;

// With filter
let active_users = users::Entity::objects
    .filter(users::Column::Active.eq(true))
    .all(&db)
    .await?;

// Single result
let user = users::Entity::objects
    .filter(users::Column::Id.eq(user_id))
    .first(&db)
    .await?;

// All records
let all_users = users::Entity::find().all(&db).await?;

// With filter
let active_users = users::Entity::find()
    .filter(users::Column::Active.eq(true))
    .all(&db)
    .await?;

// Single result by ID
let user = users::Entity::find_by_id(user_id)
    .one(&*db)
    .await?;

For common cases, the search! macro provides a more concise syntax than native SeaORM chaining:

use runique::search;

// Equivalent to objects.filter(Col::Active.eq(true))
let active = search!(users::Entity => Active eq true)
    .all(&db).await?;

// Multi-condition (AND)
let results = search!(users::Entity =>
    Active eq true,
    Age gte 18,
    Status in ["active", "verified"],
)
.limit(20)
.all(&db)
.await?;

See CRUD Queries — search! macro for the full reference.

When a form is annotated with #[form(model = Entity)], Runique automatically generates:

• The FormEntity trait implementation (linking the form to its entity)
• A pub const objects constant on the form, identical to Entity::objects

#[form(schema = user_schema, model = users::Entity)]
pub struct UserForm;

// Access objects via the form — equivalent to users::Entity::objects
let user = UserForm::objects
    .filter(users::Column::Id.eq(id))
    .first(&db)
    .await?;

let all = UserForm::objects
    .all()
    .all(&db)
    .await?;

The @Form syntax in search! automatically delegates to the linked entity:

// Equivalent to search!(users::Entity => Active eq true)
let active = search!(@UserForm => Active eq true)
    .all(&db).await?;

// All search! syntaxes are supported
let results = search!(@UserForm =>
    Active eq true,
    Age gte 18,
    Status in ["active", "verified"],
)
.limit(20)
.all(&db)
.await?;

The FormEntity trait is defined in runique::forms. It is implemented automatically — no manual declaration required.