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;
15#[cfg(feature = "catalog")]
16pub mod catalog;
17pub mod choose;
18pub mod conformance;
19pub mod contract;
20mod error;
21mod migrate;
22pub mod migrate_conformance;
23mod secret;
24pub mod speed;
25#[cfg(feature = "sql")]
26mod sql_ext;
27mod sweep;
28mod value;
29
30pub use backend::{Isolation, RelationalBackend, RelationalTx};
31pub use error::RelError;
32pub use migrate::{MigrateError, MigrateReport, Migrates, Migration};
33pub use secret::{ConnectionSecret, Redacted};
34pub use sweep::{SweepError, SweepReport, sweep};
35pub use value::{Dialect, Row, Value};
36
37#[cfg(feature = "sql")]
38pub use sql_ext::{RelationalSqlExt, RelationalTxSqlExt, Sql};
39/// `Query`, `Rendered`, `Target` and `Binding`: what `persistant::sql!` expands to (UniSQL's
40/// `unisql-embed`, re-exported so a consumer depends on neither).
41#[cfg(feature = "sql")]
42pub use unisql_embed as embed;