testing/mozharness/README.txt

   1 # Mozharness
   2
   3 ## Docs
   4 * https://developer.mozilla.org/en-US/docs/Mozharness_FAQ
   5 * https://wiki.mozilla.org/ReleaseEngineering/Mozharness
   6 * http://moz-releng-mozharness.readthedocs.org/en/latest/mozharness.mozilla.html
   7 * http://moz-releng-docs.readthedocs.org/en/latest/software.html#mozharness
   8
   9 ## Submitting changes
  10 Like any Gecko change, please create a patch or submit to Mozreview and
  11 open a Bugzilla ticket under the Mozharness component:
  12 https://bugzilla.mozilla.org/enter_bug.cgi?product=Release%20Engineering&component=Mozharness
  13
  14 This bug will get triaged by Release Engineering
  15
  16 ## Run unit tests
  17 To run the unit tests of mozharness the `tox` package needs to be installed:
  18
  19 ```
  20 pip install tox
  21 ```
  22
  23 There are various ways to run the unit tests. Just make sure you are within the `$gecko_repo/testing/mozharness` directory before running one of the commands below:
  24
  25 ```
  26 tox                            # run all unit tests
  27 tox -- -x                      # run all unit tests but stop after first failure
  28 tox -- test/test_base_log.py   # only run the base log unit test
  29 ```
  30
  31 Happy contributing! =)
  32