polydat 0.2.0

Polydat — a variates construction engine
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

// Copyright 2024-2026 Jonathan Shook
// SPDX-License-Identifier: Apache-2.0

//! Standard Polydat function-node library + sampling primitives + library-internal support.
//!
//! - Function-node modules (`arithmetic`, `string`, `hash`, …):
//!   the 250+ built-in [`crate::ast::PolydatNode`] implementations
//!   workload authors compose into kernels.
//! - [`sampling`]: alias tables, LUT interpolation, ICD —
//!   variate-sampling building blocks consumed by
//!   distribution-emitting nodes (weighted, probability, etc.).
//! - [`support`]: library-internal infrastructure
//!   ([`support::cache`], [`support::audit`]) used by nodes
//!   like [`vectors`] for caching dataset handles and
//!   diagnosing data-source mismatches.

pub mod sampling;
pub mod support;

pub mod hash;
pub mod arithmetic;
pub mod bitwise;
pub mod identity;
pub mod convert;
pub mod polyfill;
pub mod polyfill_narrow;
pub mod polyfill_128;
pub mod polyfill_complete;
pub mod vector_math;
pub mod register;
pub mod fixed;
pub mod string;
pub mod datetime;
pub mod diagnostic;
pub mod encoding;
pub mod lerp;
pub mod format;
pub mod bytebuf;
pub mod digest;
pub mod weighted;
pub mod regex;
pub mod context;
pub mod noise;
pub mod json;
pub mod random;
pub mod realer;
pub mod probability;
pub mod pcg;
pub mod math;
pub mod round_numbers;
pub mod datafile;
pub mod param_helpers;
pub mod assertions;
pub mod compare;
pub mod pick;
pub mod exactly_one;
pub mod log_levels;
pub mod partition;
pub mod stability;
#[cfg(feature = "vectordata")]
pub mod vectors;

/// Env-gated debug-level diagnostic for selection / matching nodes.
///
/// Returns true when `NBRS_DEBUG_NODES` is set to a non-empty,
/// non-`"0"` value. Cached on first read so the variable can be set
/// once at process start and the per-cycle check is a load.
///
/// Used by `regex_match`, `exactly_one_value`, and `pick` to emit
/// pre-eval / pre-panic context (input shape, match result, selector
/// states) when probe phases produce surprising values. The user's
/// expected workflow:
///
/// ```sh
/// NBRS_DEBUG_NODES=1 nbrs run my-workload …
/// ```
///
/// then read the stderr trace to see what each matching node saw.
pub fn debug_nodes_enabled() -> bool {
    use std::sync::OnceLock;
    static ENABLED: OnceLock<bool> = OnceLock::new();
    *ENABLED.get_or_init(|| {
        std::env::var("NBRS_DEBUG_NODES")
            .map(|v| !v.is_empty() && v != "0")
            .unwrap_or(false)
    })
}