Struct Rules 

pub struct Rules {
    pub table: FormatTable,
    pub registry: Registry,
    /* private fields */
}

The rules files loaded for one run.

The format table and the converter registry must declare the same version. That shared version is recorded in every record as rules_version.

Fields

table: FormatTable

The format table from rules/formats.toml.

registry: Registry

The converter registry from rules/converters.toml.

Implementations

impl Rules

pub fn builtin() -> Result<Self>

The rules compiled into the binary.

pub fn builtin_with_inventory(inventory: &RuntimeInventory) -> Result<Self>

The rules compiled into the binary, with the deployment’s runtime-inventory paths wired into the pinned-engine converters. The expected hashes stay in the rules; the inventory supplies only paths.

pub fn builtin_with_runtime( inventory: &RuntimeInventory, provider: Option<&ProviderConfig>, ) -> Result<Self>

The rules compiled into the binary, with the deployment’s runtime-inventory paths and its external provider configuration wired in.

A configured provider changes the effective rules version, so enabling, disabling, moving to different pinned executables, or changing the adapter re-runs every affected source instead of skipping it as unchanged. A configuration this build cannot run leaves the version alone and marks the run instead.

pub fn from_parts(table: FormatTable, registry: Registry) -> Result<Self>

Rules over an explicit format table and registry, for a caller that compiled its own rules rather than the built-in ones. No provider is wired, so the effective version is the shared numeric version of the two tables.

pub fn from_parts_with_runtime( table: FormatTable, registry: Registry, provider: Option<&ProviderConfig>, ) -> Result<Self>

Rules over an explicit table and registry with the provider configuration the registry was built against, so the effective version carries the provider’s identity exactly as the built-in constructor’s does.

pub fn version(&self) -> &str

The effective rules version, recorded in every record.

pub fn provider_not_built(&self) -> bool

Whether a configured provider could not be built into this binary.