# embarkstudios/cargo-deny architecture

> Architecture diagram of the GitHub repository embarkstudios/cargo-deny, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/embarkstudios/cargo-deny
- Repository: https://github.com/embarkstudios/cargo-deny

## Overview

cargo-deny is a Cargo plugin for linting dependency trees. The principal workflow is a user invoking `cargo deny check`, which runs checks for advisories, bans, licenses, and trusted sources, then reports findings. Configuration is a shared internal layer; diagnostics and SARIF provide reporting support. The README documents the check capabilities, while source-index references establish several internal module dependencies. Some runtime wiring is unsampled, so those links are omitted.

Main entry points: [`src/cargo-deny/main.rs`](https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/main.rs) (CLI entry), [`src/cargo-deny/check.rs`](https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/check.rs) (Check command), [`src/bans.rs`](https://github.com/embarkstudios/cargo-deny/blob/main/src/bans.rs) (Ban check), [`src/diag.rs`](https://github.com/embarkstudios/cargo-deny/blob/main/src/diag.rs) (Diagnostics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI"]
  node_cli["CLI entry<br/>[main.rs]"]
  node_check["Check command<br/>[check.rs]"]
  node_init["Init command<br/>[init.rs]"]
  node_fetch["Fetch command<br/>[fetch.rs]"]
  node_list["List command<br/>[list.rs]"]
  node_stats["Stats command<br/>[stats.rs]"]
end

subgraph group_checks["Dependency checks"]
  node_advisories["Advisory check<br/>[advisories.rs]"]
  node_advisory_db[("Advisory database<br/>[db.rs]")]
  node_bans["Ban check<br/>[bans.rs]"]
  node_ban_graph["Duplicate graph<br/>[graph.rs]"]
  node_replacements["Std replacements<br/>[replacements.rs]"]
  node_licenses["License check<br/>[licenses.rs]"]
  node_license_gather["License gathering<br/>[gather.rs]"]
  node_sources["Source check<br/>[sources.rs]"]
end

subgraph group_config["Configuration"]
  node_root_config["Root config<br/>[root_cfg.rs]"]
  node_common_config["Shared config<br/>[cfg.rs]"]
  node_advisory_config["Advisory config<br/>[cfg.rs]"]
  node_ban_config["Ban config<br/>[cfg.rs]"]
  node_license_config["License config<br/>[cfg.rs]"]
  node_source_config["Source config<br/>[cfg.rs]"]
end

subgraph group_reporting["Reporting"]
  node_diagnostics["Diagnostics<br/>[diag.rs]"]
  node_sarif["SARIF output<br/>[collector.rs]"]
  node_git["Git utilities<br/>[git.rs]"]
end

node_user(("Cargo user"))

node_user -->|"invokes"| node_cli
node_cli -->|"dispatches"| node_check
node_cli -->|"dispatches"| node_init
node_cli -->|"dispatches"| node_fetch
node_cli -->|"dispatches"| node_list
node_cli -->|"dispatches"| node_stats
node_check -->|"runs check"| node_advisories
node_check -->|"runs check"| node_bans
node_check -->|"runs check"| node_licenses
node_check -->|"runs check"| node_sources
node_advisories -->|"uses config"| node_advisory_config
node_advisories -->|"emits diagnostics"| node_diagnostics
node_advisories -->|"uses database"| node_advisory_db
node_advisory_db -->|"uses utilities"| node_git
node_bans -->|"uses config"| node_ban_config
node_bans -->|"emits diagnostics"| node_diagnostics
node_bans -->|"creates graph"| node_ban_graph
node_bans -->|"checks replacements"| node_replacements
node_replacements -->|"uses utilities"| node_git
node_licenses -->|"uses config"| node_license_config
node_licenses -->|"gathers licenses"| node_license_gather
node_licenses -->|"emits diagnostics"| node_diagnostics
node_sources -->|"uses config"| node_source_config
node_sources -->|"emits diagnostics"| node_diagnostics
node_advisory_config -->|"uses shared config"| node_common_config
node_ban_config -->|"uses shared config"| node_common_config
node_license_config -->|"uses shared config"| node_common_config
node_source_config -->|"uses shared config"| node_common_config
node_diagnostics -->|"supports output"| node_sarif

click node_cli "https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/main.rs"
click node_check "https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/check.rs"
click node_init "https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/init.rs"
click node_fetch "https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/fetch.rs"
click node_list "https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/list.rs"
click node_stats "https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/stats.rs"
click node_advisories "https://github.com/embarkstudios/cargo-deny/blob/main/src/advisories.rs"
click node_advisory_db "https://github.com/embarkstudios/cargo-deny/blob/main/src/advisories/helpers/db.rs"
click node_bans "https://github.com/embarkstudios/cargo-deny/blob/main/src/bans.rs"
click node_ban_graph "https://github.com/embarkstudios/cargo-deny/blob/main/src/bans/graph.rs"
click node_replacements "https://github.com/embarkstudios/cargo-deny/blob/main/src/bans/replacements.rs"
click node_licenses "https://github.com/embarkstudios/cargo-deny/blob/main/src/licenses.rs"
click node_license_gather "https://github.com/embarkstudios/cargo-deny/blob/main/src/licenses/gather.rs"
click node_sources "https://github.com/embarkstudios/cargo-deny/blob/main/src/sources.rs"
click node_root_config "https://github.com/embarkstudios/cargo-deny/blob/main/src/root_cfg.rs"
click node_common_config "https://github.com/embarkstudios/cargo-deny/blob/main/src/cfg.rs"
click node_advisory_config "https://github.com/embarkstudios/cargo-deny/blob/main/src/advisories/cfg.rs"
click node_ban_config "https://github.com/embarkstudios/cargo-deny/blob/main/src/bans/cfg.rs"
click node_license_config "https://github.com/embarkstudios/cargo-deny/blob/main/src/licenses/cfg.rs"
click node_source_config "https://github.com/embarkstudios/cargo-deny/blob/main/src/sources/cfg.rs"
click node_diagnostics "https://github.com/embarkstudios/cargo-deny/blob/main/src/diag.rs"
click node_sarif "https://github.com/embarkstudios/cargo-deny/blob/main/src/sarif/collector.rs"
click node_git "https://github.com/embarkstudios/cargo-deny/blob/main/src/git.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_check,node_init,node_fetch,node_list,node_stats,node_user toneBlue
class node_advisories,node_advisory_db,node_bans,node_ban_graph,node_replacements,node_licenses,node_license_gather,node_sources toneAmber
class node_root_config,node_common_config,node_advisory_config,node_ban_config,node_license_config,node_source_config toneMint
class node_diagnostics,node_sarif,node_git toneRose
```

## Components

### CLI

- [CLI entry](https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/main.rs): `src/cargo-deny/main.rs`
- [Check command](https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/check.rs): `src/cargo-deny/check.rs`
- [Init command](https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/init.rs): `src/cargo-deny/init.rs`
- [Fetch command](https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/fetch.rs): `src/cargo-deny/fetch.rs`
- [List command](https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/list.rs): `src/cargo-deny/list.rs`
- [Stats command](https://github.com/embarkstudios/cargo-deny/blob/main/src/cargo-deny/stats.rs): `src/cargo-deny/stats.rs`

### Dependency checks

- [Advisory check](https://github.com/embarkstudios/cargo-deny/blob/main/src/advisories.rs): `src/advisories.rs`
- [Advisory database](https://github.com/embarkstudios/cargo-deny/blob/main/src/advisories/helpers/db.rs): `src/advisories/helpers/db.rs`
- [Ban check](https://github.com/embarkstudios/cargo-deny/blob/main/src/bans.rs): `src/bans.rs`
- [Duplicate graph](https://github.com/embarkstudios/cargo-deny/blob/main/src/bans/graph.rs): `src/bans/graph.rs`
- [Std replacements](https://github.com/embarkstudios/cargo-deny/blob/main/src/bans/replacements.rs): `src/bans/replacements.rs`
- [License check](https://github.com/embarkstudios/cargo-deny/blob/main/src/licenses.rs): `src/licenses.rs`
- [License gathering](https://github.com/embarkstudios/cargo-deny/blob/main/src/licenses/gather.rs): `src/licenses/gather.rs`
- [Source check](https://github.com/embarkstudios/cargo-deny/blob/main/src/sources.rs): `src/sources.rs`

### Configuration

- [Root config](https://github.com/embarkstudios/cargo-deny/blob/main/src/root_cfg.rs): `src/root_cfg.rs`
- [Shared config](https://github.com/embarkstudios/cargo-deny/blob/main/src/cfg.rs): `src/cfg.rs`
- [Advisory config](https://github.com/embarkstudios/cargo-deny/blob/main/src/advisories/cfg.rs): `src/advisories/cfg.rs`
- [Ban config](https://github.com/embarkstudios/cargo-deny/blob/main/src/bans/cfg.rs): `src/bans/cfg.rs`
- [License config](https://github.com/embarkstudios/cargo-deny/blob/main/src/licenses/cfg.rs): `src/licenses/cfg.rs`
- [Source config](https://github.com/embarkstudios/cargo-deny/blob/main/src/sources/cfg.rs): `src/sources/cfg.rs`

### Reporting

- [Diagnostics](https://github.com/embarkstudios/cargo-deny/blob/main/src/diag.rs): `src/diag.rs`
- [SARIF output](https://github.com/embarkstudios/cargo-deny/blob/main/src/sarif/collector.rs): `src/sarif/collector.rs`
- [Git utilities](https://github.com/embarkstudios/cargo-deny/blob/main/src/git.rs): `src/git.rs`

### Other components

- **Cargo user**

## Connections

- Cargo user → CLI entry: invokes (evidence: `README.md`)
- CLI entry → Check command: dispatches (evidence: `src/cargo-deny/main.rs`)
- CLI entry → Init command: dispatches (evidence: `src/cargo-deny/main.rs`)
- CLI entry → Fetch command: dispatches (evidence: `src/cargo-deny/main.rs`)
- CLI entry → List command: dispatches (evidence: `src/cargo-deny/main.rs`)
- CLI entry → Stats command: dispatches (evidence: `src/cargo-deny/main.rs`)
- Check command → Advisory check: runs check (evidence: `README.md`)
- Check command → Ban check: runs check (evidence: `README.md`)
- Check command → License check: runs check (evidence: `README.md`)
- Check command → Source check: runs check (evidence: `README.md`)
- Advisory check → Advisory config: uses config (evidence: `src/advisories.rs`)
- Advisory check → Diagnostics: emits diagnostics (evidence: `src/advisories.rs`)
- Advisory check → Advisory database: uses database (evidence: `src/advisories.rs`)
- Advisory database → Git utilities: uses utilities (evidence: `src/advisories/helpers/db.rs`)
- Ban check → Ban config: uses config (evidence: `src/bans.rs`)
- Ban check → Diagnostics: emits diagnostics (evidence: `src/bans.rs`)
- Ban check → Duplicate graph: creates graph (evidence: `src/bans.rs`)
- Ban check → Std replacements: checks replacements (evidence: `src/bans.rs`)
- Std replacements → Git utilities: uses utilities (evidence: `src/bans/replacements.rs`)
- License check → License config: uses config (evidence: `src/licenses.rs`)
- License check → License gathering: gathers licenses (evidence: `src/licenses.rs`)
- License check → Diagnostics: emits diagnostics (evidence: `src/licenses.rs`)
- Source check → Source config: uses config (evidence: `src/sources.rs`)
- Source check → Diagnostics: emits diagnostics (evidence: `src/sources.rs`)
- Advisory config → Shared config: uses shared config (evidence: `src/advisories/cfg.rs`)
- Ban config → Shared config: uses shared config (evidence: `src/bans/cfg.rs`)
- License config → Shared config: uses shared config (evidence: `src/licenses/cfg.rs`)
- Source config → Shared config: uses shared config (evidence: `src/sources/cfg.rs`)
- Diagnostics → SARIF output: supports output (evidence: `src/sarif/collector.rs`)
