Struct RuleCoverage 

pub struct RuleCoverage {
    pub by_rule: BTreeMap<RuleId, BTreeSet<String>>,
    pub by_class: BTreeMap<PayloadClass, BTreeSet<RuleId>>,
}

Accumulates (payload, rule_id) observations from live bench runs and exposes coverage analytics used by the --coverage-report flag.

Two complementary indices are maintained:

• by_rule — rule_id → set of distinct payloads that triggered it
• by_class — payload_class → set of rule_ids it has reached

Both are updated atomically on every record call so the coverage report is always consistent.

Fields

by_rule: BTreeMap<RuleId, BTreeSet<String>>

rule_id → set of payload fingerprints (first 64 chars) observed.

by_class: BTreeMap<PayloadClass, BTreeSet<RuleId>>

payload_class → set of rule_ids reached from that class.

Implementations

impl RuleCoverage

pub fn new() -> Self

Create an empty coverage tracker.

pub fn record(&mut self, payload: &str, rule_id: Option<&str>)

Record one (payload, rule_id) observation.

rule_id = None means the request was not blocked (or the block reason couldn’t be extracted) — the payload class is still indexed in by_class under a synthetic sentinel so “no rule triggered” coverage is visible in the report.

pub fn coverage_report(&self) -> String

Produce a human-readable coverage summary.

Each line is rule_id payload_count separated by a tab, sorted by rule id. Suitable for --coverage-report output.

pub fn rule_count(&self) -> usize

Number of distinct rule IDs observed so far.

pub fn triggered_rules(&self) -> Vec<&RuleId>

Rules that have been triggered at least once in this run.

pub fn to_json(&self) -> Result<String, Error>

Serialize the coverage map to compact JSON.

Errors

Returns serde_json::Error if serialization fails (only possible if the in-memory types contain non-string-keyed maps, which they cannot for BTreeMap<RuleId, _>).

pub fn from_json(json: &str) -> Result<Self, Error>

Deserialize a coverage map from JSON produced by to_json.

Errors

Returns serde_json::Error on malformed JSON.

Trait Implementations

impl Clone for RuleCoverage

fn clone(&self) -> RuleCoverage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RuleCoverage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RuleCoverage

fn default() -> RuleCoverage

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RuleCoverage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RuleCoverage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.