processkit 3.2.0

Async child-process management for tokio: whole-tree kill-on-drop (no orphans), plus streaming, pipelines, timeouts, and supervision
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

# Mutation-testing scope for the `mutants` CI tier (.github/workflows/mutants.yml).
#
# cargo-mutants mutates library code and re-runs the test suite to check that a
# mutated build still fails a test (a "missed" mutant means the tests didn't
# notice). Running it over the whole crate would also mutate the FFI/subprocess
# layer (src/running/**, src/sys/**, src/supervisor.rs), where most functions
# talk to a real child process or a platform API — a mutant there either fails
# to build (compile errors in an FFI shim on the "wrong" OS) or only gets
# caught after paying for a real process spawn/kill, which is exactly what
# makes this tier slow and noisy without adding a useful signal.
#
# The scope is limited to hermetic, pure-logic modules that are fully
# exercised by fast unit tests with no live subprocess: the line-decode pump
# (pump.rs), the capture buffer's cap/eviction logic (buffer.rs), the backoff/
# retry policy (retry.rs), the run outcome classification (result.rs) and the
# error type (error.rs). The shared backoff math, stable cassette digest and
# resource-limit value logic are similarly self-contained. command.rs remains
# deliberately excluded: its ~350 possible mutants span filesystem probing and
# launch construction, nearly doubling the tier and eroding the 10-shard budget.
# Grow this list module-by-module as hermetic coverage matures rather than
# widening it wholesale.
examine_globs = [
    "src/pump.rs",
    "src/buffer.rs",
    "src/backoff.rs",
    "src/digest.rs",
    "src/limits.rs",
    "src/retry.rs",
    "src/result.rs",
    "src/error.rs",
]

# Belt-and-suspenders: explicitly keep the FFI/real-subprocess layer out of
# scope even if examine_globs above is ever widened by mistake.
exclude_globs = [
    "src/running/**",
    "src/sys/**",
    "src/supervisor.rs",
]

# Keep TIMEOUT as a hang detector, not a shortcut that can mask a slow test
# failure: cargo-mutants waits for the greater of 6x the baseline test time or
# 30 seconds. The workflow documents this tolerance policy and still fails on
# every MISSED mutant.
timeout_multiplier = 6
minimum_test_timeout = 30

# Build with every feature enabled so feature-gated code in the examined
# modules (e.g. the `limits`-gated Error variants in error.rs) is mutated and
# checked too — matches how the rest of CI exercises the crate (see stress.yml).
additional_cargo_args = ["--all-features"]