Skip to main content

Regression range finder for Mozilla nightly builds

Project description

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:

Status

Latest Version License

Build status:

  • Linux: Coverage Status

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:

  1. Be sure you are using Python 3.8 or above: earlier versions are not supported (if you are not sure, run python --version or python3 --version on the command line).

  2. 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.yml in 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.gz and extract it in gui/dist.
  • Run ./bin/dmgbuild.
  • Upload new dmg artifact (gui/dist/mozregression-gui.dmg) to the corresponding release.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mozregression-6.3.0.tar.gz (70.6 kB view details)

Uploaded Source

Built Distribution

mozregression-6.3.0-py3-none-any.whl (76.3 kB view details)

Uploaded Python 3

File details

Details for the file mozregression-6.3.0.tar.gz.

File metadata

  • Download URL: mozregression-6.3.0.tar.gz
  • Upload date:
  • Size: 70.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.15

File hashes

Hashes for mozregression-6.3.0.tar.gz
Algorithm Hash digest
SHA256 f5023f5264e182fe5a913531426a14f89e326345404f33d90acbdaebd6cea0b1
MD5 300953047cc8da627052cc8df8f8d075
BLAKE2b-256 71448671d2cc57b9a52103bf2ae8d3ab2f9356d900b38d6c325cf000ee0f92f5

See more details on using hashes here.

File details

Details for the file mozregression-6.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mozregression-6.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3112889224f11985337635036d6ff5e1295669a994147955b7808c590a977da5
MD5 2e649131093fdf3a3ff1a6db44273d2e
BLAKE2b-256 e714dd6a57b6d745a23d07d74aea0c2964411d84e1fc974234dab7c182130658

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page