How mherrmann/helium works
Helium is a Python browser-automation library: a script calls its high-level API to start or control a browser, identify page elements by visible labels or selectors, and perform interactions or waits. The API delegates to an implementation layer that drives Selenium; element matching and frame-aware wrappers support that work. The README documents nested-frame interaction, popup/window handling, implicit waits, and explicit waits. Some of those behaviors are documented but not independently mapped to sampled implementation files.
Main entry points: _impl/__init__.py Automation engine · helium/__init__.py Helium API · selenium_wrappers.py Selenium wrappers · match_type.py Text match rules
Components 16
Public API
- Helium API
helium/__init__.py
Automation Runtime
- Automation engine
helium/_impl/__init__.py - Selenium wrappers
helium/_impl/selenium_wrappers.py - Frame navigation
helium/_impl/selenium_wrappers.py
Element Matching
- Element search
helium/_impl/__init__.py - Text match rules
helium/_impl/match_type.py
Runtime Support
- XPath helpers
helium/_impl/util/xpath.py - Element geometry
helium/_impl/util/geom.py - Dictionary helper
helium/_impl/util/dictionary.py - HTML helpers
helium/_impl/util/html.py - Argument inspection
helium/_impl/util/inspect_.py - Language helpers
helium/_impl/util/lang.py - System information
helium/_impl/util/system.py
Other components
- Automation script
- Chrome or Firefox
- Selenium WebDriver
Connections 15
- Automation script → Helium API: calls
README.md - Helium API → Automation engine: delegates
helium/__init__.py - Automation engine → Element search: searches
helium/_impl/__init__.py - Element search → Text match rules: matches text
helium/_impl/__init__.py - Text match rules → XPath helpers: builds predicates
helium/_impl/match_type.py - Automation engine → Selenium wrappers: uses wrappers
helium/_impl/__init__.py - Selenium wrappers → Frame navigation: iterates frames
helium/_impl/selenium_wrappers.py - Selenium wrappers → Element geometry: uses geometry
helium/_impl/selenium_wrappers.py - Automation engine → Dictionary helper: uses helper
helium/_impl/__init__.py - Automation engine → System information: checks platform
helium/_impl/__init__.py - Helium API → HTML helpers: uses helpers
helium/__init__.py - Helium API → Argument inspection: uses inspection
helium/__init__.py - Argument inspection → Language helpers: checks binding
helium/_impl/util/inspect_.py - Automation engine → Selenium WebDriver: issues commands
README.md - Selenium WebDriver → Chrome or Firefox: controls
README.md