How czxieddan/rnovmodulardb works
RNovModularDB is a modular Rust database for embedded and edge workloads. Its principal workflow accepts SQL through a local session or TCP line protocol, parses and binds it, plans and executes it, and maintains database state in memory or encrypted single-file storage. Separate capabilities cover transactions, indexing and full-text search, authorization and row/column protection, Wasm scalar UDFs, and file inspection, backup, restore, upgrade, and key rotation. The README documents these product surfaces; many internal crate-to-crate calls are not shown in the excerpts, so those links are marked unverified.
Main entry points: memory.rs Memory executor · lib.rs Local session / CLI · logical.rs Logical planning · binder.rs Binder
Components 26
Interfaces
- Local session / CLI
crates/rnmdb-cli/src/lib.rs - TCP SQL protocol
crates/rnmdb-server/src/sql_protocol.rs - CLI output
crates/rnmdb-cli/src/output.rs
SQL Engine
- SQL lexer
crates/rnmdb-sql/src/lexer.rs - SQL parser / AST
crates/rnmdb-sql/src/parser.rs - SQL AST
crates/rnmdb-sql/src/ast.rs - Binder
crates/rnmdb-sql/src/binder.rs - Logical planning
crates/rnmdb-planner/src/logical.rs - Plan costing
crates/rnmdb-planner/src/cost.rs - Plan optimization
crates/rnmdb-planner/src/optimizer.rs - Memory executor
crates/rnmdb-executor/src/memory.rs - Sorting
crates/rnmdb-executor/src/memory/sort.rs - Set operations
crates/rnmdb-executor/src/memory/set_ops.rs - Vector batches
crates/rnmdb-executor/src/vector.rs
State and Storage
- Catalog
crates/rnmdb-catalog/src/lib.rs - Transactions
crates/rnmdb-txn/src/lib.rs - Encrypted storage
crates/rnmdb-storage/src/lib.rs - Legacy upgrade
crates/rnmdb-storage/src/single_file_upgrade/legacy.rs - Page-key rotation
crates/rnmdb-storage/src/single_file_rekey.rs
Query Features
- Indexes
crates/rnmdb-index/src/lib.rs - Full-text search
crates/rnmdb-fts/src/lib.rs
Security and Extensions
- Authorization / policies
crates/rnmdb-security/src/lib.rs - Column encryption
crates/rnmdb-executor/src/column_crypto.rs - Wasm UDF runtime
crates/rnmdb-udf/src/wasm_runtime.rs - Instance isolation
crates/rnmdb-instance/src/lib.rs
Other components
- Application / operator
Connections 30
- Application / operator → Local session / CLI: submits SQL
README.md - Application / operator → TCP SQL protocol: sends SQL
README.md - Local session / CLI → SQL lexer: accepts SQL
- TCP SQL protocol → SQL parser / AST: routes SQL
- SQL lexer → SQL parser / AST: tokenizes for
- SQL parser / AST → SQL AST: builds AST
- SQL AST → Binder: binds statements
crates/rnmdb-sql/src/binder.rs - Binder → Catalog: resolves metadata
- Binder → Logical planning: plans bound SQL
- Logical planning → Plan costing: estimates plans
crates/rnmdb-planner/src/cost.rs - Logical planning → Plan optimization: optimizes plans
- Logical planning → Memory executor: executes plans
- Memory executor → Sorting: delegates sorting
crates/rnmdb-executor/src/memory.rs - Memory executor → Set operations: delegates set ops
crates/rnmdb-executor/src/memory.rs - Memory executor → Vector batches: produces batches
crates/rnmdb-executor/src/memory.rs - Memory executor → Catalog: reads catalog
- Memory executor → Indexes: uses indexes
- Memory executor → Full-text search: supports search
README.md - Memory executor → Transactions: applies transactions
README.md - Local session / CLI → Encrypted storage: opens durable state
README.md - Local session / CLI → Memory executor: runs statements
README.md - Local session / CLI → CLI output: formats results
- Encrypted storage → Legacy upgrade: upgrades v1 files
crates/rnmdb-storage/src/lib.rs - Encrypted storage → Page-key rotation: rotates page keys
crates/rnmdb-storage/src/lib.rs - Application / operator → Legacy upgrade: requests upgrade
README.md - Application / operator → Page-key rotation: requests rotation
README.md - Local session / CLI → Authorization / policies: authorizes operations
README.md - Memory executor → Column encryption: decrypts columns
crates/rnmdb-executor/src/memory.rs - Memory executor → Wasm UDF runtime: runs scalar UDFs
README.md - Instance isolation → Local session / CLI: isolates sessions
README.md