Compass Version1.1

Script List

Scripts are at the core of Compass, each build run that is executed, executes a series of scripts in order.  The scripts do all the heavy lifting for Compass and they also are the key to Compass versatility and expandability since scripts can be added to do virtually anything that a user needs.  Compass is distributed with many common scripts for checking out code from repositories, building source code using common build tools and for running unit tests.   Scripts are managed by site-wide administrators only.  In the Compass Server web interface one of the main menu buttons available to site-wide administrators is 'Scripts'.  After clicking on the 'Scripts' main menu button, a paginated list of all scripts installed on the Compass Server is displayed. Each script in the list is categorized based on script Keywords and if the script is not a built-in script then there is a link to edit the script.  The page also has buttons for adding scripts and unit test parsers and for filtering the script list based on the script keywords. 

The Script List page looks like this right after installation:

There are two types of scripts in Compass, regular scripts and Unit Test Parsers.  Unit Test Parsers are a special type of script that Compass uses to parse the output of a regular script in order to extract information about how many tests succeeded and failed. Unit Test parsers are attached to build steps in the build editor and are run after immediately after the script is run for the build step they are attached to. Because unit test parsers parse the output of a regular script, you will see in the script list pairs of scripts with names like: "PyUnit Test Runner" and "PyUnit Test Parser".  The test runner script executes a unit test and captures the output, then the test parser, parses the output that was captured and determines how many tests succeeded and failed. 

1. Adding Scripts
2. Adding Unit Test Parsers
3. Editing Scripts and Unit Test Parsers
4. Filtering the Script List