# linux-on-ibm-z/build-scripts architecture

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

- Interactive diagram: https://gitdiagram.com/linux-on-ibm-z/build-scripts
- Repository: https://github.com/linux-on-ibm-z/build-scripts

## Overview

The repository is a collection of package build scripts and supporting automation; its README offers no further product description. A distinct runtime workflow processes package/version BOM and license data, using scanner adapters and Cloud Object Storage, then writes updated results. The build-script collection is represented as a capability, but its internal flow is not mapped because the sampled build-script files expose no relationships in the source index. Links for the BOM workflow are limited to excerpted calls and imports; unsampled behavior is not inferred.

Main entry points: [`process_bom/BOMProcessor.py`](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/BOMProcessor.py) (BOM Aggregator), [`process_bom/ScanProcessors/BaseProcessors.py`](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ScanProcessors/BaseProcessors.py) (Scanner Base), [`process_bom/CurrencyProcessor.py`](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/CurrencyProcessor.py) (Currency Processor), [`process_bom/COSWrapper.py`](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/COSWrapper.py) (Object Storage Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_build["Package Builds"]
  node_package_scripts["Package Build Scripts"]
  node_wheel_build["Wheel Build Automation<br/>[build_wheels.py]"]
end

subgraph group_currency["Currency Processing"]
  node_currency_runner["Currency CLI"]
  node_currency_processor["Currency Processor"]
  node_bom_processor["BOM Aggregator<br/>[BOMProcessor.py]"]
  node_license_processor["License Evaluation"]
end

subgraph group_scanning["Scanning"]
  node_base_processor["Scanner Base<br/>[BaseProcessors.py]"]
  node_trivy["Trivy Adapter<br/>[TrivyProcessor.py]"]
  node_grype["Grype Adapter<br/>[GrypeProcessor.py]"]
  node_syft["Syft Adapter<br/>[SyftProcessor.py]"]
  node_clair["Clair Adapter<br/>[ClairProcessor.py]"]
end

subgraph group_storage["Storage and Config"]
  node_cos_wrapper["Object Storage Client<br/>[COSWrapper.py]"]
  node_configuration["Runtime Configuration<br/>[ca_config.py]"]
end

node_developer(("Build Maintainer"))
node_ibm_iam(("IBM IAM"))
node_cloud_storage[("IBM Cloud Storage")]

node_developer -.->|"maintains"| node_package_scripts
node_currency_runner -->|"invokes"| node_currency_processor
node_currency_processor -->|"retrieves BOM"| node_bom_processor
node_currency_processor -->|"evaluates licenses"| node_license_processor
node_currency_processor -->|"uploads results"| node_cos_wrapper
node_bom_processor -->|"initializes"| node_trivy
node_bom_processor -->|"initializes"| node_grype
node_bom_processor -->|"initializes"| node_syft
node_bom_processor -->|"initializes"| node_clair
node_trivy -->|"inherits"| node_base_processor
node_grype -->|"inherits"| node_base_processor
node_syft -->|"inherits"| node_base_processor
node_clair -->|"inherits"| node_base_processor
node_base_processor -->|"fetches artifacts"| node_cos_wrapper
node_cos_wrapper -->|"requests token"| node_ibm_iam
node_cos_wrapper -->|"reads and writes"| node_cloud_storage
node_currency_processor -->|"uses settings"| node_configuration
node_bom_processor -->|"uses settings"| node_configuration
node_base_processor -->|"uses settings"| node_configuration
node_cos_wrapper -->|"uses credentials"| node_configuration
node_wheel_build -.->|"builds wheels"| node_package_scripts

click node_package_scripts "https://github.com/linux-on-ibm-z/build-scripts/tree/main/a"
click node_wheel_build "https://github.com/linux-on-ibm-z/build-scripts/blob/main/gha-script/build_wheels.py"
click node_currency_runner "https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/run_currency_processor.py"
click node_currency_processor "https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/CurrencyProcessor.py"
click node_bom_processor "https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/BOMProcessor.py"
click node_license_processor "https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/LicensesProcessor.py"
click node_base_processor "https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ScanProcessors/BaseProcessors.py"
click node_trivy "https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ScanProcessors/TrivyProcessor.py"
click node_grype "https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ScanProcessors/GrypeProcessor.py"
click node_syft "https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ScanProcessors/SyftProcessor.py"
click node_clair "https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ScanProcessors/ClairProcessor.py"
click node_cos_wrapper "https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/COSWrapper.py"
click node_configuration "https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ca_config.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_package_scripts,node_wheel_build toneBlue
class node_currency_runner,node_currency_processor,node_bom_processor,node_license_processor,node_cloud_storage toneAmber
class node_base_processor,node_trivy,node_grype,node_syft,node_clair toneMint
class node_cos_wrapper,node_configuration toneRose
class node_developer,node_ibm_iam toneIndigo
```

## Components

### Package Builds

- [Package Build Scripts](https://github.com/linux-on-ibm-z/build-scripts/tree/main/a): `a`
- [Wheel Build Automation](https://github.com/linux-on-ibm-z/build-scripts/blob/main/gha-script/build_wheels.py): `gha-script/build_wheels.py`

### Currency Processing

- [Currency CLI](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/run_currency_processor.py): `process_bom/run_currency_processor.py`
- [Currency Processor](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/CurrencyProcessor.py): `process_bom/CurrencyProcessor.py`
- [BOM Aggregator](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/BOMProcessor.py): `process_bom/BOMProcessor.py`
- [License Evaluation](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/LicensesProcessor.py): `process_bom/LicensesProcessor.py`

### Scanning

- [Scanner Base](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ScanProcessors/BaseProcessors.py): `process_bom/ScanProcessors/BaseProcessors.py`
- [Trivy Adapter](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ScanProcessors/TrivyProcessor.py): `process_bom/ScanProcessors/TrivyProcessor.py`
- [Grype Adapter](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ScanProcessors/GrypeProcessor.py): `process_bom/ScanProcessors/GrypeProcessor.py`
- [Syft Adapter](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ScanProcessors/SyftProcessor.py): `process_bom/ScanProcessors/SyftProcessor.py`
- [Clair Adapter](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ScanProcessors/ClairProcessor.py): `process_bom/ScanProcessors/ClairProcessor.py`

### Storage and Config

- [Object Storage Client](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/COSWrapper.py): `process_bom/COSWrapper.py`
- [Runtime Configuration](https://github.com/linux-on-ibm-z/build-scripts/blob/main/process_bom/ca_config.py): `process_bom/ca_config.py`

### Other components

- **Build Maintainer**
- **IBM IAM**
- **IBM Cloud Storage**

## Connections

- Build Maintainer → Package Build Scripts: maintains
- Currency CLI → Currency Processor: invokes (evidence: `process_bom/run_currency_processor.py`)
- Currency Processor → BOM Aggregator: retrieves BOM (evidence: `process_bom/CurrencyProcessor.py`)
- Currency Processor → License Evaluation: evaluates licenses (evidence: `process_bom/CurrencyProcessor.py`)
- Currency Processor → Object Storage Client: uploads results (evidence: `process_bom/CurrencyProcessor.py`)
- BOM Aggregator → Trivy Adapter: initializes (evidence: `process_bom/BOMProcessor.py`)
- BOM Aggregator → Grype Adapter: initializes (evidence: `process_bom/BOMProcessor.py`)
- BOM Aggregator → Syft Adapter: initializes (evidence: `process_bom/BOMProcessor.py`)
- BOM Aggregator → Clair Adapter: initializes (evidence: `process_bom/BOMProcessor.py`)
- Trivy Adapter → Scanner Base: inherits (evidence: `process_bom/ScanProcessors/TrivyProcessor.py`)
- Grype Adapter → Scanner Base: inherits (evidence: `process_bom/ScanProcessors/GrypeProcessor.py`)
- Syft Adapter → Scanner Base: inherits (evidence: `process_bom/ScanProcessors/SyftProcessor.py`)
- Clair Adapter → Scanner Base: inherits (evidence: `process_bom/ScanProcessors/ClairProcessor.py`)
- Scanner Base → Object Storage Client: fetches artifacts (evidence: `process_bom/ScanProcessors/BaseProcessors.py`)
- Object Storage Client → IBM IAM: requests token (evidence: `process_bom/COSWrapper.py`)
- Object Storage Client → IBM Cloud Storage: reads and writes (evidence: `process_bom/COSWrapper.py`)
- Currency Processor → Runtime Configuration: uses settings (evidence: `process_bom/CurrencyProcessor.py`)
- BOM Aggregator → Runtime Configuration: uses settings (evidence: `process_bom/BOMProcessor.py`)
- Scanner Base → Runtime Configuration: uses settings (evidence: `process_bom/ScanProcessors/BaseProcessors.py`)
- Object Storage Client → Runtime Configuration: uses credentials (evidence: `process_bom/COSWrapper.py`)
- Wheel Build Automation → Package Build Scripts: builds wheels
