rustango-orm-macros 0.46.0

ORM-only proc-macros for rustango — Model / Form / embed_migrations. Carve-out of rustango-macros for the standalone rustango-orm crate.
Documentation

rustango-orm-macros

Proc-macros for the standalone rustango-orm crate — ORM-only carve-out of rustango-macros.

This crate exposes only the three proc-macros the ORM core actually needs:

Macro What it does
#[derive(Model)] Populates <T>::SCHEMA, generates inherent methods (insert / save / delete / find / where_* / sum / etc.), and registers the model with the inventory crate.
#[derive(Form)] Validates user input + parses it into a strongly-typed struct.
embed_migrations! Bakes a migrations/ directory's .json files into a &'static [(name, content)] slice at compile time.

The framework-only derives (Serializer, ViewSet, Q!, #[rustango::main]) live in rustango-macros and are intentionally not re-exported here. Consumers that depend only on rustango-orm-macros literally cannot reach them — that's the carve-out half of issue #143.

Quickstart

[dependencies]
rustango-orm-macros = "0.42"
# Until rustango-orm itself ships (issue #144), pull in `rustango` for the runtime:
rustango = { version = "0.42", default-features = false, features = ["sqlite"] }

use rustango::sql::Auto;
use rustango_orm_macros::Model;

#[derive(Model, Debug, Clone)]
#[rustango(table = "post")]
pub struct Post {
    #[rustango(primary_key)]
    pub id: Auto<i64>,
    #[rustango(max_length = 200)]
    pub title: String,
}

Why a separate crate?

The orm-extract epic (#149) carves the rustango ORM out of the framework crate so projects that want Django-shaped models against an existing database can pull in the ORM bits without admin / tenancy / templates / auth / etc.

This rustango-orm-macros crate is the first physical-move slice of that epic. Today it's a thin re-exporter over rustango-macros. Once #144 lands (the runtime carve-out), the proc-macro bodies migrate here and rustango-macros drops them — completing the split.

How proc-macro re-export works

Rust's resolver follows pub use paths to find a proc-macro's defining crate. Writing use rustango_orm_macros::Model; resolves to pub use rustango_macros::Model;, walks back to the proc-macro = true crate where the derive is actually defined, and invokes its entry point. Because of this resolution chain, the re-exporter itself doesn't need proc-macro = true — it's a regular [lib] crate.

License

MIT OR Apache-2.0 — same as rustango.