QA/TDAI/RegressionRangeFinder: Difference between revisions

Replaced content with "Interactive regression range finder for Firefox/Thunderbird nightly builds [http://harthur.github.com/mozregression/ http://harthur.github.com/mozregression/]"
No edit summary
(Replaced content with "Interactive regression range finder for Firefox/Thunderbird nightly builds [http://harthur.github.com/mozregression/ http://harthur.github.com/mozregression/]")
 
Line 1: Line 1:
mozregression is a python command-line tool for finding a bug's regression range on Firefox nightly builds. Use the [https://wiki.mozilla.org/QA/TDAI/RegressionRangeInstall installation instructions] for your platform.
Interactive regression range finder for Firefox/Thunderbird nightly builds [http://harthur.github.com/mozregression/ http://harthur.github.com/mozregression/]
 
As an example, if you know a bug wasn't present in the nightly for Feb 3 2009, but is present in today's nightly, you can run this command-line:<pre>python regression.py -g 2009-02-03</pre>
 
This will download and run a series of nightly builds on a new, clean profile. When a new browser window pops up you can do whatever you need to do to verify the bugs presence in that build, then type 'good' or 'bad' into the prompt depending on whether the bug is present in that build.
 
After you've tried enough builds (about 7 for a 100-day initial regression range), you'll see something like this:
 
<pre>Last good nightly: 2009-12-22 First bad nightly: 2009-12-23
 
Pushlog: http://hg.mozilla.org/mozilla-central/pushloghtml?fromchange=1f0e04dc2b21&tochange=f8b8f2f214d6
</pre>
 
 
this is good information to paste into a Bugzilla comment. The pushlog url will show you all the code checkins that occurred during the regression range.
 
 
=Other features=
mozregression has a few command line options:
<table>
<tr>
  <td><tt>-b YYYY-MM-DD, --bad=YYYY-MM-DD</tt></td>
  <td>first known bad nightly build, default is today</td>
</tr>
<tr>
  <td><tt>-g YYYY-MM-DD, --good=YYYY-MM-DD</tt></td>
  <td>last known good nightly build <b>*required</b></td>
</tr>
<tr>
  <td><tt>-e PATH1,PATH2, --extensions=PATH1,PATH2</tt>&nbsp;&nbsp;</td>
  <td>list of extensions to install (path)</td>
</tr>
<tr>
  <td><tt>-p PATH, --profile=PATH</tt></td>
  <td>profile to use with nightlies (path)</td>
</tr>
<tr>
  <td><tt>-a ARG1,ARG2, --args=ARG1,ARG2</tt></td>
  <td>command-line arguments to pass to Firefox</td>
</tr>
</table>
 
 
Also, mozregression has a sister script, runnightly, that you can use to download and run a nightly from a particular date:<pre>python runnightly.py -d 2010-02-15</pre>
865

edits