PlaySmith: The TestSmith Command Line Playback Engine

PlaySmith is a simple command line program that can run a single TestSmith script, and display the report in a specified browser. PlaySmith reads all its settings in from the testsmith.settings file which is located in the /QualityForge/TestSmith/System directory. For additional information about how these settings are used please see the Playback Options section of the User Guide. Be warned that the values in the testsmith.settings file are not shared with the TestSmith application.

Running PlaySmith

You are advised to add the path containing the PlaySmith.exe application (by default this is <install_location>\QualityForge\TestSmith) to your system PATH variable. This will allow you to run PlaySmith from the command line, regardless of the current working directory.

When you run PlaySmith without any parameters you will see the main help screen, which looks like this 


      PlaySmith:


      The TestSmith Command-Line Script Player (v1.1.2)


      ----------------------------------------------------------





      Syntax:  playsmith script_name [-noreport]





      script_name - full path name of the script to run


      -noreport   - suppress the playback report window





      ----------------------------------------------------------


      For more information please see the User Guide at


      http://agilethinking.net/qualityforge/testsmith/userguide/playsmith.html
 The script_name must be the full path name of the script to run, e.g. D:\myscripts\test1.smith.
Only use the -noreport argument if you do not want to see the report at the end of playback. By default the report is opened in the application specified for the InternetBrowser setting in the testsmith.settings file once the playback has completed. Reports generated from PlaySmith playback will have "_PS" appended to the script name, thus for the script named test1.smith the report will be named test1_PS.tsrep.

Progress Indicator

PlaySmith shows script progress by outputting a character to the console for each script command that is executed. For OK results it is a dot (.) character, for ERR results it is a exclamation (!) character. Output to the console from a script run with 3 errors will look similar to this: 


      C:\QualityForge> playsmith.exe myscript.smith





      ...................................................!!.......


      .....!.....





         Error count = 3


         Return code = 1