Compass Version1.1

Adding a New 'Subversion Argument Update' Script

Now that we have a build plan all set up, it would be nice if we didn't have to wait for a complete checkout every time our build plan executes.  In order to do that, we need a script that can do an 'svn update' instead of an 'svn checkout', but Compass does not come with such a script, so we need to add one.  We can add a script on the Script List page, which we get to by clicking on the 'Scripts' tab in the main title bar at the top of the screen.  On the scripts list page we click on the 'Create New Script' button which brings up the 'Create New Script' dialog.

All we need to do is fill in this dialog and we'll have our new script.  The Dialog looks like this when it first comes up:

For an svn update script we need to fill in 4 sections of this dialog.  We give our script a name: 'SVN Argument Update'.  For the Command we give: 'svn up --non-interactive %(ARG)'.   We provide some usage notes and add the 'subversion' keyword and we're done.  The command that we provided uses the Compass specific syntax '%(ARG)' to denote that this is the place in the command that the build step arguments will be inserted (or where the defaults will be inserted when they are needed).  For complex scripts, see the documentation section on creating scripts for more information on the command syntax. 

Once we have filled in the four sections on this dialog it looks like this:

After clicking 'Create' the new script will be added to the script list and will be usable from the build editor.