postrust_core/
lib.rs

1//! Postrust Core - PostgREST-compatible REST API for PostgreSQL in Rust.
2//!
3//! This crate provides the core functionality for Postrust, a serverless
4//! alternative to PostgREST written in Rust.
5//!
6//! # Architecture
7//!
8//! The request processing pipeline:
9//!
10//! 1. **API Request Parsing** (`api_request`) - Parse HTTP request into domain types
11//! 2. **Schema Cache** (`schema_cache`) - PostgreSQL metadata for validation
12//! 3. **Query Planning** (`plan`) - Convert request to execution plan
13//! 4. **SQL Generation** (`query`) - Generate parameterized SQL
14//! 5. **Response Formatting** - Format results for HTTP response
15//!
16//! # Example
17//!
18//! ```text
19//! use postrust_core::{ApiRequest, SchemaCache, create_action_plan};
20//!
21//! // Parse HTTP request
22//! let request = parse_request(&http_request, "public", &schemas)?;
23//!
24//! // Create execution plan
25//! let plan = create_action_plan(&request, &schema_cache)?;
26//!
27//! // Generate SQL
28//! let (sql, params) = build_query(&plan)?;
29//! ```
30
31// The `Error` enum carries a rich `DatabaseError` payload (PostgREST-style error
32// bodies), which makes it larger than clippy's `Result`/enum size thresholds.
33// Boxing it would ripple through every construction site for little benefit, so
34// the size lints are allowed crate-wide instead.
35#![allow(clippy::result_large_err)]
36#![allow(clippy::large_enum_variant)]
37
38pub mod api_request;
39pub mod config;
40pub mod error;
41pub mod plan;
42pub mod query;
43pub mod schema_cache;
44
45// Re-export main types
46pub use api_request::{
47    parse_request, Action, ApiRequest, DbAction, Filter, LogicTree, MediaType, Mutation, Operation,
48    Payload, PreferRepresentation, Preferences, QualifiedIdentifier, QueryParams, Range, Resource,
49    SelectItem,
50};
51pub use config::{AppConfig, IsolationLevel, LogLevel};
52pub use error::{Error, Result};
53pub use plan::{create_action_plan, ActionPlan, CallPlan, DbActionPlan, MutatePlan, ReadPlan};
54pub use schema_cache::{Column, Relationship, Routine, SchemaCache, SchemaCacheRef, Table};
55
56/// Prelude for common imports.
57pub mod prelude {
58    pub use super::api_request::{
59        parse_request, Action, ApiRequest, Filter, MediaType, Preferences, QualifiedIdentifier,
60        QueryParams, Range, SelectItem,
61    };
62    pub use super::config::AppConfig;
63    pub use super::error::{Error, Result};
64    pub use super::plan::{create_action_plan, ActionPlan};
65    pub use super::schema_cache::{SchemaCache, SchemaCacheRef, Table};
66}
postrust_core/lib.rs

postrust_core/
lib.rs
