Crate xerv_core

Crate xerv_core 

Source
Expand description

XERV Core Library

This crate provides the foundational types, traits, and implementations for the XERV orchestration platform.

§Overview

XERV (Executable Server) is a zero-copy, event-driven orchestration platform that bridges visual automation with systems engineering.

§Key Components

  • Arena: Memory-mapped append-only storage for zero-copy data sharing
  • WAL: Write-Ahead Log for durability and crash recovery
  • Types: Strongly-typed identifiers and pointers
  • Traits: Core abstractions for nodes, triggers, and schemas

§Example

ⓘ
use xerv_core::prelude::*;

// Create an arena for a trace
let trace_id = TraceId::new();
let config = ArenaConfig::default();
let arena = Arena::create(trace_id, &config)?;

// Write data
let ptr = arena.write(&MyData { value: 42 })?;

// Read data back (zero-copy)
let archived = arena.read(ptr)?;

Re-exports§

pub use arena::Arena;
pub use arena::ArenaConfig;
pub use error::Result;
pub use error::XervError;
pub use flow::EdgeDefinition;
pub use flow::FlowDefinition;
pub use flow::FlowSettings;
pub use flow::NodeDefinition;
pub use flow::TriggerDefinition;
pub use traits::Node;
pub use traits::NodeInfo;
pub use traits::PipelineConfig;
pub use traits::Schema;
pub use traits::Trigger;
pub use traits::TriggerType;
pub use types::ArenaOffset;
pub use types::NodeId;
pub use types::RelPtr;
pub use types::TraceId;
pub use value::Value;
pub use wal::Wal;
pub use wal::WalConfig;

Modules§

arena
Memory-mapped append-only arena for zero-copy data sharing.
error
Error types for XERV.
flow
Flow definition types for YAML deserialization.
logging
Structured logging for trace execution.
prelude
Prelude for convenient imports.
schema
Schema evolution system for XERV.
testing
Deterministic replay testing framework.
traits
Core traits for XERV components.
types
Core types for XERV.
value
Dynamic value type for condition evaluation.
wal
Write-Ahead Log (WAL) for durability and crash recovery.

Macros§

assert_inline_snapshot
Inline snapshot assertion (snapshot embedded in test).