procpilot 0.7.0

Production-grade subprocess runner with typed errors, retry, and timeout
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

[package]
name = "procpilot"
version = "0.7.0"
edition = "2024"
rust-version = "1.91"
description = "Production-grade subprocess runner with typed errors, retry, and timeout"
license = "MIT OR Apache-2.0"
repository = "https://github.com/michaeldhopkins/procpilot"
homepage = "https://github.com/michaeldhopkins/procpilot"
readme = "README.md"
keywords = ["subprocess", "process", "command", "retry", "timeout"]
categories = ["os", "development-tools"]
# Dev-only files excluded from the published crate.
exclude = [
    "scripts/",
    ".github/",
    "CLAUDE.md",
    "cliff.toml",
    "clippy.toml",
    "deny.toml",
]

[features]
# Internal feature gating mock test binaries and integration tests. Not
# intended for downstream consumers. Enabled automatically in CI and when
# running `cargo test --all-features` locally.
mock-binaries = []

# Opt-in async variants (`Cmd::run_async`, `Cmd::spawn_async`) for use
# from inside a tokio runtime. Off by default — sync-only consumers
# pay nothing.
tokio = ["dep:tokio", "backon/tokio-sleep"]

# Opt-in test doubles: `MockRunner` and result-builder helpers for unit
# tests of code that takes `&dyn Runner`. Off by default — production
# builds don't compile mock infrastructure.
testing = []

# Mock test binaries. Prefixed `pp_` and gated behind the `mock-binaries`
# feature so they aren't built during `cargo install procpilot`. During
# `cargo test --all-features`, cargo builds them and sets
# `CARGO_BIN_EXE_pp_*` so the integration tests can reach them.

[[bin]]
name = "pp_cat"
path = "src/bin/pp_cat.rs"
required-features = ["mock-binaries"]

[[bin]]
name = "pp_echo"
path = "src/bin/pp_echo.rs"
required-features = ["mock-binaries"]

[[bin]]
name = "pp_sleep"
path = "src/bin/pp_sleep.rs"
required-features = ["mock-binaries"]

[[bin]]
name = "pp_status"
path = "src/bin/pp_status.rs"
required-features = ["mock-binaries"]

[[bin]]
name = "pp_print_env"
path = "src/bin/pp_print_env.rs"
required-features = ["mock-binaries"]

[[bin]]
name = "pp_print_env_multi"
path = "src/bin/pp_print_env_multi.rs"
required-features = ["mock-binaries"]

[[bin]]
name = "pp_pwd"
path = "src/bin/pp_pwd.rs"
required-features = ["mock-binaries"]

[[bin]]
name = "pp_spam"
path = "src/bin/pp_spam.rs"
required-features = ["mock-binaries"]

[[bin]]
name = "pp_child_grandchild"
path = "src/bin/pp_child_grandchild.rs"
required-features = ["mock-binaries"]

# Integration test that depends on the mock binaries. Skipped when
# `mock-binaries` is off so `cargo test` (without feature flag) still
# works for unit tests.
[[test]]
name = "runner"
path = "tests/runner.rs"
required-features = ["mock-binaries"]

[[test]]
name = "spawned"
path = "tests/spawned.rs"
required-features = ["mock-binaries"]

[[test]]
name = "pipeline"
path = "tests/pipeline.rs"
required-features = ["mock-binaries"]

[[test]]
name = "async_runner"
path = "tests/async_runner.rs"
required-features = ["mock-binaries", "tokio"]

[[test]]
name = "mock_runner"
path = "tests/mock_runner.rs"
required-features = ["testing"]

[package.metadata.docs.rs]
all-features = true
rustdoc-args = ["--cfg", "docsrs"]

[dependencies]
backon = { version = "1", default-features = false, features = ["std", "std-blocking-sleep"] }
os_pipe = "1.2.3"
shared_child = "1.1.1"
tokio = { version = "1", features = ["process", "io-util", "rt", "time", "sync", "macros"], optional = true }
wait-timeout = "0.2"

[dev-dependencies]
anyhow = "1"
tempfile = "3"
tokio = { version = "1", features = ["macros", "rt", "rt-multi-thread", "time", "sync", "io-util"] }

[lints.clippy]
struct-excessive-bools = "deny"
fn-params-excessive-bools = "deny"
collapsible-if = "deny"
too-many-arguments = "deny"
needless-range-loop = "deny"
extend_with_drain = "deny"
unwrap_used = "deny"
match_bool = "warn"
bool_to_int_with_if = "warn"
cognitive-complexity = "warn"
too-many-lines = "warn"