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
145
146
147
148
149
150
name: CI
on:
push:
branches:
pull_request:
branches:
env:
CARGO_TERM_COLOR: always
RUSTFLAGS: "-D warnings"
# Run every JS action on Node.js 24 ahead of GitHub's forced migration,
# silencing "Node.js 20 actions are deprecated" runner warnings.
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
jobs:
test:
name: Test (${{ matrix.os }} / ${{ matrix.rust }})
runs-on: ${{ matrix.os }}
strategy:
fail-fast: false
matrix:
# x86_64 and aarch64 on every OS: macos-latest is aarch64 only, so
# macos-15-intel covers x86_64 macOS (dev/PLAN.md, D-009).
os:
- ubuntu-latest
- ubuntu-24.04-arm
- macos-latest
- macos-15-intel
- windows-latest
- windows-11-arm
rust:
steps:
- uses: actions/checkout@v5
- uses: dtolnay/rust-toolchain@master
with:
toolchain: ${{ matrix.rust }}
components: clippy, rustfmt
- uses: Swatinem/rust-cache@v2
- name: Format
run: cargo fmt --all -- --check
- name: Clippy (default features)
run: cargo clippy --all-targets -- -D warnings
- name: Clippy (all features)
run: cargo clippy --all-targets --all-features -- -D warnings
- name: Clippy (no default features)
run: cargo clippy --all-targets --no-default-features -- -D warnings
- name: Test (default features)
run: cargo test
- name: Test (all features)
run: cargo test --all-features
- name: Test (no default features)
run: cargo test --no-default-features
- name: Build examples
run: cargo build --examples
# Both modes: a doc link to a feature-gated item breaks only when that
# feature is off (dev/PLAN.md, D-010).
- name: Doc (default features)
run: cargo doc --no-deps
env:
RUSTDOCFLAGS: "-D warnings"
- name: Doc (all features)
run: cargo doc --no-deps --all-features
env:
RUSTDOCFLAGS: "-D warnings"
cross:
name: Check (${{ matrix.target }} / ${{ matrix.rust }})
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
target:
- x86_64-unknown-linux-musl
- i686-pc-windows-msvc
- aarch64-linux-android
- aarch64-apple-ios
rust:
steps:
- uses: actions/checkout@v5
- uses: dtolnay/rust-toolchain@master
with:
toolchain: ${{ matrix.rust }}
targets: ${{ matrix.target }}
components: clippy
- uses: Swatinem/rust-cache@v2
with:
key: ${{ matrix.target }}
- name: Check (default features)
run: cargo check --target ${{ matrix.target }}
- name: Check (all features)
run: cargo check --target ${{ matrix.target }} --all-features
- name: Check (no default features)
run: cargo check --target ${{ matrix.target }} --no-default-features
- name: Clippy (all features)
run: cargo clippy --target ${{ matrix.target }} --all-features -- -D warnings
no-subprocess:
name: No subprocess at run time
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5
- name: Only the build helper may start a program
shell: bash
run: |
set -euo pipefail
# 1. std::process::Command anywhere in src/ outside the build helper
# (src/build.rs, src/build/).
std_hits=$(grep -rnE 'Command::new|process::Command|process::\{[^}]*\bCommand\b' src --include='*.rs' \
| grep -vE '^src/build(\.rs|/)' || true)
# 2. Process-creation calls declared or called in the OS modules.
# Names followed by `(` (a declaration or a call); comment lines are
# skipped so prose such as "a system call" does not match.
ffi_hits=$(grep -rnE '\b(CreateProcess(A|W|AsUserW)?|ShellExecute(Ex)?W|WinExec)\b|\b(posix_spawnp?|execv[pe]?|execl[pe]?|popen|v?fork|system)[[:space:]]*\(' src/sys --include='*.rs' 2>/dev/null \
| grep -vE '^[^:]+:[0-9]+:[[:space:]]*//' || true)
if [ -n "$std_hits$ffi_hits" ]; then
echo "sys-lib never runs a program at run time (dev/PLAN.md, D-004)."
echo "$std_hits"
echo "$ffi_hits"
exit 1
fi
echo "No subprocess found outside the build helper."
package:
name: Package
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5
- uses: dtolnay/rust-toolchain@stable
- uses: Swatinem/rust-cache@v2
- name: Package
run: cargo package
security:
name: Security (audit + deny)
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5
- uses: dtolnay/rust-toolchain@stable
- uses: Swatinem/rust-cache@v2
- name: Install cargo-audit and cargo-deny
uses: taiki-e/install-action@v2
with:
tool: cargo-audit,cargo-deny
- name: Generate lockfile
run: cargo generate-lockfile
- name: Audit
run: cargo audit
- name: Deny
run: cargo deny check