How mozilla/mozregression works
mozregression is an interactive Mozilla-build regression rangefinder. Users provide a known-good and known-bad build or date range, then mozregression finds candidate builds, downloads and launches them, and uses the user's verdicts to narrow the range. The GUI adds guided setup, single-build runs, preferences, and reports. The graph preserves the CLI and GUI entry paths and the core discovery, download, execution, and bisection stages; some GUI and runtime connections are based on the SOURCE INDEX rather than complete excerpts.
Main entry points: mozregression/main.py CLI application · mainwindow.py Main window · fetch_build_info.py Build metadata lookup · mozregui/main.py GUI application
Components 26
User interfaces
- CLI
mozregression/cli.py - CLI application
mozregression/main.py - GUI application
gui/mozregui/main.py - Main window
gui/mozregui/mainwindow.py - Guided setup
gui/mozregui/wizard.py
Build discovery
- Branch catalog
mozregression/branches.py - Build configuration
mozregression/fetch_configs.py - Build ranges
mozregression/build_range.py - Build metadata lookup
mozregression/fetch_build_info.py - Push history
mozregression/json_pushes.py - Build metadata
mozregression/build_info.py - HTTP utilities
mozregression/network.py
Build execution
- Build downloads
mozregression/download_manager.py - Download cache limits
mozregression/persist_limit.py - Application launchers
mozregression/launchers.py - Build test runner
mozregression
Regression analysis
- Bisection engine
mozregression/bisector.py - GUI bisection runner
gui/mozregui/bisection.py - Run reports
gui/mozregui/report.py
Settings and reporting
- Configuration
mozregression/config.py - GUI preferences
gui/mozregui/global_prefs.py - GUI log view
gui/mozregui/log_report.py - Telemetry
mozregression/telemetry.py
Other components
- User
- Mozilla build services
- Mozilla application
Connections 34
- User → CLI: runs
README.md - User → GUI application: opens
README.md - CLI → CLI application: starts
mozregression/cli.py - CLI application → Build configuration: loads configuration
mozregression/main.py - CLI application → Bisection engine: runs bisection
mozregression/main.py - CLI application → Build downloads: manages downloads
mozregression/main.py - CLI application → Application launchers: selects launcher
mozregression/main.py - Build configuration → Branch catalog: resolves branches
mozregression/fetch_configs.py - Build ranges → Build metadata lookup: requests build metadata
mozregression/build_range.py - Build metadata lookup → Build metadata: constructs metadata
mozregression/fetch_build_info.py - Build metadata lookup → Push history: queries push history
mozregression/fetch_build_info.py - Build metadata lookup → HTTP utilities: uses HTTP
mozregression/fetch_build_info.py - Push history → HTTP utilities: uses HTTP
mozregression/json_pushes.py - Build metadata lookup → Mozilla build services: retrieves build data
- Build downloads → Mozilla build services: downloads builds
- Build downloads → Download cache limits: enforces cache limit
mozregression/download_manager.py - CLI application → Build test runner: runs build tests
mozregression/main.py - CLI application → Telemetry: initializes telemetry
mozregression/main.py - Application launchers → Mozilla application: launches
- Bisection engine → Build ranges: creates range
mozregression/bisector.py - Bisection engine → Push history: uses push history
mozregression/bisector.py - GUI application → Main window: creates window
gui/mozregui/main.py - GUI application → GUI preferences: sets defaults
gui/mozregui/main.py - GUI application → GUI log view: attaches log model
gui/mozregui/main.py - Main window → Guided setup: opens setup
gui/mozregui/mainwindow.py - Main window → GUI bisection runner: starts bisection
gui/mozregui/mainwindow.py - Main window → Run reports: displays reports
gui/mozregui/mainwindow.py - Main window → GUI preferences: edits preferences
gui/mozregui/mainwindow.py - GUI bisection runner → Bisection engine: runs bisection
gui/mozregui/bisection.py - GUI bisection runner → Build downloads: coordinates downloads
gui/mozregui/bisection.py - GUI bisection runner → Build test runner: collects verdicts
gui/mozregui/bisection.py - Guided setup → Build configuration: builds configuration
gui/mozregui/wizard.py - Guided setup → Application launchers: checks runnable app
gui/mozregui/wizard.py - GUI preferences → Configuration: reads configuration
gui/mozregui/global_prefs.py