# fedora-eln/content-resolver architecture

> Architecture diagram of the GitHub repository fedora-eln/content-resolver, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fedora-eln/content-resolver
- Repository: https://github.com/fedora-eln/content-resolver

## Overview

Content Resolver turns YAML-defined RPM package sets into dependency-resolved data and a browsable static site. The main path loads and filters repository, environment, workload, label, and view configuration; analyzes packages with DNF; builds environments before workloads and views; then uses query services to render HTML, export JSON/text, and record historical charts. The README also documents view-level build-dependency resolution through dep-tracker and minimization features such as package reasons, unwanted-package tracking, and maintainer recommendations. Edges reflect the entry point, indexed references, or README; unsampled internals are represented only where documented.

Main entry points: [`content_resolver/analyzer.py`](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/analyzer.py) (Dependency analysis), [`content_resolver.py`](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver.py) (Build entry point), [`content_resolver/query.py`](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/query.py) (Data queries), [`content_resolver/page_generation.py`](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/page_generation.py) (HTML pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Configuration"]
  node_yaml_specs["YAML specs"]
  node_config_manager["Config loading<br/>[config_manager.py]"]
  node_entry["Build entry point"]
end

subgraph group_resolve["Package resolution"]
  node_analyzer["Dependency analysis<br/>[analyzer.py]"]
  node_environments["Environments<br/>[analyzer.py]"]
  node_workloads["Workloads<br/>[analyzer.py]"]
  node_views["Views and buildroots<br/>[analyzer.py]"]
  node_exceptions["Analysis errors<br/>[exceptions.py]"]
end

subgraph group_inspect["Queries and insights"]
  node_query["Data queries<br/>[query.py]"]
  node_minimization["Package insights<br/>[analyzer.py]"]
  node_utils["Shared utilities<br/>[utils.py]"]
end

subgraph group_publish["Static outputs"]
  node_html["HTML pages<br/>[page_generation.py]"]
  node_exports["Data exports<br/>[data_generation.py]"]
  node_history[("History charts<br/>[historia_data.py]")]
  node_templates["Page templates"]
end

node_maintainer(("Config authors"))
node_dnf[("RPM repositories")]
node_dep_tracker["dep-tracker"]

node_maintainer -->|"defines inputs"| node_yaml_specs
node_yaml_specs -->|"loads YAML"| node_config_manager
node_entry -->|"loads config"| node_config_manager
node_entry -->|"runs analysis"| node_analyzer
node_analyzer -->|"resolves packages"| node_dnf
node_analyzer -->|"resolves first"| node_environments
node_analyzer -->|"resolves atop"| node_workloads
node_analyzer -->|"resolves views"| node_views
node_analyzer -.->|"gets build dependencies"| node_dep_tracker
node_analyzer -->|"raises errors"| node_exceptions
node_entry -->|"creates queries"| node_query
node_query -->|"supports insights"| node_minimization
node_query -->|"uses helpers"| node_utils
node_entry -->|"generates pages"| node_html
node_entry -->|"generates data"| node_exports
node_entry -->|"generates history"| node_history
node_html -->|"renders templates"| node_templates
node_html -->|"queries data"| node_query
node_exports -->|"queries data"| node_query
node_history -->|"queries data"| node_query
node_history -->|"writes chart data"| node_exports

click node_yaml_specs "https://github.com/fedora-eln/content-resolver/tree/master/config_specs"
click node_config_manager "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/config_manager.py"
click node_entry "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver.py"
click node_analyzer "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/analyzer.py"
click node_environments "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/analyzer.py"
click node_workloads "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/analyzer.py"
click node_views "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/analyzer.py"
click node_exceptions "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/exceptions.py"
click node_query "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/query.py"
click node_minimization "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/analyzer.py"
click node_utils "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/utils.py"
click node_html "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/page_generation.py"
click node_exports "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/data_generation.py"
click node_history "https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/historia_data.py"
click node_templates "https://github.com/fedora-eln/content-resolver/tree/master/templates"

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_yaml_specs,node_config_manager,node_entry toneBlue
class node_analyzer,node_environments,node_workloads,node_views,node_exceptions,node_dnf toneAmber
class node_query,node_minimization,node_utils toneMint
class node_html,node_exports,node_history,node_templates toneRose
class node_maintainer,node_dep_tracker toneIndigo
```

## Components

### Configuration

- [YAML specs](https://github.com/fedora-eln/content-resolver/tree/master/config_specs): `config_specs`
- [Config loading](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/config_manager.py): `content_resolver/config_manager.py`
- [Build entry point](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver.py): `content_resolver.py`

### Package resolution

- [Dependency analysis](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/analyzer.py): `content_resolver/analyzer.py`
- [Environments](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/analyzer.py): `content_resolver/analyzer.py`
- [Workloads](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/analyzer.py): `content_resolver/analyzer.py`
- [Views and buildroots](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/analyzer.py): `content_resolver/analyzer.py`
- [Analysis errors](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/exceptions.py): `content_resolver/exceptions.py`

### Queries and insights

- [Data queries](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/query.py): `content_resolver/query.py`
- [Package insights](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/analyzer.py): `content_resolver/analyzer.py`
- [Shared utilities](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/utils.py): `content_resolver/utils.py`

### Static outputs

- [HTML pages](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/page_generation.py): `content_resolver/page_generation.py`
- [Data exports](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/data_generation.py): `content_resolver/data_generation.py`
- [History charts](https://github.com/fedora-eln/content-resolver/blob/master/content_resolver/historia_data.py): `content_resolver/historia_data.py`
- [Page templates](https://github.com/fedora-eln/content-resolver/tree/master/templates): `templates`

### Other components

- **Config authors**
- **RPM repositories**
- **dep-tracker**

## Connections

- Config authors → YAML specs: defines inputs (evidence: `README.md`)
- YAML specs → Config loading: loads YAML (evidence: `README.md`)
- Build entry point → Config loading: loads config (evidence: `content_resolver.py`)
- Build entry point → Dependency analysis: runs analysis (evidence: `content_resolver.py`)
- Dependency analysis → RPM repositories: resolves packages (evidence: `README.md`)
- Dependency analysis → Environments: resolves first (evidence: `README.md`)
- Dependency analysis → Workloads: resolves atop (evidence: `README.md`)
- Dependency analysis → Views and buildroots: resolves views (evidence: `README.md`)
- Dependency analysis → dep-tracker: gets build dependencies (evidence: `README.md`)
- Dependency analysis → Analysis errors: raises errors (evidence: `content_resolver/analyzer.py`)
- Build entry point → Data queries: creates queries (evidence: `content_resolver.py`)
- Data queries → Package insights: supports insights (evidence: `README.md`)
- Data queries → Shared utilities: uses helpers (evidence: `content_resolver/query.py`)
- Build entry point → HTML pages: generates pages (evidence: `content_resolver.py`)
- Build entry point → Data exports: generates data (evidence: `content_resolver.py`)
- Build entry point → History charts: generates history (evidence: `content_resolver.py`)
- HTML pages → Page templates: renders templates (evidence: `content_resolver/page_generation.py`)
- HTML pages → Data queries: queries data (evidence: `content_resolver/page_generation.py`)
- Data exports → Data queries: queries data (evidence: `content_resolver/data_generation.py`)
- History charts → Data queries: queries data (evidence: `content_resolver/historia_data.py`)
- History charts → Data exports: writes chart data (evidence: `content_resolver/historia_data.py`)
