Expand description
Shared runtime, configuration, presentation, retry, time, and node-protocol utilities for WoW Lab.
Modules§
- casing 🔒
- cli
- Shared CLI bootstrap utilities.
- env 🔒
- fmt
- markdown
- mermaid
- node_
http - HTTP wire contracts shared by simulation nodes and Sentinel.
- node_
public_ 🔒key - node_
realtime 🔒 - Realtime messages shared by simulation nodes and Sentinel.
- output
- Shared CLI output formatting.
- prompt
- Interactive CLI prompts with consistent styling.
- retry
- Deterministic retry-delay schedules without transport policy or sleeping.
- runtime 🔒
- Runtime work-expansion protocol shared by sentinel and node; payloads serialize as camelCase JSON.
- sim
- Simulation config building and parsing.
- sys
- Platform-specific system information: CPU, memory, load averages.
- time
- Cross-platform time helpers via
web-time(native and wasm).
Structs§
- Claim
Token - Opaque claim token (UUID string) issued by sentinel when it assigns a chunk.
- EnvError
- Errors raised by environment-variable helpers in this crate.
- EnvLoader
- Loads environment variables with a common prefix, supporting required, optional, and secret values.
- Invalid
Node Public Key - Error returned when a base64 string cannot be decoded into a valid 32-byte public key.
- Node
Public Key - A node’s Ed25519 public key (32 bytes, base64-encoded for display/storage).
- Process
Environment - Adapter backed by the current process environment.
- Project
Identity - Identifies an application for platform-specific project directories.
- Runtime
Chunk Id - Monotonic per-job identifier for a runtime chunk (a batch of work items).
- Runtime
Chunk Payload - A batch of work items assigned to one node in one Centrifuge publication.
- Runtime
Work Item - One abstract unit of work in a runtime chunk, derived from
kindand routed bytag. - Runtime
Work Result - Compact result for one executed work item, mirroring the
BatchWorkResultproto. - Work
Context Hash - SHA-256 digest of
(base_sim_config, TournamentPayload, sentinel_config), serialized as lowercase hex. - Work
Context Hash Parse Error - Error returned when a
WorkContextHashhex string is malformed.
Enums§
- Node
Realtime Message - Message published on a node’s
nodes:{public_key}realtime channel. - Runtime
Work Fidelity - Result fidelity requested for a work item.
- Runtime
Work Item Kind - What a work item evaluates, carrying the parameters needed to derive a concrete sim config.
Traits§
- Environment
- Source of process-style key/value configuration.
Functions§
- config_
dir - Return the platform-specific config directory, checking an env override first.
- data_
dir - Return the platform-specific data directory, checking an env override first.
- ensure_
query_ param - Append a query parameter to a URL if it is not already present.
- env_or
- Read an environment variable, returning a default if not set.
- env_
or_ with - Read a value through an injected environment, returning a default when absent.
- get_
raw_ env - Read an unprefixed value from the process environment.
- require_
env - Read a required environment variable.
- require_
env_ with - Read a required value through an injected environment.
- snake_
to_ camel - Convert a
snake_caseidentifier tocamelCase.