The mozcommitbuilder package is a generic builder library for Mozilla Firefox. Interactive regression finding over changesets using local builds.
Downloads the mozilla-central mercurial repository to a local cache and allows operations on that trunk including interactive regression finding over changeset ranges and building particular revisions of firefox and running them. In particular, this module was designed for regression hunting and to provide a flexible builder for firefox.
Mercurial. A correctly-configured mozconfig dotfile is optional. By default, mozcommitbuilder generates its own mozconfig, but you can pass in your own through params/cli if the script fails to build correctly or if you need other configurations..
mozcommitbuilder is available on pypi, so you can install it with easy_install or pip. The recommended method is pip.
sudo pip install mozcommitbuilder --upgrade
#This is an example of a command to do interactive bisection between #changesets (you can use the full changeset hash or short numerical id) mozcommitbuilder -g 70168 -b 70180
#If you are on OSX or Linux, this will compile with 8 cores. Multi-core #compiliation on windows doesn't work, the parameter will be ignored. mozcommitbuilder -g 70168 -b 70180 -c 8
#This will delete the cached trunk and download a new one, then build #revision 70168 with 8 cores mozcommitbuilder -f --single=70168 -c 8
#This will delete the cached trunk and download a new one, then build #revision 70168 with 8 cores, then start firefox on completion. mozcommitbuilder -f -e --single=70168 -c 8
#Instantiation from mozcommitbuilder import Builder commitBuilder = Builder() # Optional Constructor Params: """ 1. makeCommand, default=["make","-f","client.mk","build"] 2. cores, default=1 3. mozconf, default=None (create our own) 4. shellCacheDir, default=~/moz-commitbuilder-cache (where to instantiate the cache) 5. repoURL, default=moz-central repository URL 6. clean, default=False (make clean trunk) """ #Example: commitBuilder = Builder(cores=8, mozconf="~/myDirectory/mozconf") #custom mozconf #build with 8 cores
#Remote Trunk Operations: commitBuilder.getTrunk() # fetches a local trunk commitBuilder.getBinary("70168") # Builds binary from revision, # moves into the cache directory # returns the path to it
#Bisection: commitBuilder.bisect("goodchangesetRev","badchangesetRev") # Interactive bisection
#Building and running: commitBuilder.build(changeset="70168") # Build only commitBuilder.run() # Run. Warning: ungraceful failure if build hasn't happened yet. commitBuilder.buildAndRun(changeset="70168") # Build rev and run
#Repository information: mostRecentChangeset = commitBuilder.getTip() #Returns tip's changest number firstChangesetFromDay = commitBuilder.changesetFromDay(date="2011-06-31") #Get first changeset from date lastChangesetFromDay = commitBuilder.changesetFromDay(date="2011-06-31",oldest=False) #Last changeset from date
For bisection: if the range of commits spans more than a day, try mozregression