How open-tool/ultron works
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: UltronComposeSemanticsNodeInteraction.kt Compose API · EspressoOperationExecutor.kt Espresso execution · UltronEspressoInteraction.kt Espresso API · uiautomator UI Automator API
Components 17
Test APIs
- Espresso API
ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/UltronEspressoInteraction.kt - Compose API
ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/nodeinteraction/UltronComposeSemanticsNodeInteraction.kt - Compose matchers
ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/extensions/SemanticsMatcherExt.kt - RecyclerView lists
ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/recyclerview - Compose lazy lists
ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/list - WebView API
ultron-android/src/main/kotlin/com/atiurin/ultron/core/espressoweb - UI Automator API
ultron-android/src/main/kotlin/com/atiurin/ultron/core/uiautomator
Operation Runtime
- Runtime config
ultron-android/src/main/kotlin/com/atiurin/ultron/core/config/UltronConfig.kt - Shared operation model
ultron-common/src/commonMain/kotlin/com/atiurin/ultron/core/common - Espresso execution
ultron-android/src/main/kotlin/com/atiurin/ultron/core/espresso/EspressoOperationExecutor.kt - UI Automator execution
ultron-android/src/main/kotlin/com/atiurin/ultron/core/uiautomator/UiAutomatorOperationExecutor.kt - Compose execution
ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/operation/UltronComposeOperation.kt
Test Lifecycle
- Test lifecycle
ultron-common/src/androidMain/kotlin/com/atiurin/ultron/testlifecycle - Operation listeners
ultron-common/src/commonMain/kotlin/com/atiurin/ultron/listeners/AbstractListenersContainer.kt
Reporting
- Screenshots and hierarchy
ultron-common/src/androidMain/kotlin/com/atiurin/ultron/screenshot - Allure reporting
ultron-allure/src/main/java/com/atiurin/ultron/allure
Other components
- Test author
Connections 17
- 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
ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/extensions/SemanticsMatcherExt.kt - Espresso API → Espresso execution: executes operations
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
ultron-compose/src/commonMain/kotlin/com/atiurin/ultron/core/compose/nodeinteraction/UltronComposeSemanticsNodeInteraction.kt - Compose API → Shared operation model: uses shared operation data
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