# open-tool/ultron architecture

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

- Interactive diagram: https://gitdiagram.com/open-tool/ultron
- Repository: https://github.com/open-tool/ultron

## Overview

Ultron is a UI-testing framework for Android and Compose Multiplatform, wrapping Espresso, UI Automator, and Compose testing APIs. A test author expresses screen interactions and assertions through Ultron; its operation layers execute them with stability controls and report results. The graph also preserves documented list, WebView, lifecycle, listener, and Allure capabilities. Some of these subsystems are represented by their existing source directories because their implementation files were not sampled; their documented relationships cite the README.

Main entry points: [`ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/nodeinteraction/UltronComposeSemanticsNodeInteraction.kt`](https://github.com/open-tool/ultron/blob/master/ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/nodeinteraction/UltronComposeSemanticsNodeInteraction.kt) (Compose API), [`ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/EspressoOperationExecutor.kt`](https://github.com/open-tool/ultron/blob/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/EspressoOperationExecutor.kt) (Espresso execution), [`ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/UltronEspressoInteraction.kt`](https://github.com/open-tool/ultron/blob/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/UltronEspressoInteraction.kt) (Espresso API), [`ultron-android/src/main/kotlin/com/atiurin/ultron/core/uiautomator`](https://github.com/open-tool/ultron/tree/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/uiautomator) (UI Automator API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Test APIs"]
  node_espresso["Espresso API"]
  node_compose["Compose API"]
  node_composematch["Compose matchers"]
  node_recycler["RecyclerView lists"]
  node_composelist["Compose lazy lists"]
  node_webview["WebView API"]
  node_uiautomator["UI Automator API"]
end

subgraph group_ops["Operation Runtime"]
  node_config["Runtime config<br/>[UltronConfig.kt]"]
  node_common["Shared operation model"]
  node_espressoexec["Espresso execution"]
  node_uiaexec["UI Automator execution"]
  node_composeexec["Compose execution"]
end

subgraph group_lifecycle["Test Lifecycle"]
  node_lifecycle["Test lifecycle"]
  node_listeners["Operation listeners"]
end

subgraph group_reports["Reporting"]
  node_artifacts["Screenshots and hierarchy"]
  node_allure["Allure reporting"]
end

node_author(("Test author"))

node_author -->|"defines UI checks"| node_espresso
node_author -->|"defines UI checks"| node_compose
node_author -->|"targets list items"| node_recycler
node_author -->|"targets list items"| node_composelist
node_author -->|"tests web views"| node_webview
node_author -->|"tests device UI"| node_uiautomator
node_composematch -->|"creates interactions"| node_compose
node_espresso -->|"executes operations"| node_espressoexec
node_espressoexec -->|"uses configuration"| node_config
node_espressoexec -->|"uses shared operation data"| node_common
node_compose -->|"dispatches operations"| node_composeexec
node_compose -->|"uses shared operation data"| node_common
node_uiautomator -.->|"executes operations"| node_uiaexec
node_author -->|"configures setup teardown"| node_lifecycle
node_author -->|"monitors operations"| node_listeners
node_author -->|"generates reports"| node_allure
node_allure -.->|"attaches artifacts"| node_artifacts

click node_espresso "https://github.com/open-tool/ultron/blob/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/UltronEspressoInteraction.kt"
click node_compose "https://github.com/open-tool/ultron/blob/master/ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/nodeinteraction/UltronComposeSemanticsNodeInteraction.kt"
click node_composematch "https://github.com/open-tool/ultron/blob/master/ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/extensions/SemanticsMatcherExt.kt"
click node_recycler "https://github.com/open-tool/ultron/tree/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/recyclerview"
click node_composelist "https://github.com/open-tool/ultron/tree/master/ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/list"
click node_webview "https://github.com/open-tool/ultron/tree/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/espressoweb"
click node_uiautomator "https://github.com/open-tool/ultron/tree/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/uiautomator"
click node_config "https://github.com/open-tool/ultron/blob/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/config/UltronConfig.kt"
click node_common "https://github.com/open-tool/ultron/tree/master/ultron-common/src/commonMain/kotlin/com/atiurin/ultron/core/common"
click node_espressoexec "https://github.com/open-tool/ultron/blob/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/EspressoOperationExecutor.kt"
click node_uiaexec "https://github.com/open-tool/ultron/blob/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/uiautomator/UiAutomatorOperationExecutor.kt"
click node_composeexec "https://github.com/open-tool/ultron/blob/master/ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/operation/UltronComposeOperation.kt"
click node_lifecycle "https://github.com/open-tool/ultron/tree/master/ultron-common/src/androidMain/kotlin/com/atiurin/ultron/testlifecycle"
click node_listeners "https://github.com/open-tool/ultron/blob/master/ultron-common/src/commonMain/kotlin/com/atiurin/ultron/listeners/AbstractListenersContainer.kt"
click node_artifacts "https://github.com/open-tool/ultron/tree/master/ultron-common/src/androidMain/kotlin/com/atiurin/ultron/screenshot"
click node_allure "https://github.com/open-tool/ultron/tree/master/ultron-allure/src/main/java/com/atiurin/ultron/allure"

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_espresso,node_compose,node_composematch,node_recycler,node_composelist,node_webview,node_uiautomator toneBlue
class node_config,node_common,node_espressoexec,node_uiaexec,node_composeexec toneAmber
class node_lifecycle,node_listeners toneMint
class node_artifacts,node_allure toneRose
class node_author toneIndigo
```

## Components

### Test APIs

- [Espresso API](https://github.com/open-tool/ultron/blob/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/UltronEspressoInteraction.kt): `ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/UltronEspressoInteraction.kt`
- [Compose API](https://github.com/open-tool/ultron/blob/master/ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/nodeinteraction/UltronComposeSemanticsNodeInteraction.kt): `ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/nodeinteraction/UltronComposeSemanticsNodeInteraction.kt`
- [Compose matchers](https://github.com/open-tool/ultron/blob/master/ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/extensions/SemanticsMatcherExt.kt): `ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/extensions/SemanticsMatcherExt.kt`
- [RecyclerView lists](https://github.com/open-tool/ultron/tree/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/recyclerview): `ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/recyclerview`
- [Compose lazy lists](https://github.com/open-tool/ultron/tree/master/ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/list): `ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/list`
- [WebView API](https://github.com/open-tool/ultron/tree/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/espressoweb): `ultron-android/src/main/kotlin/com/atiurin/ultron/core/espressoweb`
- [UI Automator API](https://github.com/open-tool/ultron/tree/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/uiautomator): `ultron-android/src/main/kotlin/com/atiurin/ultron/core/uiautomator`

### Operation Runtime

- [Runtime config](https://github.com/open-tool/ultron/blob/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/config/UltronConfig.kt): `ultron-android/src/main/kotlin/com/atiurin/ultron/core/config/UltronConfig.kt`
- [Shared operation model](https://github.com/open-tool/ultron/tree/master/ultron-common/src/commonMain/kotlin/com/atiurin/ultron/core/common): `ultron-common/src/commonMain/kotlin/com/atiurin/ultron/core/common`
- [Espresso execution](https://github.com/open-tool/ultron/blob/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/EspressoOperationExecutor.kt): `ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/EspressoOperationExecutor.kt`
- [UI Automator execution](https://github.com/open-tool/ultron/blob/master/ultron-android/src/main/kotlin/com/atiurin/ultron/core/uiautomator/UiAutomatorOperationExecutor.kt): `ultron-android/src/main/kotlin/com/atiurin/ultron/core/uiautomator/UiAutomatorOperationExecutor.kt`
- [Compose execution](https://github.com/open-tool/ultron/blob/master/ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/operation/UltronComposeOperation.kt): `ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/operation/UltronComposeOperation.kt`

### Test Lifecycle

- [Test lifecycle](https://github.com/open-tool/ultron/tree/master/ultron-common/src/androidMain/kotlin/com/atiurin/ultron/testlifecycle): `ultron-common/src/androidMain/kotlin/com/atiurin/ultron/testlifecycle`
- [Operation listeners](https://github.com/open-tool/ultron/blob/master/ultron-common/src/commonMain/kotlin/com/atiurin/ultron/listeners/AbstractListenersContainer.kt): `ultron-common/src/commonMain/kotlin/com/atiurin/ultron/listeners/AbstractListenersContainer.kt`

### Reporting

- [Screenshots and hierarchy](https://github.com/open-tool/ultron/tree/master/ultron-common/src/androidMain/kotlin/com/atiurin/ultron/screenshot): `ultron-common/src/androidMain/kotlin/com/atiurin/ultron/screenshot`
- [Allure reporting](https://github.com/open-tool/ultron/tree/master/ultron-allure/src/main/java/com/atiurin/ultron/allure): `ultron-allure/src/main/java/com/atiurin/ultron/allure`

### Other components

- **Test author**

## Connections

- Test author → Espresso API: defines UI checks
- Test author → Compose API: defines UI checks
- Test author → RecyclerView lists: targets list items
- Test author → Compose lazy lists: targets list items
- Test author → WebView API: tests web views
- Test author → UI Automator API: tests device UI
- Compose matchers → Compose API: creates interactions (evidence: `ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/extensions/SemanticsMatcherExt.kt`)
- Espresso API → Espresso execution: executes operations (evidence: `ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/UltronEspressoInteraction.kt`)
- Espresso execution → Runtime config: uses configuration
- Espresso execution → Shared operation model: uses shared operation data
- Compose API → Compose execution: dispatches operations (evidence: `ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/nodeinteraction/UltronComposeSemanticsNodeInteraction.kt`)
- Compose API → Shared operation model: uses shared operation data (evidence: `ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/nodeinteraction/UltronComposeSemanticsNodeInteraction.kt`)
- UI Automator API → UI Automator execution: executes operations
- Test author → Test lifecycle: configures setup teardown
- Test author → Operation listeners: monitors operations
- Test author → Allure reporting: generates reports
- Allure reporting → Screenshots and hierarchy: attaches artifacts
