# joshnewans/rosdistro architecture

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

- Interactive diagram: https://gitdiagram.com/joshnewans/rosdistro
- Repository: https://github.com/joshnewans/rosdistro

## Overview

This repository is the ROS packaging-metadata and rosdep-rules database. Its central workflow is updating a ROS distribution’s repository metadata—often through package-release pull requests—then checking or editing that metadata with repository scripts. A separate capability maps package.xml dependency names to system package names through rosdep rules. Migration and ROS 2 development-branch synchronization support distribution maintenance. Source excerpts show several tool calls, but not the complete review or validation workflow, so those connections are not inferred.

Main entry points: [`humble/distribution.yaml`](https://github.com/joshnewans/rosdistro/blob/master/humble/distribution.yaml) (Distribution Files), [`rosdep`](https://github.com/joshnewans/rosdistro/tree/master/rosdep) (Rosdep Rules), [`scripts/add_devel_repo.py`](https://github.com/joshnewans/rosdistro/blob/master/scripts/add_devel_repo.py) (Add Devel Repo), [`scripts/add_release_repo.py`](https://github.com/joshnewans/rosdistro/blob/master/scripts/add_release_repo.py) (Add Release Repo)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_metadata["Distribution Metadata"]
  node_distro["Distribution Files<br/>[distribution.yaml]"]
end

subgraph group_rosdep["Rosdep Rules"]
  node_rosdep_rules["Rosdep Rules"]
  node_rosdep_sources["Rosdep Sources<br/>[sources.list.d]"]
end

subgraph group_tools["Maintenance Tools"]
  node_add_devel["Add Devel Repo<br/>[add_devel_repo.py]"]
  node_add_release["Add Release Repo"]
  node_sort_yaml["YAML Sorter<br/>[sort_yaml.py]"]
  node_migrate["Distribution Migrator"]
  node_sync["ROS 2 Branch Sync"]
  node_check_rosdistro["Metadata Format Check<br/>[check_rosdistro.py]"]
  node_check_repos["Repository Checks"]
  node_check_urls["URL Checks"]
  node_blocking["Blocking Analysis"]
  node_rosdep_check["Rosdep Format Check<br/>[check_rosdep.py]"]
  node_duplicates["Duplicate Rules Check"]
  node_clean_rosdep["Rosdep YAML Cleaner"]
  node_rosinstall["Rosinstall Converter<br/>[yaml2rosinstall.py]"]
  node_package_count["Package Counter"]
end

node_maintainer(("Maintainer"))
node_release(("Package Release PR"))

node_release -->|"opens PRs against"| node_distro
node_maintainer -->|"maintains"| node_distro
node_maintainer -.->|"runs"| node_add_devel
node_add_devel -->|"calls"| node_sort_yaml
node_maintainer -.->|"runs"| node_add_release
node_add_release -->|"calls"| node_sort_yaml
node_maintainer -.->|"runs"| node_migrate
node_migrate -.->|"updates metadata"| node_distro
node_maintainer -.->|"runs"| node_sync
node_sync -.->|"compares metadata"| node_distro
node_maintainer -.->|"checks"| node_check_rosdistro
node_maintainer -.->|"checks"| node_check_repos
node_maintainer -.->|"checks"| node_check_urls
node_maintainer -.->|"analyzes"| node_blocking
node_maintainer -->|"maintains"| node_rosdep_rules
node_maintainer -.->|"checks"| node_rosdep_check
node_maintainer -.->|"checks"| node_duplicates
node_duplicates -.->|"checks duplicates"| node_rosdep_rules
node_maintainer -.->|"cleans"| node_clean_rosdep
node_clean_rosdep -.->|"rewrites YAML"| node_rosdep_rules
node_maintainer -.->|"converts"| node_rosinstall
node_maintainer -.->|"counts packages"| node_package_count

click node_distro "https://github.com/joshnewans/rosdistro/blob/master/humble/distribution.yaml"
click node_rosdep_rules "https://github.com/joshnewans/rosdistro/tree/master/rosdep"
click node_rosdep_sources "https://github.com/joshnewans/rosdistro/tree/master/rosdep/sources.list.d"
click node_add_devel "https://github.com/joshnewans/rosdistro/blob/master/scripts/add_devel_repo.py"
click node_add_release "https://github.com/joshnewans/rosdistro/blob/master/scripts/add_release_repo.py"
click node_sort_yaml "https://github.com/joshnewans/rosdistro/blob/master/scripts/sort_yaml.py"
click node_migrate "https://github.com/joshnewans/rosdistro/blob/master/migration-tools/migrate-rosdistro.py"
click node_sync "https://github.com/joshnewans/rosdistro/blob/master/scripts/sync-ros2-gbp-devel-branch.py"
click node_check_rosdistro "https://github.com/joshnewans/rosdistro/blob/master/scripts/check_rosdistro.py"
click node_check_repos "https://github.com/joshnewans/rosdistro/blob/master/scripts/check_rosdistro_repos.py"
click node_check_urls "https://github.com/joshnewans/rosdistro/blob/master/scripts/check_rosdistro_urls.py"
click node_blocking "https://github.com/joshnewans/rosdistro/blob/master/scripts/check_blocking_repos.py"
click node_rosdep_check "https://github.com/joshnewans/rosdistro/blob/master/scripts/check_rosdep.py"
click node_duplicates "https://github.com/joshnewans/rosdistro/blob/master/scripts/check_duplicates.py"
click node_clean_rosdep "https://github.com/joshnewans/rosdistro/blob/master/scripts/clean_rosdep_yaml.py"
click node_rosinstall "https://github.com/joshnewans/rosdistro/blob/master/scripts/yaml2rosinstall.py"
click node_package_count "https://github.com/joshnewans/rosdistro/blob/master/scripts/count_rosdistro_packages.py"

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_distro toneBlue
class node_rosdep_rules,node_rosdep_sources toneAmber
class node_add_devel,node_add_release,node_sort_yaml,node_migrate,node_sync,node_check_rosdistro,node_check_repos,node_check_urls,node_blocking,node_rosdep_check,node_duplicates,node_clean_rosdep,node_rosinstall,node_package_count toneMint
class node_maintainer,node_release toneIndigo
```

## Components

### Distribution Metadata

- [Distribution Files](https://github.com/joshnewans/rosdistro/blob/master/humble/distribution.yaml): `humble/distribution.yaml`

### Rosdep Rules

- [Rosdep Rules](https://github.com/joshnewans/rosdistro/tree/master/rosdep): `rosdep`
- [Rosdep Sources](https://github.com/joshnewans/rosdistro/tree/master/rosdep/sources.list.d): `rosdep/sources.list.d`

### Maintenance Tools

- [Add Devel Repo](https://github.com/joshnewans/rosdistro/blob/master/scripts/add_devel_repo.py): `scripts/add_devel_repo.py`
- [Add Release Repo](https://github.com/joshnewans/rosdistro/blob/master/scripts/add_release_repo.py): `scripts/add_release_repo.py`
- [YAML Sorter](https://github.com/joshnewans/rosdistro/blob/master/scripts/sort_yaml.py): `scripts/sort_yaml.py`
- [Distribution Migrator](https://github.com/joshnewans/rosdistro/blob/master/migration-tools/migrate-rosdistro.py): `migration-tools/migrate-rosdistro.py`
- [ROS 2 Branch Sync](https://github.com/joshnewans/rosdistro/blob/master/scripts/sync-ros2-gbp-devel-branch.py): `scripts/sync-ros2-gbp-devel-branch.py`
- [Metadata Format Check](https://github.com/joshnewans/rosdistro/blob/master/scripts/check_rosdistro.py): `scripts/check_rosdistro.py`
- [Repository Checks](https://github.com/joshnewans/rosdistro/blob/master/scripts/check_rosdistro_repos.py): `scripts/check_rosdistro_repos.py`
- [URL Checks](https://github.com/joshnewans/rosdistro/blob/master/scripts/check_rosdistro_urls.py): `scripts/check_rosdistro_urls.py`
- [Blocking Analysis](https://github.com/joshnewans/rosdistro/blob/master/scripts/check_blocking_repos.py): `scripts/check_blocking_repos.py`
- [Rosdep Format Check](https://github.com/joshnewans/rosdistro/blob/master/scripts/check_rosdep.py): `scripts/check_rosdep.py`
- [Duplicate Rules Check](https://github.com/joshnewans/rosdistro/blob/master/scripts/check_duplicates.py): `scripts/check_duplicates.py`
- [Rosdep YAML Cleaner](https://github.com/joshnewans/rosdistro/blob/master/scripts/clean_rosdep_yaml.py): `scripts/clean_rosdep_yaml.py`
- [Rosinstall Converter](https://github.com/joshnewans/rosdistro/blob/master/scripts/yaml2rosinstall.py): `scripts/yaml2rosinstall.py`
- [Package Counter](https://github.com/joshnewans/rosdistro/blob/master/scripts/count_rosdistro_packages.py): `scripts/count_rosdistro_packages.py`

### Other components

- **Maintainer**
- **Package Release PR**

## Connections

- Package Release PR → Distribution Files: opens PRs against (evidence: `README.md`)
- Maintainer → Distribution Files: maintains (evidence: `README.md`)
- Maintainer → Add Devel Repo: runs
- Add Devel Repo → YAML Sorter: calls (evidence: `scripts/add_devel_repo.py`)
- Maintainer → Add Release Repo: runs
- Add Release Repo → YAML Sorter: calls (evidence: `scripts/add_release_repo.py`)
- Maintainer → Distribution Migrator: runs
- Distribution Migrator → Distribution Files: updates metadata
- Maintainer → ROS 2 Branch Sync: runs
- ROS 2 Branch Sync → Distribution Files: compares metadata
- Maintainer → Metadata Format Check: checks
- Maintainer → Repository Checks: checks
- Maintainer → URL Checks: checks
- Maintainer → Blocking Analysis: analyzes
- Maintainer → Rosdep Rules: maintains (evidence: `README.md`)
- Maintainer → Rosdep Format Check: checks
- Maintainer → Duplicate Rules Check: checks
- Duplicate Rules Check → Rosdep Rules: checks duplicates
- Maintainer → Rosdep YAML Cleaner: cleans
- Rosdep YAML Cleaner → Rosdep Rules: rewrites YAML
- Maintainer → Rosinstall Converter: converts
- Maintainer → Package Counter: counts packages
