Expand description
§MockForge Virtual Backend Reality (VBR) Engine
The VBR engine creates stateful mock servers with persistent virtual databases, auto-generated CRUD APIs, relationship constraints, session management, and time-based data evolution.
§Overview
VBR acts like a mini real backend with:
- Persistent virtual database (SQLite, JSON, in-memory options)
- CRUD APIs auto-generated from entity schemas
- Relationship modeling and constraint enforcement
- User session & auth emulation
- Time-based data evolution (data aging, expiring sessions)
§Example Usage
use mockforge_vbr::{VbrEngine, VbrConfig};
let config = VbrConfig::default()
.with_storage_backend(mockforge_vbr::StorageBackend::Sqlite {
path: "./data/vbr.db".into(),
});
let engine = VbrEngine::new(config).await?;
// Define entities and generate living APIRe-exports§
pub use config::StorageBackend;pub use config::VbrConfig;pub use database::VirtualDatabase;pub use entities::Entity;pub use entities::EntityRegistry;pub use mutation_rules::ComparisonOperator;pub use mutation_rules::MutationOperation;pub use mutation_rules::MutationRule;pub use mutation_rules::MutationRuleManager;pub use mutation_rules::MutationTrigger;pub use schema::ManyToManyDefinition;pub use schema::VbrSchemaDefinition;pub use snapshots::SnapshotMetadata;pub use snapshots::TimeTravelSnapshotState;
Modules§
- aging
- Time-based data evolution
- api_
generator - CRUD API generator
- auth
- Authentication emulation
- config
- VBR engine configuration
- constraints
- Constraint enforcement
- database
- Virtual database abstraction
- entities
- Entity management and registry
- handlers
- Runtime request handlers
- id_
generation - ID generation utilities
- integration
- HTTP integration layer
- migration
- Database migration system
- mutation_
rules - Time-triggered data mutation rules
- openapi
- OpenAPI integration for VBR
- scheduler
- Background task scheduler
- schema
- VBR schema extensions
- seeding
- Data seeding functionality
- session
- Session integration
- snapshots
- State snapshot and reset functionality
Structs§
- VbrEngine
- Main VBR engine
Enums§
- Error
- Core error types for MockForge operations
Type Aliases§
- Result
- Result type alias for MockForge operations