Skip to main content

cratestack_sql/
lib.rs

1//! Dialect-agnostic SQL primitives shared by the Postgres (`cratestack-sqlx`)
2//! and SQLite (`cratestack-rusqlite`) backends.
3//!
4//! This crate carries the type definitions every backend agrees on:
5//!
6//! - [`SqlValue`] / [`SqlColumnValue`] — value envelopes used to bind data
7//! - [`CreateModelInput`] / [`UpdateModelInput`] / [`UpsertModelInput`] —
8//!   traits the codegen emits
9//! - [`Filter`] / [`FilterExpr`] / [`FieldRef`] — query AST
10//! - [`OrderClause`] / [`SortDirection`] — ordering AST
11//! - [`ModelDescriptor`] / [`ModelColumn`] / [`CreateDefault`] — schema
12//!   metadata baked into compiled code by `include_schema!`
13//!
14//! Rendering SQL strings, executing queries, and any DB-driver coupling
15//! live in the backend crates.
16
17mod descriptor;
18mod dialect;
19mod filter;
20mod order;
21mod values;
22
23pub use descriptor::{CreateDefault, CreateDefaultType, ModelColumn, ModelDescriptor};
24pub use dialect::{Dialect, PostgresDialect, SqliteDialect};
25pub use filter::{
26    CoalesceExpr, CoalesceFilter, FieldRef, Filter, FilterExpr, FilterOp, IntoColumnName,
27    JsonFilter, JsonTextPath, RelationFilter, RelationQuantifier, SpatialFilter, SpatialPoint,
28    coalesce, point,
29};
30pub use order::{NullOrder, OrderClause, OrderTarget, SortDirection};
31pub use values::{
32    ConflictTarget, CreateModelInput, FilterValue, IntoSqlValue, ModelPrimaryKey, Projection,
33    RelationInclude, SqlColumnValue, SqlValue, UpdateModelInput, UpsertModelInput,
34    find_duplicate_sql_value,
35};