Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
117 commits
Select commit Hold shift + click to select a range
734bb15
Fix the ListBuilder entry-array regression and five smaller issues fo…
claude Oct 30, 2026
24055fc
Cap the DuckDB bindings range below 2.1 and ship an allow-list package
claude Oct 30, 2026
bc704b9
ci: run the six upstream-comparison guards through scripts/upstream-g…
claude Oct 30, 2026
c459420
inline_paths: use lambda syntax DuckDB 2.0.0 accepts (identical to th…
claude Oct 30, 2026
453057c
ci: check-ci-aggregate.py no longer passes while a gate is removed (C…
claude Oct 30, 2026
691c160
Use the new lambda syntax in the ListBuilder regression test's oracle
claude Oct 30, 2026
a0b6ede
ci: a release commit with a stale lockfile now fails in minutes, not …
claude Oct 30, 2026
05637f6
release: compare the .crate with the attested hash before uploading i…
claude Oct 30, 2026
3b743e8
ChunkWriter: count claimed rows honestly and add release_row (UNSOUND-1)
claude Oct 30, 2026
afdfe81
ci: lint every workflow with actionlint, checksum-pinned (CI-11)
claude Oct 30, 2026
2f76e0a
ci: cache examples/hello-ext's own target dir in the three jobs that …
claude Oct 30, 2026
3777d35
ci: scaffold-compile cannot pass by running zero tests (CI-8)
claude Oct 30, 2026
68219a5
docs: README front page, libduckdb-sys range, 0.20 snippets, DuckDB 2…
claude Oct 30, 2026
e1e9154
arrow import: refuse offsets, lengths and indices DuckDB reads out of…
claude Oct 30, 2026
329a9da
ci: pin the Rust toolchain to 1.99.1; an informational job tracks the…
claude Oct 30, 2026
887d286
ci: fold in Dependabot #145 by hand; check the scaffold's action pins…
claude Oct 30, 2026
7f9494b
Cap type-nesting walks and clamp the cardinality hint (HARDEN-6, HARD…
claude Oct 30, 2026
6f82cab
repo: typos, taplo and editorconfig configs; cargo-deny config for th…
claude Oct 30, 2026
800158c
ci: a `hygiene` job (typos, taplo, cargo-machete) and cargo-deny over…
claude Oct 30, 2026
177c6d3
repo: clippy.toml says its three thresholds are clippy's defaults (DE…
claude Oct 30, 2026
c090656
Overload guard: compare types the way DuckDB resolves overloads (AUTH…
claude Oct 30, 2026
1fdebe7
scripts: check-api-coverage.py counts only library code as wrapping a…
claude Oct 30, 2026
c5ec763
Let closure-built scalars be overloads of a set: overload_typed (AUTH…
claude Oct 30, 2026
415f03a
scripts: two upstream guards no longer pass on a reshaped upstream (C…
claude Oct 30, 2026
a7486eb
docs: correct the author-review findings (bind cannot set a return ty…
claude Oct 30, 2026
fc04b3d
docs: pitfalls L20, L21, P16, P17 and the corrected L3/L11, known-lim…
claude Oct 30, 2026
4d01183
docs: community-extension conformance in publishing.md (reserved name…
claude Oct 30, 2026
a24b6f0
docs: SECURITY.md's supported versions are true for 0.20.0; MIN_RELEA…
claude Oct 30, 2026
ded401a
Scalar bind data: report a panicking Clone, free a replaced value (FF…
claude Oct 30, 2026
ee8fdb5
docs: RELEASING.md matches what release.yml does: lockfiles, hotfix f…
claude Oct 30, 2026
87c1886
docs: CONTRIBUTING states the sanitizer blind spot, the toolchain pol…
claude Oct 30, 2026
0e1640f
docs: upgrade guide 0.18 -> 0.20, scaffold prerequisites, SQLLogicTes…
claude Oct 30, 2026
09d4a40
docs: RELEASING's hotfix section says what a merge into main does, an…
claude Oct 30, 2026
c68ff31
scripts: check-matrix.sh stops if it cannot cd to the repository root…
claude Oct 30, 2026
0f9d06b
WarningCollector: keep at most 10,000 warnings between drains (HARDEN-8)
claude Oct 30, 2026
c8ee393
docs: ChunkWriter claimed-row rule, prepared-parameter bind constants…
claude Oct 30, 2026
ad1ac1d
Aggregates: name the catalog entry that holds a taken name (FFI-8)
claude Oct 30, 2026
126dad5
Test SecretEntry's zeroize against the process's real memory (harden …
claude Oct 30, 2026
4d87fe4
docs: document the landed core fixes (release_row, overload_typed, bi…
claude Oct 30, 2026
350a6e6
Mark AbiCheck, AbiPolicy, ConfigOptionScope and TlsVersion #[non_exha…
claude Oct 30, 2026
71c3ed0
abi: say precisely what the bindings read before the guard (FFI-4); k…
claude Oct 30, 2026
4dbb312
connection: document what the collision scans cost on a large catalog…
claude Oct 30, 2026
b833f5a
Merge the infra work package: CI, release and repo-hygiene fixes
claude Oct 30, 2026
65ee0c1
Pin the runner images and make the pin checker enforce it
claude Oct 30, 2026
e99bed0
docs: hedge the DuckDB 2.1 loading statement, state what hello-ext's …
claude Oct 30, 2026
4076505
Apply the bindings cap to the auxiliary manifests and document how to…
claude Oct 30, 2026
b4f2278
description.yml: read every section as PyYAML does, in linear time (C…
claude Oct 30, 2026
b1fc841
Live tests for three seventh-review changes mutants survived (LASTDIF…
claude Oct 30, 2026
b58dd28
Show docs.rs feature badges: #![cfg_attr(docsrs, feature(doc_cfg))] (…
claude Oct 30, 2026
cdbf719
WarningCollector::emit: release the lock explicitly (clippy significa…
claude Oct 30, 2026
49e0747
Entry-point macros: #[unsafe(no_mangle)], refuse panic = "abort", say…
claude Oct 30, 2026
d6907cd
Refuse extension names DuckDB itself uses: aliases and core extension…
claude Oct 30, 2026
b2b2eca
scalar_agg: the DECIMAL(18,2)/DECIMAL(18,3) set is refused now (AUTHT…
claude Oct 30, 2026
9e1daaf
Register in one transaction so a failed LOAD leaves nothing behind (F…
claude Oct 30, 2026
8c411a6
Value: read ARRAY and UNION values, and BIT / BIGNUM without the C ge…
claude Oct 30, 2026
be83b1d
docs: document the landed entry-point, ABI and conformance changes (r…
claude Oct 30, 2026
6e455df
Query metadata before execution, raw-handle round trips, Appender::fo…
claude Oct 30, 2026
7e75aa1
Typed, tag-checked extra info and COPY state
claude Oct 30, 2026
5aed6b1
FileHandle and ClientContext are Send; keep a file open across COPY c…
claude Oct 30, 2026
8f2c72d
Allowlist: caveats for the still-unwrapped log-storage and vector-ass…
claude Oct 30, 2026
81c6165
docs: keep wide table cells from clipping (upgrade guide row, Arrow t…
claude Oct 30, 2026
bcb12c4
Cross-engine runs: fix the hostile-name test for 1.4.4, state the gua…
claude Oct 30, 2026
201a5c7
Merge the api work package: ARRAY/UNION/BIT/BIGNUM values, statement …
claude Oct 30, 2026
b364d7a
docs: project tree lists the files the core, entry-point and scaffold…
claude Oct 30, 2026
327939d
Merge the coreb work package: edition-safe macros, panic=abort refusa…
claude Oct 30, 2026
4cf2847
List duckdb_open and duckdb_close as host-side in the API coverage al…
claude Oct 30, 2026
1de7909
docs: duckdb-1-5* extensions load only into verified releases (README…
claude Oct 30, 2026
f441729
docs: panic = abort refusal in the pitfalls and known limitations, re…
claude Oct 30, 2026
47ec982
docs: project tree lists the api work package's files
claude Oct 30, 2026
90d397f
Merge the corea work package: ChunkWriter, Arrow offsets, overload gu…
claude Oct 30, 2026
32e8d64
Refuse a macro statement that does not parse, instead of executing it
claude Oct 30, 2026
2268a93
docs: duckdb_query runs the statements before a parse error on DuckDB…
claude Oct 30, 2026
af52f36
docs: soften the 2.0 parse-error wording to what was measured
claude Oct 30, 2026
054d4e3
docs: running-sql wording matches the measurement
claude Oct 30, 2026
b0d7d00
docs: the scaffold chapter and publishing page follow the quack_scaff…
claude Oct 30, 2026
4352070
docs: upgrade guide rows for the scaffold, append_metadata and build-…
claude Oct 30, 2026
b34f9d4
docs: license file naming of the scaffold
claude Oct 30, 2026
f2186d0
Merge the docs work package: tutorial, pitfalls, conformance docs, up…
claude Oct 30, 2026
44f67d7
Correct rustdoc the engines contradict, and guard LESSONS.md against …
claude Oct 30, 2026
be8bcee
Scaffold: native example, SPDX expressions, platform checks, skip gua…
claude Oct 30, 2026
bde00ec
Add the quack_scaffold binary: write a generated project to disk
claude Oct 30, 2026
e0393ca
append_metadata: exclusive random temp file, keep mode, follow a link…
claude Oct 30, 2026
8139643
build.rs: forward QUACK_RS_TARGET_DUCKDB_VERSION only as an all-digit…
claude Oct 30, 2026
13210b7
hello-ext: gen_series_v2 refuses a value past BIGINT and uses the gua…
claude Oct 30, 2026
ef97dd5
build.rs: stop polling for headers libduckdb-sys has already said are…
claude Oct 30, 2026
6664103
Merge the scaffold work package: PyYAML-accurate description.yml, res…
claude Oct 30, 2026
c9e7984
docs: list the scaffold work package's files in the repository trees
claude Oct 30, 2026
895261d
quack_scaffold tests: assert_eq! on the empty platform list, not asse…
claude Oct 30, 2026
03cc120
Tests review: LeakSanitizer can fail again, parse_version refuses a s…
claude Oct 30, 2026
17ae52e
oracle_temporal: do not ask DuckDB 2.0.0 for timestamps it cannot render
claude Oct 30, 2026
2fb5027
Upstream guards: a moved file or a changed layout fails, and so does …
claude Oct 30, 2026
691e887
Scaffold tests: a missing PyYAML, python3, make or git fails the Linu…
claude Oct 30, 2026
a7cab59
Mutation gate: say what it cannot see, ship the audit tool that sees …
claude Oct 30, 2026
41195d7
mutants.toml: mutate the plain functions in callback.rs
claude Oct 30, 2026
caf3852
Test that every manifest states the same libduckdb-sys requirement
claude Oct 30, 2026
5576dbb
api-coverage allowlist: duckdb_extract_statements_error is used now
claude Oct 30, 2026
2ed7f15
Release 0.20.0: version, lockfiles, CHANGELOG, snippets, check counts
claude Oct 30, 2026
9f5cdad
Docs: say what was observed, not which review observed it
claude Oct 30, 2026
c5c7be7
typos: fix the findings the hygiene job would fail on; CHANGELOG: our…
claude Oct 30, 2026
904258d
CHANGELOG, upgrade guide: ScalarBindInfo is no longer RefUnwindSafe
claude Oct 30, 2026
cbf17e8
AUDIT.md section 14: the eighth review; one doc backtick clippy only …
claude Oct 30, 2026
50ab8c2
AUDIT.md 14.8: the book doctests on the final tree (255 pass, 5 ignored)
claude Oct 30, 2026
6005f64
CI fixes from the first full run: Windows dead code, macOS file names…
claude Oct 30, 2026
cd874bb
CI: find the build script under Cargo's new layout; do not cache targ…
claude Oct 30, 2026
928b1a8
append_metadata tests: a Unix-only helper and import are Unix-only (W…
claude Oct 30, 2026
e9072f4
hostile_input: stop registering a type the engine cannot render; pin …
claude Oct 30, 2026
2be944d
append_metadata_cli: keep the size-limited child's coverage profile o…
claude Oct 30, 2026
947b2c8
ffi_roundtrip: install parquet once per process, with ICU, so Windows…
claude Oct 30, 2026
4036f7a
AUDIT 14.8 and 14.10: what the pull request's CI found, and what it t…
claude Oct 30, 2026
1249dc4
Kill the mutants the incremental mutation job reported, and make lice…
claude Oct 30, 2026
94613f7
Miri job: fit it in its time limit; kill the mutation survivors that …
claude Oct 30, 2026
adfde73
Mutation Testing: shard the incremental job over eight runners
claude Oct 30, 2026
a54f76d
arrow import layout: a list-view entry of zero is not negative
claude Oct 30, 2026
3953109
description.yml reader: three disagreements with PyYAML, a linear val…
claude Oct 30, 2026
4c23fe0
description.yml reader: 33 tests that kill the mutants the sharded ru…
claude Oct 30, 2026
28a8c44
Fix the two CI failures on 4c23fe0: a typo and the stale source trees
claude Oct 30, 2026
7627f84
description.yml reader: a flow key must share a line with its colon a…
claude Oct 30, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 13 additions & 1 deletion .cargo/mutants.toml
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,10 @@ features = ["duckdb-1-5-4"]
# Thin re-export modules and test-only code produce unproductive mutants.
exclude_globs = [
"src/prelude.rs", # pure re-exports
"src/callback.rs", # macro-generated FFI wrappers (untestable without DuckDB runtime)
# src/callback.rs is not excluded: the macros in it are invisible to
# cargo-mutants, but catch_ffi_panic, panic_message, panic_c_message and
# message_to_c_string are plain functions. `cargo mutants --no-config
# --file src/callback.rs --cargo-arg=--lib`: 5 mutants, 4 caught, 1 unviable.
"src/chunk_writer.rs", # Drop calls FFI; row tracking tested via unit tests
"src/vector/struct_writer.rs", # thin delegation to VectorWriter (requires DuckDB runtime)
"src/vector/struct_reader.rs", # thin delegation to VectorReader (requires DuckDB runtime)
Expand Down Expand Up @@ -225,6 +228,15 @@ exclude_re = [
# with the one asked for, which needs duckdb_create_logical_type; with the
# comparison inverted, every type creation fails end to end.
"src/types/logical_type/construct.rs:.*replace != with == in LogicalType::try_new",
# construct.rs: LogicalType::refuse_where_the_engine_lacks asks the engine for
# its version (abi::engine_version reads the dispatch table), so a --lib run
# with no engine cannot reach the TIMESTAMPTZ_NS refusal. Both its mutants
# (the body replaced with Ok(()), and `==` to `!=`) were run by hand against
# libduckdb 1.5.6: tests/ffi_roundtrip/timestamp_tz_ns.rs
# `the_type_id_is_reported_for_a_column_and_creatable_only_where_it_exists`
# passes unmutated and fails with each. The pure comparison it uses,
# predates_timestamp_tz_ns, stays in the gate.
"src/types/logical_type/construct.rs:.*LogicalType::refuse_where_the_engine_lacks",
# error_data.rs: a non-null ErrorData only comes from DuckDB, and
# is_null / has_error / message / Drop / check_valid_utf8 are only told
# apart from their mutants with one (duckdb_error_data_* /
Expand Down
46 changes: 46 additions & 0 deletions .editorconfig
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# SPDX-License-Identifier: MIT
# https://editorconfig.org -- the whitespace rules the repository already follows
# (`.gitattributes` fixes LF; no tracked .rs/.toml/.md/.yml/.py/.sh file lacks a
# final newline or has trailing whitespace in Rust), written down so an editor
# without rustfmt on save does not drift.
root = true

[*]
charset = utf-8
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true
indent_style = space
indent_size = 4

[*.{yml,yaml}]
indent_size = 2

[*.sh]
indent_size = 2

# Markdown keeps trailing double-space line breaks and mixed list indents.
[*.md]
trim_trailing_whitespace = false
indent_size = unset

# Makefiles (and the Makefile text generated by the scaffold) need tabs.
[{Makefile,*.mk}]
indent_style = tab

[*.{png,bin}]
charset = unset
end_of_line = unset
insert_final_newline = unset
trim_trailing_whitespace = unset
indent_style = unset
indent_size = unset

# Fuzz seeds must reach the fuzzer byte for byte (.gitattributes: binary).
[fuzz/seeds/**]
charset = unset
end_of_line = unset
insert_final_newline = unset
trim_trailing_whitespace = unset
indent_style = unset
indent_size = unset
8 changes: 8 additions & 0 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,14 @@ updates:
- "minor"

# ── Cargo dependencies for the hello-ext example ─────────────────────────────
# No duckdb / libduckdb-sys ignore here, on purpose. The root lockfile is held
# on the DuckDB 1.5.6 bindings for the 1.86 MSRV (above); the example is not
# bound by that and tracks the newest bindings (DuckDB 2.0's, 1.20000.x, as
# of 0.20.0). It is the one place CI builds them into a real cdylib and loads
# it into every pinned DuckDB (example-check, symbol-check, extension-load),
# so a bindings PR here is the first signal of a new DuckDB release, tested
# by those jobs on the PR itself. Its committed lockfile needs Rust 1.88
# (examples/hello-ext/README.md says so).
- package-ecosystem: cargo
directory: "/examples/hello-ext"
schedule:
Expand Down
1 change: 1 addition & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@
### Code quality
- [ ] `cargo test --all-targets` passes, and `cargo test --doc --features duckdb-1-5-4` (doctests are not in `--all-targets`)
- [ ] The end-to-end tests pass against a real libduckdb (CONTRIBUTING, gate 2c) when the change touches `unsafe`, vectors, or function registration
- [ ] `cargo test --doc --manifest-path book/doctest/Cargo.toml` passes when the change touches `book/src/` or `README.md` (every Rust block there is compiled; gate 2c)
- [ ] `cargo clippy --all-targets -- -D warnings` passes
- [ ] `cargo fmt` applied (no diff)
- [ ] `cargo doc --no-deps` builds without warnings
Expand Down
55 changes: 44 additions & 11 deletions .github/workflows/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,15 +10,15 @@ This directory contains all GitHub Actions workflows for the quack-rs project.
| Workflow | File | Trigger | Purpose |
|----------|------|---------|---------|
| **CI** | `ci.yml` | Push to `main`/`claude/**`, PRs to `main`, weekly schedule, manual, called by `release.yml` | Every quality gate (table below), summarised by the `ci-ok` job |
| **Release** | `release.yml` | Semver tags (`vX.Y.Z`, and `vX.Y.Z-pre` prereleases) | Full release pipeline: validate the tag, run all of `ci.yml`, package with SLSA attestation, publish to crates.io (approval required), check crates.io serves the attested `.crate`, GitHub release, versioned-book deploy |
| **Release** | `release.yml` | Semver tags (`vX.Y.Z`, and `vX.Y.Z-pre` prereleases) | Full release pipeline: validate the tag and the release metadata, run all of `ci.yml`, package with SLSA attestation, publish to crates.io (approval required; the `.crate` is re-packaged and compared with the attested hash before the upload), check crates.io serves the attested `.crate`, GitHub release, versioned-book deploy |
| **Documentation** | `docs.yml` | Push to `main`, manual, dispatched by `release.yml` after a release | Build the versioned book (latest release at `/`, each release line at `/vX.Y/`, `main` at `/dev/`) and deploy to GitHub Pages |
| **Coverage** | `coverage.yml` | Push to `main`, PRs to `main` | Generate LCOV coverage report and upload to Codecov |
| **Mutation Testing** | `mutants.yml` | Manual dispatch, PRs to `main` | Verify tests detect code changes via cargo-mutants |
| **Benchmarks** | `benchmarks.yml` | Push to `main` (bench/src changes), manual | Run criterion benchmarks and archive reports |
| **Benchmarks** | `benchmarks.yml` | Push to `main` (changes under `benches/` or `src/`, or to `Cargo.toml` / `Cargo.lock`), manual | Run criterion benchmarks and archive reports |

## Quality gates (enforced by CI)

Every job in `ci.yml` must be green before merging a PR, except the three marked
Every job in `ci.yml` must be green before merging a PR, except the four marked
informational. This table is generated from `ci.yml`; the hand-written list it
replaced had drifted to fewer than half the jobs.

Expand All @@ -35,6 +35,7 @@ replaced had drifted to fewer than half the jobs.
| `wasm` | WASM (wasm32-unknown-emscripten) | blocking |
| `clippy` | Clippy | blocking |
| `clippy-beta` | Clippy (beta, informational) | informational |
| `latest-stable` | Latest stable Rust (informational) | informational |
| `fmt` | Format | blocking |
| `doc` | Documentation | blocking |
| `msrv` | MSRV (1.86.0) | blocking |
Expand All @@ -56,20 +57,25 @@ replaced had drifted to fewer than half the jobs.
| `publish-dry-run` | Publish dry-run | blocking |
| `security` | Security (cargo-deny) | blocking |
| `osv-scan` | Security (OSV / GHSA) | blocking |
| `hygiene` | Hygiene (typos, taplo, machete) | blocking |
| `nightly` | Nightly (informational) | informational |
| `miri` | Miri (undefined behaviour) | blocking |
| `leak-check` | LeakSanitizer (RAII wrappers vs a real DuckDB) | blocking |
| `asan` | AddressSanitizer | blocking |
| `semver` | Public API (semver-checks) | blocking |
| `fuzz` | Fuzz (smoke) | blocking |
| `workflow-lint` | Workflow lint (actionlint) | blocking |
| `ci-ok` | CI passed | blocking (aggregate) |

**Branch protection should require exactly one check: `CI passed`** (the
`ci-ok` job). It `needs:` every blocking job and runs with `if: always()`, so
it fails when any of them fails or is cancelled.
`scripts/check-ci-aggregate.py` (run by the `doc` job) fails when a blocking
job is missing from its `needs`, so a new job cannot drop out of the required
set unnoticed. `release.yml` runs this whole workflow as its CI gate
set unnoticed; it also fails when a job turns informational without being
named in its `INFORMATIONAL` set, when a blocking job (or `ci-ok` itself) has a
step-level `continue-on-error`, and when the table above disagrees with
`ci.yml`. `release.yml` runs this whole workflow as its CI gate
(`workflow_call`), so a release passes the same checks.

Regenerate after adding or renaming a job:
Expand Down Expand Up @@ -108,14 +114,41 @@ Neither `yaml.safe_load` nor a JSON-Schema validator catches it, because both
treat the `run:` block as an opaque string. `scripts/check-workflow-expressions.py`
runs in the `doc` job and does.

`actionlint` also catches it and catches much more besides. It is not wired in
here only because it ships as a Go binary from GitHub releases and cannot be
checksum-pinned the way `osv-scanner` is in `ci.yml`. If a pinned, verifiable
install becomes available, adding it would be a strict improvement.
`actionlint` also catches it and catches much more besides; the `workflow-lint`
job runs it from the release tarball, pinned by version and sha256 the way
`osv-scanner` is (the release publishes `actionlint_<version>_checksums.txt`).

## Pinning, and the checks that hold it

Everything CI downloads is pinned, and a script in the `doc` job keeps each
kind of pin consistent:

| What | Pinned by | Checked by |
|---|---|---|
| Actions | full commit SHA, version in the trailing comment (`# v2.9.3`, or `# master` for `dtolnay/rust-toolchain`, which has no release tags) | `scripts/check-action-pins.py`: one commit per action across all workflows, and the same commits in the workflows the scaffold generates (`src/scaffold/templates_ci.rs`), which Dependabot does not update |
| Runner images | `ubuntu-24.04`, `macos-26`, `windows-2025`, never `*-latest` (GitHub moves those labels; each pinned label was the `-latest` image on 2026-10-30) | `scripts/check-action-pins.py`: a floating label in any workflow fails |
| Rust | an exact release in `rust-toolchain.toml`, repeated in every `toolchain:` input | `scripts/check-toolchain-pin.py`: `stable` / `beta` only in informational jobs; MSRV and nightly where they are the point |
| Release binaries (osv-scanner, actionlint, typos, taplo, cargo-machete) | version and SHA-256 in the job | the job itself (`sha256sum -c`) |
| Cargo-installed tools (cargo-deny, cargo-semver-checks, cargo-fuzz, mdBook, ...) | `cargo install --locked --version` | — |

The five jobs that compare a checked-in table with upstream (`abi-table`, which
has two such steps, `platform-table`, `spdx-list`, `autoload-entries`,
`msrv-vs-duckdb-ci`) run each script through `scripts/upstream-guard.sh`:
exit 1 (drift) fails; exit 2
("could not check": upstream unreachable, an HTTP 5xx or 429) is a warning on a
pull request or a push and a failure on a release tag and on the weekly
schedule, where nothing may be skipped; a missing script fails. The scripts
return 1, not 2, for an HTTP 4xx and for a file that no longer has the
expected shape: upstream moved something, and a job that degraded to "check
skipped" for good would never say so. `upstream-guard.sh --self-test` runs in
the `doc` job.

## Adding a new workflow

1. Create a new `.yml` file in this directory.
2. Pin all third-party actions to their full commit SHA (not a tag).
3. Add SPDX license header.
4. Update this README.
2. Pin all third-party actions to their full commit SHA (not a tag), at the
commit the other workflows use (`scripts/check-action-pins.py`).
3. Install Rust with `toolchain:` set to the release `rust-toolchain.toml`
pins (`scripts/check-toolchain-pin.py`).
4. Add SPDX license header.
5. Update this README.
8 changes: 4 additions & 4 deletions .github/workflows/benchmarks.yml
Original file line number Diff line number Diff line change
Expand Up @@ -32,17 +32,17 @@ permissions:
jobs:
bench:
name: Run Benchmarks
runs-on: ubuntu-latest
runs-on: ubuntu-24.04
timeout-minutes: 45
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false

- uses: dtolnay/rust-toolchain@e2a55d2ffb04f378e9626c28d38b36d230d1e12f # master 2026-10-08
- uses: dtolnay/rust-toolchain@683b588c487a69d01f6c6ddf40f036ff682cc2c8 # master
with:
toolchain: stable
- uses: Swatinem/rust-cache@6323deb102c322ba6fcbdcafc7e3dddab59af2b6 # v2.9.2
toolchain: 1.99.1
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3

- name: Build benchmarks
run: cargo bench --no-run
Expand Down
Loading
Loading