# System map — diesel-rs/diesel

> Canonical page: https://codevetter.com/unpack/diesel/system-map

# System map — diesel-rs/diesel

Scanned commit 5cdf54e1434b87084a4630c100249f1028f3e32d (2026-10-02). Generated by codevetter codevetter 1.15.0 on 2026-10-02.

Source inspection; upstream code and tests were not executed.

The workspace separates typed query execution, code generation, database tooling, and migration management into cooperating crates. Applications link Diesel directly, while the diesel executable supplies operational commands. Backend features select native drivers and dialect implementations, with additional SQLite platform support. Distribution and developer verification are implemented through cargo-dist, xtask, and GitHub Actions.
- The root workspace includes diesel, diesel_cli, diesel_derives, diesel_migrations, diesel_dynamic_schema, diesel_infer_query, parser crates, examples, and xtask; its shared baseline is Rust 1.88.0 and edition 2024. — [Cargo.toml#L1-L43](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/Cargo.toml#L1-L43)
- The actual diesel and diesel_cli package versions are 2.3.13; the CLI manifest declares the diesel binary at src/main.rs. — [diesel/Cargo.toml#L1-L13](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel/Cargo.toml#L1-L13) [diesel_cli/Cargo.toml#L1-L13](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel_cli/Cargo.toml#L1-L13) [diesel_cli/Cargo.toml#L30-L33](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel_cli/Cargo.toml#L30-L33)
- diesel/src/lib.rs exposes associations, expressions, query_builder, query_dsl, serialization, rows, migrations, and feature-gated backend modules; query construction and driver execution are separate module boundaries. — [diesel/src/lib.rs#L320-L355](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel/src/lib.rs#L320-L355) [diesel/src/query_dsl/load_dsl.rs#L42-L71](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel/src/query_dsl/load_dsl.rs#L42-L71)
- diesel_derives is a procedural-macro crate depending on shared attribute/table parsers and dsl_auto_type; diesel_attribute_parser explicitly identifies itself as internal. — [diesel_derives/Cargo.toml#L14-L32](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel_derives/Cargo.toml#L14-L32) [diesel_attribute_parser/Cargo.toml#L1-L17](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel_attribute_parser/Cargo.toml#L1-L17)
- Backend features connect PostgreSQL through pq-sys, MySQL/MariaDB through mysqlclient-sys, and SQLite through target-specific libsqlite3-sys or sqlite-wasm-rs dependencies. — [diesel/Cargo.toml#L27-L30](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel/Cargo.toml#L27-L30) [diesel/Cargo.toml#L54-L58](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel/Cargo.toml#L54-L58) [diesel/Cargo.toml#L89-L110](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel/Cargo.toml#L89-L110)
- PgConnection owns a statement cache, PostgreSQL metadata cache, raw connection, transaction state, and instrumentation; persisted migration versions belong to __diesel_schema_migrations in the database. — [diesel/src/pg/connection/mod.rs#L125-L129](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel/src/pg/connection/mod.rs#L125-L129) [diesel/src/pg/connection/mod.rs#L181-L190](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel/src/pg/connection/mod.rs#L181-L190) [diesel_migrations/src/migration_harness.rs#L16-L21](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel_migrations/src/migration_harness.rs#L16-L21)
- cargo xtask is a Cargo alias for the xtask package, whose commands include run-tests, clippy, tidy, and semver-checks; CONTRIBUTING.md directs contributors to run-tests and tidy. — [.cargo/config.toml#L1-L2](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/.cargo/config.toml#L1-L2) [xtask/src/main.rs#L11-L39](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/xtask/src/main.rs#L11-L39) [CONTRIBUTING.md#L122-L128](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/CONTRIBUTING.md#L122-L128) [CONTRIBUTING.md#L148-L150](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/CONTRIBUTING.md#L148-L150)
- cargo-dist targets five macOS/Linux/Windows architectures with shell and PowerShell installers, bundled CLI dependencies, SBOMs, and attestations; release publication is gated by the workflow's publishing output. — [dist-workspace.toml#L5-L31](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/dist-workspace.toml#L5-L31) [diesel_cli/Cargo.toml#L96-L97](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/diesel_cli/Cargo.toml#L96-L97) [.github/workflows/release.yml#L244-L277](https://github.com/diesel-rs/diesel/blob/5cdf54e1434b87084a4630c100249f1028f3e32d/.github/workflows/release.yml#L244-L277)

Every claim links to its cited files at the pinned commit. Citations identify source evidence; they do not establish runtime correctness. Independent CodeVetter scan — not reviewed by upstream maintainers.

## Public product links

- [CodeVetter](https://codevetter.com/)
- [Download](https://codevetter.com/download)
- [Documentation](https://codevetter.com/docs/)
- [Source](https://github.com/Codevetter/codevetter)