# devopshq/artifactory architecture

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

- Interactive diagram: https://gitdiagram.com/devopshq/artifactory
- Repository: https://github.com/devopshq/artifactory

## Overview

dohq-artifactory is a Python, pathlib-like client for JFrog Artifactory. Users construct an Artifactory path with credentials, then use it to browse repositories and transfer or manage artifacts; the client issues REST requests to Artifactory. A separate admin API covers users, groups, repositories, permissions, projects, and tokens. The graph preserves README-described capabilities, but the main module was only partially excerpted, so feature-level links are documented rather than traced through unsampled methods.

Main entry points: [`artifactory.py`](https://github.com/devopshq/artifactory/blob/master/artifactory.py) (ArtifactoryPath), [`dohq_artifactory/admin.py`](https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/admin.py) (Admin API objects), [`dohq_artifactory/auth.py`](https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/auth.py) (API key and token auth), [`dohq_artifactory/exception.py`](https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/exception.py) (HTTP error handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Path client"]
  node_path["ArtifactoryPath<br/>[artifactory.py]"]
end

subgraph group_transport["HTTP and support"]
  node_session["REST requests<br/>[artifactory.py]"]
  node_auth["API key and token auth<br/>[auth.py]"]
  node_errors["HTTP error handling<br/>[exception.py]"]
  node_compat["Pathlib compatibility<br/>[compat.py]"]
  node_logging["Logging<br/>[logger.py]"]
end

subgraph group_features["Artifactory features"]
  node_browse["Browse and search<br/>[artifactory.py]"]
  node_transfers["Artifact transfers<br/>[artifactory.py]"]
  node_artifact_ops["Artifact operations<br/>[artifactory.py]"]
  node_queries["AQL and statistics<br/>[artifactory.py]"]
  node_builds["Builds and promotion<br/>[artifactory.py]"]
end

subgraph group_admin["Administration"]
  node_admin_api["Admin API objects<br/>[admin.py]"]
  node_admin_resources["Users and groups<br/>[admin.py]"]
  node_repo_resources["Repository management<br/>[admin.py]"]
  node_security_resources["Permissions and tokens<br/>[admin.py]"]
end

node_developer(("Python user"))
node_server[("JFrog Artifactory")]

node_developer -->|"constructs and uses"| node_path
node_path -->|"configures credentials"| node_auth
node_path -->|"issues REST requests"| node_session
node_session -->|"sends requests"| node_server
node_path -->|"supports browsing"| node_browse
node_path -->|"supports transfers"| node_transfers
node_path -->|"supports artifact actions"| node_artifact_ops
node_path -->|"supports queries and stats"| node_queries
node_path -->|"supports build operations"| node_builds
node_path -->|"exposes admin objects"| node_admin_api
node_admin_api -->|"provides resource APIs"| node_admin_resources
node_admin_api -->|"provides repository APIs"| node_repo_resources
node_admin_api -->|"provides security APIs"| node_security_resources
node_admin_api -->|"sends admin requests"| node_server
node_session -->|"checks responses"| node_errors
node_path -->|"uses version checks"| node_compat
node_path -->|"logs client activity"| node_logging

click node_path "https://github.com/devopshq/artifactory/blob/master/artifactory.py"
click node_session "https://github.com/devopshq/artifactory/blob/master/artifactory.py"
click node_auth "https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/auth.py"
click node_errors "https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/exception.py"
click node_compat "https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/compat.py"
click node_logging "https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/logger.py"
click node_browse "https://github.com/devopshq/artifactory/blob/master/artifactory.py"
click node_transfers "https://github.com/devopshq/artifactory/blob/master/artifactory.py"
click node_artifact_ops "https://github.com/devopshq/artifactory/blob/master/artifactory.py"
click node_queries "https://github.com/devopshq/artifactory/blob/master/artifactory.py"
click node_builds "https://github.com/devopshq/artifactory/blob/master/artifactory.py"
click node_admin_api "https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/admin.py"
click node_admin_resources "https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/admin.py"
click node_repo_resources "https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/admin.py"
click node_security_resources "https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/admin.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_path,node_developer toneBlue
class node_session,node_auth,node_errors,node_compat,node_logging,node_server toneAmber
class node_browse,node_transfers,node_artifact_ops,node_queries,node_builds toneMint
class node_admin_api,node_admin_resources,node_repo_resources,node_security_resources toneRose
```

## Components

### Path client

- [ArtifactoryPath](https://github.com/devopshq/artifactory/blob/master/artifactory.py): `artifactory.py`

### HTTP and support

- [REST requests](https://github.com/devopshq/artifactory/blob/master/artifactory.py): `artifactory.py`
- [API key and token auth](https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/auth.py): `dohq_artifactory/auth.py`
- [HTTP error handling](https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/exception.py): `dohq_artifactory/exception.py`
- [Pathlib compatibility](https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/compat.py): `dohq_artifactory/compat.py`
- [Logging](https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/logger.py): `dohq_artifactory/logger.py`

### Artifactory features

- [Browse and search](https://github.com/devopshq/artifactory/blob/master/artifactory.py): `artifactory.py`
- [Artifact transfers](https://github.com/devopshq/artifactory/blob/master/artifactory.py): `artifactory.py`
- [Artifact operations](https://github.com/devopshq/artifactory/blob/master/artifactory.py): `artifactory.py`
- [AQL and statistics](https://github.com/devopshq/artifactory/blob/master/artifactory.py): `artifactory.py`
- [Builds and promotion](https://github.com/devopshq/artifactory/blob/master/artifactory.py): `artifactory.py`

### Administration

- [Admin API objects](https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/admin.py): `dohq_artifactory/admin.py`
- [Users and groups](https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/admin.py): `dohq_artifactory/admin.py`
- [Repository management](https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/admin.py): `dohq_artifactory/admin.py`
- [Permissions and tokens](https://github.com/devopshq/artifactory/blob/master/dohq_artifactory/admin.py): `dohq_artifactory/admin.py`

### Other components

- **Python user**
- **JFrog Artifactory**

## Connections

- Python user → ArtifactoryPath: constructs and uses (evidence: `README.md`)
- ArtifactoryPath → API key and token auth: configures credentials (evidence: `artifactory.py`)
- ArtifactoryPath → REST requests: issues REST requests (evidence: `artifactory.py`)
- REST requests → JFrog Artifactory: sends requests (evidence: `README.md`)
- ArtifactoryPath → Browse and search: supports browsing (evidence: `README.md`)
- ArtifactoryPath → Artifact transfers: supports transfers (evidence: `README.md`)
- ArtifactoryPath → Artifact operations: supports artifact actions (evidence: `README.md`)
- ArtifactoryPath → AQL and statistics: supports queries and stats (evidence: `README.md`)
- ArtifactoryPath → Builds and promotion: supports build operations (evidence: `README.md`)
- ArtifactoryPath → Admin API objects: exposes admin objects (evidence: `artifactory.py`)
- Admin API objects → Users and groups: provides resource APIs (evidence: `dohq_artifactory/admin.py`)
- Admin API objects → Repository management: provides repository APIs (evidence: `dohq_artifactory/admin.py`)
- Admin API objects → Permissions and tokens: provides security APIs (evidence: `dohq_artifactory/admin.py`)
- Admin API objects → JFrog Artifactory: sends admin requests (evidence: `dohq_artifactory/admin.py`)
- REST requests → HTTP error handling: checks responses (evidence: `artifactory.py`)
- ArtifactoryPath → Pathlib compatibility: uses version checks (evidence: `artifactory.py`)
- ArtifactoryPath → Logging: logs client activity (evidence: `artifactory.py`)
