plumb_core/
lib.rs

1//! # plumb-core
2//!
3//! Core types and the deterministic rule engine for Plumb.
4//!
5//! This crate is the foundation every other Plumb crate builds on. It
6//! defines the public [`Violation`] shape, the [`Rule`] trait, the
7//! [`Config`] schema, and the in-memory [`PlumbSnapshot`] type that rule
8//! engines evaluate.
9//!
10//! ## Determinism invariants
11//!
12//! `plumb-core` must produce byte-identical output across runs. The crate
13//! forbids `std::time::SystemTime::now` and `std::time::Instant::now` via
14//! `clippy::disallowed_methods`, never logs to stdout or stderr, and uses
15//! deterministic iteration order everywhere ([`indexmap`] instead of
16//! [`std::collections::HashMap`] for any observable output).
17//!
18//! See `docs/local/prd.md` §9 for the full invariant list.
19
20#![forbid(unsafe_code)]
21#![doc(
22    html_logo_url = "https://raw.githubusercontent.com/aram-devdocs/plumb/main/assets/brand/plumb-mark.svg",
23    html_favicon_url = "https://raw.githubusercontent.com/aram-devdocs/plumb/main/theme/favicon.svg"
24)]
25#![deny(missing_docs)]
26#![deny(clippy::print_stdout, clippy::print_stderr)]
27#![deny(clippy::unwrap_used, clippy::expect_used)]
28
29pub mod config;
30pub mod engine;
31pub mod report;
32pub mod rules;
33pub mod snapshot;
34pub mod telemetry;
35
36pub use config::{Config, IgnoreRule};
37pub use engine::{RunReport, apply_ignores, run, run_many, run_report};
38pub use report::{
39    Confidence, Fix, FixKind, Rect, RunId, Severity, ViewportKey, Violation, ViolationSink,
40};
41pub use rules::{Rule, RuleMetadata, builtin_rule_metadata, register_builtin};
42pub use snapshot::{PlumbSnapshot, SnapshotCtx, TextBox};
plumb_core/lib.rs

plumb_core/
lib.rs
