# wwpdb/py-wwpdb_utils_config architecture

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

- Interactive diagram: https://gitdiagram.com/wwpdb/py-wwpdb_utils_config
- Repository: https://github.com/wwpdb/py-wwpdb_utils_config

## Overview

This is a Python utility library for accessing OneDep site and application configuration. A typical use starts with a site identifier, builds a configuration dictionary, and exposes it through general or application-specific accessors; specialized helpers then resolve dataset assignments, service availability, or project version information. Separate command-line utilities inspect or manage configuration files and dataset-location mappings. The excerpts establish several direct module dependencies, but do not show the complete configuration-loading implementation or all external resource wiring.

Main entry points: [`wwpdb/utils/config/ConfigInfo.py`](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfo.py) (Config accessor), [`wwpdb/utils/config/ConfigInfoApp.py`](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoApp.py) (App accessors), [`wwpdb/utils/config/ConfigInfoDataSet.py`](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoDataSet.py) (Dataset mapping), [`wwpdb/utils/config/ConfigInfoSiteAccess.py`](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoSiteAccess.py) (Site availability)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_config_core["Configuration core"]
  node_config_api["Config accessor<br/>[ConfigInfo.py]"]
  node_config_data["Config dictionary<br/>[ConfigInfoData.py]"]
  node_config_file["Config file reader<br/>[ConfigInfoFile.py]"]
end

subgraph group_accessors["Configuration accessors"]
  node_app_access["App accessors<br/>[ConfigInfoApp.py]"]
end

subgraph group_specialized["Specialized lookups"]
  node_dataset_access["Dataset mapping"]
  node_group_dataset["Group dataset IDs"]
  node_site_access["Site availability"]
  node_project_version["Project version"]
end

subgraph group_utilities["Command utilities"]
  node_file_exec["File config CLI"]
  node_dataset_exec["Dataset CLI"]
  node_shell_exec["Shell config CLI"]
end

node_site_user(("Library consumer"))

node_site_user -.->|"uses"| node_config_api
node_config_api -->|"builds from"| node_config_data
node_app_access -->|"inherits from"| node_config_api
node_dataset_access -->|"reads config"| node_config_api
node_dataset_access -->|"reads paths"| node_app_access
node_group_dataset -->|"reads config"| node_config_api
node_site_access -->|"reads config"| node_config_api
node_site_access -->|"reads accessors"| node_app_access
node_project_version -->|"gets paths"| node_app_access
node_file_exec -->|"uses reader"| node_config_file
node_dataset_exec -->|"delegates to"| node_dataset_access

click node_config_api "https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfo.py"
click node_config_data "https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoData.py"
click node_config_file "https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoFile.py"
click node_app_access "https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoApp.py"
click node_dataset_access "https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoDataSet.py"
click node_group_dataset "https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoGroupDataSet.py"
click node_site_access "https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoSiteAccess.py"
click node_project_version "https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ProjectVersionInfo.py"
click node_file_exec "https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoFileExec.py"
click node_dataset_exec "https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoDataSetExec.py"
click node_shell_exec "https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoShellExec.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_config_api,node_config_data,node_config_file toneBlue
class node_app_access toneAmber
class node_dataset_access,node_group_dataset,node_site_access,node_project_version toneMint
class node_file_exec,node_dataset_exec,node_shell_exec toneRose
class node_site_user toneIndigo
```

## Components

### Configuration core

- [Config accessor](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfo.py): `wwpdb/utils/config/ConfigInfo.py`
- [Config dictionary](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoData.py): `wwpdb/utils/config/ConfigInfoData.py`
- [Config file reader](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoFile.py): `wwpdb/utils/config/ConfigInfoFile.py`

### Configuration accessors

- [App accessors](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoApp.py): `wwpdb/utils/config/ConfigInfoApp.py`

### Specialized lookups

- [Dataset mapping](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoDataSet.py): `wwpdb/utils/config/ConfigInfoDataSet.py`
- [Group dataset IDs](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoGroupDataSet.py): `wwpdb/utils/config/ConfigInfoGroupDataSet.py`
- [Site availability](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoSiteAccess.py): `wwpdb/utils/config/ConfigInfoSiteAccess.py`
- [Project version](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ProjectVersionInfo.py): `wwpdb/utils/config/ProjectVersionInfo.py`

### Command utilities

- [File config CLI](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoFileExec.py): `wwpdb/utils/config/ConfigInfoFileExec.py`
- [Dataset CLI](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoDataSetExec.py): `wwpdb/utils/config/ConfigInfoDataSetExec.py`
- [Shell config CLI](https://github.com/wwpdb/py-wwpdb_utils_config/blob/master/wwpdb/utils/config/ConfigInfoShellExec.py): `wwpdb/utils/config/ConfigInfoShellExec.py`

### Other components

- **Library consumer**

## Connections

- Library consumer → Config accessor: uses
- Config accessor → Config dictionary: builds from (evidence: `wwpdb/utils/config/ConfigInfo.py`)
- App accessors → Config accessor: inherits from (evidence: `wwpdb/utils/config/ConfigInfoApp.py`)
- Dataset mapping → Config accessor: reads config (evidence: `wwpdb/utils/config/ConfigInfoDataSet.py`)
- Dataset mapping → App accessors: reads paths (evidence: `wwpdb/utils/config/ConfigInfoDataSet.py`)
- Group dataset IDs → Config accessor: reads config (evidence: `wwpdb/utils/config/ConfigInfoGroupDataSet.py`)
- Site availability → Config accessor: reads config (evidence: `wwpdb/utils/config/ConfigInfoSiteAccess.py`)
- Site availability → App accessors: reads accessors (evidence: `wwpdb/utils/config/ConfigInfoSiteAccess.py`)
- Project version → App accessors: gets paths (evidence: `wwpdb/utils/config/ProjectVersionInfo.py`)
- File config CLI → Config file reader: uses reader (evidence: `wwpdb/utils/config/ConfigInfoFileExec.py`)
- Dataset CLI → Dataset mapping: delegates to (evidence: `wwpdb/utils/config/ConfigInfoDataSetExec.py`)
