cargo-gamma-lib 0.1.0

Internal library for cargo-gamma
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

// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.

//! Building the mutant schema once and running the test suite against each mutant.
//!
//! A run copies the workspace to a scratch tree, instruments every mutated file, builds the test
//! binaries once, measures a baseline with no mutant active, then runs the suite once per mutant
//! with `GAMMA_ACTIVE` naming the one that is live. Every test process, baseline included, gets
//! `CARGO_GAMMA=1` so a suite that drives cargo itself can opt out of a nested build.
//!
//! Mutants that cannot compile — replacing a return value with `Default::default()` when the type
//! is not `Default`, for instance — are attributed back to the guards that caused them, withdrawn,
//! and the build is retried; a handful of rollback rounds converges.

mod baseline;
mod build;
mod cargo_options;
mod census;
mod config;
mod copy;
mod events;
#[cfg(test)]
mod faults;
mod harness_filters;
mod incremental_mode;
mod killers;
mod loader;
mod manifest;
// Exposed to integration tests, which need to ask whether this host can bound memory at all before
// they can say what a run should have done. See `declare_modules!` in `lib.rs` for the convention.
mod measure;
#[cfg(feature = "internals")]
pub mod memory;
#[cfg(not(feature = "internals"))]
mod memory;
mod nextest;
mod progress;
#[cfg(target_os = "linux")]
pub(crate) mod relaunch;
mod session;
mod stall;
mod sweep;
mod sync;
mod test_binary;
mod verdict;
mod workspace;

#[doc(inline)]
pub use build::{OrderingHints, Round, Withdrawal};
#[doc(inline)]
pub use cargo_options::{BuildLimits, CargoOptions, DEFAULT_ROLLBACK_ROUNDS};
#[doc(inline)]
pub use config::Config;
pub(crate) use config::{available_parallelism, resolve_jobs};
#[doc(inline)]
pub use events::Events;
#[doc(inline)]
pub use incremental_mode::IncrementalMode;
#[doc(inline)]
pub use loader::UNDER_GAMMA_VAR;
pub(crate) use manifest::RUNTIME_CRATE;
pub(crate) use measure::run_with_locks;
#[doc(inline)]
pub use measure::{Built, Measured, Oracle, measure, run};
#[doc(inline)]
pub use memory::{DEFAULT_HEADROOM, DEFAULT_MULTIPLIER, Demand, MemoryControl, MemoryPolicy};
// Named for its subject at this level, where `support` alone would say nothing about what is
// supported. The module itself is private unless the `internals` feature exposes it.
pub(crate) use memory::{implied_memory_control, support as memory_support};
#[doc(inline)]
pub use session::{CensusCost, Phases, Session, SweepCost};
#[doc(inline)]
pub use test_binary::TestBinary;
pub(crate) use verdict::CONFIRM_FACTOR;
#[doc(inline)]
pub use verdict::READERS;
#[cfg(loom)]
pub(crate) use verdict::run_loom_models;
#[doc(inline)]
pub use workspace::{Workspace, clean_cache, footprint, gamma_base, scratch_tree};
pub(crate) use workspace::{claim_cache, claim_workspace};