persistant_relational/lib.rs
1// SPDX-License-Identifier: MIT OR Apache-2.0
2//! PersistAnt's relational kind: a **deliberately small** trait, no driver.
3//!
4//! `docs/DESIGN-KINDS.md` §3 rule 4 and D1 (C+): the trait runs a statement with parameters,
5//! begins a transaction, and reports the dialect and server version. It is not a query builder or
6//! a row mapper; a program that wants its own SQL checked at compile time (Humboldt's
7//! `sqlx::query!`) uses the concrete driver handle the driver crate hands out, not this trait. The
8//! trait exists so the key-value adapter, the capability matrix and migrations have one thing to
9//! call.
10//!
11//! Growth toward statement construction would turn this into Option B (§4.2) and carry its leaks;
12//! resist it.
13
14mod backend;
15pub mod choose;
16pub mod conformance;
17pub mod contract;
18mod error;
19mod migrate;
20pub mod migrate_conformance;
21mod secret;
22pub mod speed;
23#[cfg(feature = "sql")]
24mod sql_ext;
25mod sweep;
26mod value;
27
28pub use backend::{Isolation, RelationalBackend, RelationalTx};
29pub use error::RelError;
30pub use migrate::{MigrateError, MigrateReport, Migrates, Migration};
31pub use secret::{ConnectionSecret, Redacted};
32pub use sweep::{SweepError, SweepReport, sweep};
33pub use value::{Dialect, Row, Value};
34
35#[cfg(feature = "sql")]
36pub use sql_ext::{RelationalSqlExt, RelationalTxSqlExt, Sql};
37/// `Query`, `Rendered`, `Target` and `Binding`: what `persistant::sql!` expands to (UniSQL's
38/// `unisql-embed`, re-exported so a consumer depends on neither).
39#[cfg(feature = "sql")]
40pub use unisql_embed as embed;