lora_database/
lib.rs

1//! In-memory Lora database — the database-facing orchestration layer.
2//!
3//! `lora-database` owns the parse → analyze → compile → execute pipeline
4//! and exposes a single [`Database`] entry point that transports (HTTP,
5//! benches, examples, embedded callers) can drive without knowing about the
6//! underlying crates.
7//!
8//! # Quick start
9//!
10//! ```no_run
11//! use lora_database::Database;
12//!
13//! let db = Database::in_memory();
14//! db.execute("CREATE (:User {name: 'alice'})", None).unwrap();
15//! ```
16
17mod database;
18mod error;
19mod explain;
20mod named;
21mod plan_cache;
22mod snapshot;
23mod stream;
24mod transaction;
25mod wal;
26
27pub use database::{Database, GraphDirection, QueryRunner};
28pub use error::{LoraError, LoraErrorCategory, LoraErrorCode};
29pub use explain::{OperatorMetrics, PlanShape, ProfileMetrics, QueryPlan, QueryProfile};
30pub use lora_compiler::{PlanTree, PlanTreeNode};
31pub use named::{
32    resolve_database_path, DatabaseName, DatabaseNameError, DatabaseOpenOptions,
33    DEFAULT_DATABASE_MAX_BYTES,
34};
35pub use snapshot::{
36    snapshot_credentials_from_json, snapshot_options_from_json, SnapshotAdmin, SnapshotByteFormat,
37    SnapshotConfig,
38};
39pub use stream::QueryStream;
40pub use transaction::{Transaction, TransactionError, TransactionMode};
41pub use wal::{WalAdmin, WalStatus};
42
43// Re-export the WAL configuration types so transports / operators can
44// build a `Database::open_with_wal` argument without taking a direct
45// `lora-wal` dependency.
46pub use lora_wal::{SyncMode, WalConfig};
47
48// Re-export the core execution types so callers don't need a direct
49// dependency on `lora-executor`.
50pub use lora_executor::{ExecuteOptions, LoraValue, QueryResult, ResultFormat, Row};
51
52// Re-export the default in-memory backing store so callers only need to
53// depend on `lora-database` for the happy path.
54pub use lora_store::InMemoryGraph;
55
56// Snapshot surface — re-exported so bindings/servers don't need a direct
57// `lora-store` dependency just to name the meta / error types.
58pub use lora_snapshot::{
59    Compression, EncryptionKey, PasswordKdfParams, SnapshotCredentials, SnapshotEncryption,
60    SnapshotInfo, SnapshotOptions, SnapshotPassword, DATABASE_SNAPSHOT_MAGIC,
61};
62pub use lora_store::{
63    NodeId, NodeRecord, RelationshipId, RelationshipRecord, SnapshotError, SnapshotMeta,
64};
65
66// Standalone parsing entry point (does not require building a `Database`).
67pub use lora_parser::parse_query;
lora_database/lib.rs

lora_database/
lib.rs
