Skip to main content

Module oracle

Module oracle 

Source
Expand description

Scenario-driven oracle harness for comparing eggress with pproxy.

This module provides a structured framework for running equivalent scenarios against both pproxy and eggress, normalizing outputs, and generating JSON comparison reports.

§Gating

Oracle differential tests are gated on EGRESS_PPROXY_CERTIFY=1 and require Python 3 with pproxy==2.7.9 installed. Structural tests that need no pproxy run without any gate variable.

Modules§

observations
probes
profile
report
Oracle JSON report generation.
scenario
Oracle scenario definitions and registry.
schema
supervisor

Constants§

DEFAULT_IO_TIMEOUT
Default timeout for I/O operations.
DEFAULT_SCENARIO_TIMEOUT
Default timeout for oracle scenario execution.
DEFAULT_STARTUP_TIMEOUT
Default timeout for process startup.
ORACLE_GATE_VAR
Environment variable that gates oracle differential tests.

Functions§

oracle_gate_enabled
Check if the oracle test gate is enabled.
require_oracle_gate
Require the oracle gate to be enabled. Panics with a clear message if not.