mozregression
mozregression is an interactive regression rangefinder for quickly tracking down the source of bugs in Mozilla nightly and integration builds.
You can start using mozregression today:
- start with our installation guide, then
- take a look at our Quick Start document.
Status
Build status:
- Linux:
For more information see:
https://mozilla.github.io/mozregression/
Contact
You can chat with the mozregression developers on Mozilla's instance of Matrix: https://chat.mozilla.org/#/room/#mozregression:mozilla.org
Issue Tracking
Found a problem with mozregression? Have a feature request? We track bugs on bugzilla. You can file a new bug here.
Building And Developing mozregression
Want to hack on mozregression ? Cool!
Installing dependencies
To make setup more deterministic, we have provided requirements files to use a known-working set of python dependencies. From your mozregression checkout, you can install these inside a virtual development environment.
After checking out the mozregression repository from GitHub, this is a two step process:
-
Be sure you are using Python 3.8 or above: earlier versions are not supported (if you are not sure, run
python --versionorpython3 --versionon the command line). -
From inside your mozregression checkout, create a virtual environment, activate it, and install the dependencies. The instructions are slightly different depending on whether you are using Windows or Linux/MacOS.
On Windows:
python3 -m venv venv
venv\Scripts\activate
pip install -r requirements\requirements-3.9-Windows.txt
pip install -e .
On Linux:
python3 -m venv venv
source venv/bin/activate
pip install -r requirements/requirements-3.9-Linux.txt
pip install -e .
On macOS:
python3 -m venv venv
source venv/bin/activate
pip install -r requirements/requirements-3.9-macOS.txt
pip install -e .
NOTE: You should replace the Python version with the one that matches with the virtual environment.
Hacking on mozregression
After running the above commands, you should be able to run the command-line version of
mozregression as normal (e.g. mozregression --help) inside the virtual environment. If
you wish to try running the GUI, use the provided helper script:
python gui/build.py run
To run the unit tests for the console version:
pytest tests
For the GUI version:
python gui/build.py test
Before submitting a pull request, please lint your code for errors and formatting (we use black, flake8 and isort)
./bin/lint-check.sh
If it turns up errors, try using the lint-fix.sh script to fix any errors which can be addressed automatically:
./bin/lint-fix.sh
Making a release
Create a new GitHub release and give it a tag name identical to the version number you want (e.g. 4.0.20). CI should automatically upload new versions of the GUI applications to the release and to TestPyPI and PyPI.
Follow the following conventions for pre-releases:
- For development releases, tags should be appended with .devN, starting with N=0. For example, 6.2.1.dev0.
- For alpha, beta, or release candidates, tags should be appended with aN, bN, or rcN, starting with N=0. For example, 6.2.1a0.dev4, 6.2.1rc2, etc...
For more info, see PEP 440.
Signing and notarizing macOS releases
Uploading the signed artifacts is a manual process at this time. To sign and notarize a macOS release, follow these steps:
- Copy the signing manifest output from the build job.
- Create a pull request to update
signing-manifests/mozregression-macOS.ymlin the adhoc-signing repo with those changes. - Wait for pull request to be merged, and the signing task to finish.
- After the signing task is finished, download
mozregression-gui-app-bundle.tar.gzand extract it ingui/dist. - Run
./bin/dmgbuild. - Upload new dmg artifact (gui/dist/mozregression-gui.dmg) to the corresponding release.
Release files for mozregression 7.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mozregression-7.4.0.tar.gz | 71.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mozregression-7.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 149.5 kB
Release files / mozregression-7.4.0.tar.gz
| Download URL | mozregression-7.4.0.tar.gz |
|---|---|
| Size | 71.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
174288b5d4d726549ab05c8f89253b2b437042d2ac41fb4f81fe1d2b0cef7078
|
|
BLAKE2b-256 checksum How to use checksums |
4442fde4883ee0550b564cceffecb4a2c50ad6dde1b476641e28e1268581bdc8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|
Release files / mozregression-7.4.0-py3-none-any.whl
| Download URL | mozregression-7.4.0-py3-none-any.whl |
|---|---|
| Size | 77.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
90937ebfa525b4e1ccc650d4d3c48275a2fbc1704d0aa3473ac7b8d868834254
|
|
BLAKE2b-256 checksum How to use checksums |
599eecf74cc0f1bebbbac3abd96fe2d8fc94d643245446ca209dd64aa4e99f8b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.21
|
