# landiluigi746/ggpkg architecture

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

- Interactive diagram: https://gitdiagram.com/landiluigi746/ggpkg
- Repository: https://github.com/landiluigi746/ggpkg

## Overview

ggpkg is a cross-platform CLI wrapper around winget, pacman, and apt. Users configure or update its package database, browse mapped package names, then invoke install, uninstall, or upgrade operations through the detected native manager; separate commands test configuration and update manager repositories or all packages. The graph includes the package mapping/database, manager detection and persisted configuration, and shared utilities. Some command implementations and database details were not excerpted, so their links are limited to documented capabilities or omitted where wiring is uncertain.

Main entry points: [`src/commands/Commands.cpp`](https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Commands.cpp) (Command registration), [`src/PackageManager.hpp`](https://github.com/landiluigi746/ggpkg/blob/master/src/PackageManager.hpp) (Manager operations), [`src/Package.hpp`](https://github.com/landiluigi746/ggpkg/blob/master/src/Package.hpp) (Package catalog API), [`src/PackageManager.cpp`](https://github.com/landiluigi746/ggpkg/blob/master/src/PackageManager.cpp) (Detection and execution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and commands"]
  node_entry["CLI entry<br/>[main.cpp]"]
  node_command_setup["Command registration<br/>[Commands.cpp]"]
  node_configure["Configure<br/>[Configure.cpp]"]
  node_test["Configuration test<br/>[Test.cpp]"]
  node_list["Package listing<br/>[List.cpp]"]
  node_install["Install packages<br/>[Install.cpp]"]
  node_uninstall["Uninstall packages<br/>[Uninstall.cpp]"]
  node_upgrade["Upgrade packages<br/>[Upgrade.cpp]"]
  node_update_repos["Update repositories<br/>[Update.cpp]"]
  node_upgrade_all["Upgrade all<br/>[UpgradeAll.cpp]"]
  node_update_db["Update package database<br/>[UpdatePackages.cpp]"]
end

subgraph group_catalog["Package catalog"]
  node_catalog_api["Package catalog API<br/>[Package.hpp]"]
  node_package_data[("Package database cache<br/>[Package.cpp]")]
  node_mapping_files["Manager mappings"]
end

subgraph group_manager["Manager integration"]
  node_manager_api["Manager operations<br/>[PackageManager.hpp]"]
  node_manager_impl["Detection and execution<br/>[PackageManager.cpp]"]
  node_manager_config["Manager configuration<br/>[Config.hpp]"]
end

subgraph group_shared["Shared runtime"]
  node_utils["Runtime utilities<br/>[Utils.cpp]"]
  node_string_hash["String hashing<br/>[StringHash.hpp]"]
end

node_user(("CLI user"))
node_native_manager(("Native package manager"))
node_package_service(("Package data source"))

node_user -->|"runs"| node_entry
node_entry -->|"sets up"| node_command_setup
node_command_setup -.->|"registers"| node_configure
node_command_setup -.->|"registers"| node_test
node_command_setup -.->|"registers"| node_list
node_command_setup -.->|"registers"| node_install
node_command_setup -.->|"registers"| node_uninstall
node_command_setup -.->|"registers"| node_upgrade
node_command_setup -.->|"registers"| node_update_repos
node_command_setup -.->|"registers"| node_upgrade_all
node_command_setup -.->|"registers"| node_update_db
node_configure -->|"detects"| node_manager_api
node_test -.->|"tests"| node_manager_api
node_list -->|"loads config"| node_manager_api
node_list -->|"loads packages"| node_catalog_api
node_install -->|"executes action"| node_manager_api
node_install -->|"maps names"| node_catalog_api
node_uninstall -->|"executes action"| node_manager_api
node_uninstall -->|"maps names"| node_catalog_api
node_upgrade -->|"executes action"| node_manager_api
node_upgrade -->|"maps names"| node_catalog_api
node_update_repos -.->|"updates repos"| node_manager_api
node_upgrade_all -.->|"upgrades all"| node_manager_api
node_update_db -.->|"refreshes"| node_catalog_api
node_catalog_api -.->|"loads and downloads"| node_package_data
node_package_data -.->|"fetches data"| node_package_service
node_package_data -.->|"uses mappings"| node_mapping_files
node_manager_api -->|"implemented by"| node_manager_impl
node_manager_impl -->|"reads and writes"| node_manager_config
node_manager_impl -->|"tests and invokes"| node_native_manager
node_manager_impl -->|"uses package mappings"| node_catalog_api
node_manager_impl -->|"runs commands"| node_utils
node_catalog_api -->|"hashes keys"| node_string_hash
node_configure -.->|"reports results"| node_utils
node_list -->|"renders interface"| node_utils

click node_entry "https://github.com/landiluigi746/ggpkg/blob/master/src/main.cpp"
click node_command_setup "https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Commands.cpp"
click node_configure "https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Configure.cpp"
click node_test "https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Test.cpp"
click node_list "https://github.com/landiluigi746/ggpkg/blob/master/src/commands/List.cpp"
click node_install "https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Install.cpp"
click node_uninstall "https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Uninstall.cpp"
click node_upgrade "https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Upgrade.cpp"
click node_update_repos "https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Update.cpp"
click node_upgrade_all "https://github.com/landiluigi746/ggpkg/blob/master/src/commands/UpgradeAll.cpp"
click node_update_db "https://github.com/landiluigi746/ggpkg/blob/master/src/commands/UpdatePackages.cpp"
click node_catalog_api "https://github.com/landiluigi746/ggpkg/blob/master/src/Package.hpp"
click node_package_data "https://github.com/landiluigi746/ggpkg/blob/master/src/Package.cpp"
click node_mapping_files "https://github.com/landiluigi746/ggpkg/tree/master/data"
click node_manager_api "https://github.com/landiluigi746/ggpkg/blob/master/src/PackageManager.hpp"
click node_manager_impl "https://github.com/landiluigi746/ggpkg/blob/master/src/PackageManager.cpp"
click node_manager_config "https://github.com/landiluigi746/ggpkg/blob/master/src/Config.hpp"
click node_utils "https://github.com/landiluigi746/ggpkg/blob/master/src/utils/Utils.cpp"
click node_string_hash "https://github.com/landiluigi746/ggpkg/blob/master/src/utils/StringHash.hpp"

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_entry,node_command_setup,node_configure,node_test,node_list,node_install,node_uninstall,node_upgrade,node_update_repos,node_upgrade_all,node_update_db,node_user toneBlue
class node_catalog_api,node_package_data,node_mapping_files toneAmber
class node_manager_api,node_manager_impl,node_manager_config toneMint
class node_utils,node_string_hash toneRose
class node_native_manager,node_package_service toneIndigo
```

## Components

### CLI and commands

- [CLI entry](https://github.com/landiluigi746/ggpkg/blob/master/src/main.cpp): `src/main.cpp`
- [Command registration](https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Commands.cpp): `src/commands/Commands.cpp`
- [Configure](https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Configure.cpp): `src/commands/Configure.cpp`
- [Configuration test](https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Test.cpp): `src/commands/Test.cpp`
- [Package listing](https://github.com/landiluigi746/ggpkg/blob/master/src/commands/List.cpp): `src/commands/List.cpp`
- [Install packages](https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Install.cpp): `src/commands/Install.cpp`
- [Uninstall packages](https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Uninstall.cpp): `src/commands/Uninstall.cpp`
- [Upgrade packages](https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Upgrade.cpp): `src/commands/Upgrade.cpp`
- [Update repositories](https://github.com/landiluigi746/ggpkg/blob/master/src/commands/Update.cpp): `src/commands/Update.cpp`
- [Upgrade all](https://github.com/landiluigi746/ggpkg/blob/master/src/commands/UpgradeAll.cpp): `src/commands/UpgradeAll.cpp`
- [Update package database](https://github.com/landiluigi746/ggpkg/blob/master/src/commands/UpdatePackages.cpp): `src/commands/UpdatePackages.cpp`

### Package catalog

- [Package catalog API](https://github.com/landiluigi746/ggpkg/blob/master/src/Package.hpp): `src/Package.hpp`
- [Package database cache](https://github.com/landiluigi746/ggpkg/blob/master/src/Package.cpp): `src/Package.cpp`
- [Manager mappings](https://github.com/landiluigi746/ggpkg/tree/master/data): `data`

### Manager integration

- [Manager operations](https://github.com/landiluigi746/ggpkg/blob/master/src/PackageManager.hpp): `src/PackageManager.hpp`
- [Detection and execution](https://github.com/landiluigi746/ggpkg/blob/master/src/PackageManager.cpp): `src/PackageManager.cpp`
- [Manager configuration](https://github.com/landiluigi746/ggpkg/blob/master/src/Config.hpp): `src/Config.hpp`

### Shared runtime

- [Runtime utilities](https://github.com/landiluigi746/ggpkg/blob/master/src/utils/Utils.cpp): `src/utils/Utils.cpp`
- [String hashing](https://github.com/landiluigi746/ggpkg/blob/master/src/utils/StringHash.hpp): `src/utils/StringHash.hpp`

### Other components

- **CLI user**
- **Native package manager**
- **Package data source**

## Connections

- CLI user → CLI entry: runs (evidence: `README.md`)
- CLI entry → Command registration: sets up (evidence: `src/main.cpp`)
- Command registration → Configure: registers
- Command registration → Configuration test: registers
- Command registration → Package listing: registers
- Command registration → Install packages: registers
- Command registration → Uninstall packages: registers
- Command registration → Upgrade packages: registers
- Command registration → Update repositories: registers
- Command registration → Upgrade all: registers
- Command registration → Update package database: registers
- Configure → Manager operations: detects (evidence: `src/commands/Configure.cpp`)
- Configuration test → Manager operations: tests
- Package listing → Manager operations: loads config (evidence: `src/commands/List.cpp`)
- Package listing → Package catalog API: loads packages (evidence: `src/commands/List.cpp`)
- Install packages → Manager operations: executes action (evidence: `src/commands/Install.cpp`)
- Install packages → Package catalog API: maps names (evidence: `src/commands/Install.cpp`)
- Uninstall packages → Manager operations: executes action (evidence: `src/commands/Uninstall.cpp`)
- Uninstall packages → Package catalog API: maps names (evidence: `src/commands/Uninstall.cpp`)
- Upgrade packages → Manager operations: executes action (evidence: `src/commands/Upgrade.cpp`)
- Upgrade packages → Package catalog API: maps names (evidence: `src/commands/Upgrade.cpp`)
- Update repositories → Manager operations: updates repos (evidence: `src/commands/Update.cpp`)
- Upgrade all → Manager operations: upgrades all (evidence: `src/commands/UpgradeAll.cpp`)
- Update package database → Package catalog API: refreshes (evidence: `src/commands/UpdatePackages.cpp`)
- Package catalog API → Package database cache: loads and downloads (evidence: `src/Package.cpp`)
- Package database cache → Package data source: fetches data
- Package database cache → Manager mappings: uses mappings
- Manager operations → Detection and execution: implemented by (evidence: `src/PackageManager.cpp`)
- Detection and execution → Manager configuration: reads and writes (evidence: `src/PackageManager.cpp`)
- Detection and execution → Native package manager: tests and invokes (evidence: `src/PackageManager.cpp`)
- Detection and execution → Package catalog API: uses package mappings (evidence: `src/PackageManager.cpp`)
- Detection and execution → Runtime utilities: runs commands (evidence: `src/PackageManager.cpp`)
- Package catalog API → String hashing: hashes keys (evidence: `src/Package.hpp`)
- Configure → Runtime utilities: reports results
- Package listing → Runtime utilities: renders interface (evidence: `src/commands/List.cpp`)
