CodeVetter · Repo Unpack · Contributor handoff
diesel-rs/diesel
Use the pinned manifests and affected crate implementation as the starting context, because the supplied inventory contains simplified version and backend information. Tests and CI were inspected, not executed, and this brief covers a bounded set of source paths. Future implementation work should preserve backend gates and use dedicated test databases before authorizing execution. Public API changes, generated diagnostics, schema snapshots, and embedded migration rebuilds require special attention.
- Read Cargo.toml and the affected crate manifest first: Rust 1.88.0/edition 2024, Diesel 2.3.13, four backend features, and target-specific SQLite dependencies are concrete constraints in this revision.
- For query-runtime changes, follow RunQueryDsl::load, LoadQuery::internal_load, backend LoadConnection, statement preparation, and row decoding before choosing an edit boundary.
- For CLI/schema work, read cli.rs, main.rs, config.rs, and print_schema.rs together; configuration overrides, relative paths, multi-schema context, patches, and locked-file handling all affect observable output.
- The inspected test sources and workflow declarations describe intended checks, not execution results: review CLI schema snapshots/compilation, migration assertions, compile-failure diagnostics, and CI configuration before planning validation.
- In authorized implementation work, start with the affected backend/test and use cargo xtask run-tests for broader checks; xtask resolves backend-specific database variables, runs migrations first, and invokes nextest with coordinated crate features.
- Preserve compile-error and snapshot expectations deliberately: BLESS presence rewrites ui_test outputs, while CONTRIBUTING.md calls for reviewing insta changes; tidy and semver-checks are existing tooling entrypoints.
- Embedded migrations have a documented rebuild trap: changes only to migration files may not rerun the procedural macro, and consuming applications should use build.rs rerun-if-changed declarations.
- Contribution conventions require minimal, reviewed, verified changes and AI-use disclosure; the guide reserves mentoring/good-first-issue work from AI use and asks authors to write their own PR descriptions.