Skip to main content

hyprstream_util/
lib.rs

1// Leaf-path timing probe: wave D finish-line measurement (comment-only change).
2// Rustdoc quality lane pilot (docs/rustdoc-quality.md): this crate opted in
3// to `missing_docs` for its public API. The lint is scoped here rather than in
4// `[workspace.lints]` so each crate measures its own baseline and opts in
5// deliberately.
6//
7// The `not(clippy)` guard isolates the lint from Clippy: clippy-driver runs
8// rustc's lint passes, so a plain `warn(missing_docs)` would be promoted to a
9// hard error by the repository-wide `cargo clippy … -- -D warnings` (the PR
10// Clippy job and the pre-commit hook) as soon as any public item is
11// undocumented — turning the lane's "warnings are non-blocking evidence"
12// contract false as it expands. Under clippy the attribute is inert; under
13// plain rustc/rustdoc it stays active, so `cargo doc` emits the warnings and
14// the scoped strict-evidence run (`RUSTDOCFLAGS="-D warnings"`) still
15// escalates them. See docs/rustdoc-quality.md for the warning policy and the
16// Clippy/rustdoc isolation probe results.
17#![cfg_attr(not(clippy), warn(missing_docs))]
18
19//! Shared generic utility primitives for hyprstream.
20//!
21//! Home for small, dependency-light, domain-agnostic data structures used
22//! across crates. Kept a leaf crate so any hyprstream crate can depend on it
23//! without pulling domain weight.
24//!
25//! Currently exports:
26//! * [`TtlCache`] — generic per-entry-TTL cache with lazy version-tagged
27//!   eviction and a capacity bound.
28
29pub mod ttl_cache;
30
31pub use ttl_cache::{InsertIfAbsentNoEvictResult, TtlCache};