How tschwarzinger/rdf-fusion works
RDF Fusion is an experimental, embeddable SPARQL engine built on DataFusion, with CLI, HTTP, WebAssembly, and browser-playground entry points. A typical CLI workflow loads RDF into a selected storage backend, parses and plans SPARQL queries, executes them against a storage snapshot, then returns or serializes results. The graph also preserves the documented dump/optimize and Parquet-query capabilities. Several subsystem connections are dashed because the relevant implementation was not sampled; the browser worker and core query path have direct excerpt evidence.
Main entry points: evaluate_query.rs Query evaluator · engine.rs Engine context · main.rs CLI commands · storage.rs DeltaQuads storage
Components 21
User interfaces
- CLI commands
cli/src/main.rs - SPARQL HTTP
lib/web/src/repositories - Wasm API
lib/wasm/src/lib.rs
SPARQL query
- SPARQL parser
lib/sparql-parser/src/parser/query.rs - Query AST
lib/sparql-parser/src/ast/mod.rs
Planning and execution
- Engine context
lib/execution/src/engine.rs - Query evaluator
lib/execution/src/sparql/evaluate_query.rs - Query optimizer
lib/execution/src/sparql/optimizer.rs - Logical planning
lib/logical/src/logical_plan_builder.rs - Physical planning
lib/execution/src/planner.rs - Query results
lib/execution/src/results/mod.rs - SPARQL functions
lib/functions/src/registry.rs
Data and storage
- Quad encodings
lib/encoding/src/quad_storage_encoding.rs - DeltaQuads storage
lib/storage/src/delta/storage.rs - Parquet storage
lib/storage/src/parquet/storage.rs
Browser playground
- Playground UI
misc/pages/svelte/playground/main.js - Engine manager
misc/pages/svelte/playground/engine.js - Worker proxy
misc/pages/svelte/playground/engineProxy.js - Engine worker
misc/pages/svelte/playground/engineWorkerSource.js - Version cache
misc/pages/svelte/playground/db.js
Other components
- CLI user
Connections 22
- CLI user → CLI commands: runs commands
README.md - CLI commands → DeltaQuads storage: loads or dumps
README.md - CLI commands → Parquet storage: queries
README.md - CLI commands → SPARQL HTTP: serves endpoint
README.md - SPARQL parser → Query AST: builds AST
lib/sparql-parser/src/parser/query.rs - Engine context → Query evaluator: invokes
lib/execution/src/engine.rs - Engine context → SPARQL functions: registers functions
lib/execution/src/engine.rs - Engine context → DeltaQuads storage: uses storage
- Query evaluator → Query optimizer: applies rules
lib/execution/src/sparql/evaluate_query.rs - Query evaluator → Physical planning: plans execution
lib/execution/src/sparql/evaluate_query.rs - Query evaluator → Query results: returns streams
lib/execution/src/sparql/evaluate_query.rs - Query evaluator → Logical planning: uses logical plan
- Physical planning → DeltaQuads storage: scans snapshot
- Physical planning → Parquet storage: scans snapshot
- DeltaQuads storage → Quad encodings: selects encoding
lib/storage/src/delta/storage.rs - SPARQL HTTP → Engine context: evaluates queries
- Wasm API → Engine context: exposes engine
- Playground UI → Engine manager: manages engine
- Engine manager → Version cache: reads and writes
misc/pages/svelte/playground/engine.js - Engine manager → Worker proxy: creates proxy
misc/pages/svelte/playground/engine.js - Worker proxy → Engine worker: sends messages
misc/pages/svelte/playground/engineProxy.js - Engine worker → Wasm API: loads and calls
misc/pages/svelte/playground/engineWorkerSource.js