Reference

index > documentation > reference

  Command line options

    -rn - pattern for report file name. Available substitutions:
        #now_year# - system year
        #now_month# - system month
        #now_day# - system day
        #now_hour# - system hour
        #now_minute# - system minute
        #now_second# - system second

    -cls - if defined, script will clear console screen before testing

    -xml - testing log will be generated in XML format (html is the default value)

    -show_log - testing log will be show automaticaly

    -help - script outputs manual on the screen

    -l <tags> - Here <tags> is a comma separated list of tags and if the script is executed with this option, then only those scripts will be run wich have at least one of the in their description. Values of that parameter can be accumulated if it was defined more than once. For example using this command line python.exe run.py -l tag1 -l tag2 will runs all tests which have tag1 or tag2 in their manifests.

    -lang <lang name> - this command switches on language pack, where <lang name> is the name of the selecting language. If the localisation file was not found then language setting will be defaulted to 'english'.

    -external - if set than each result log will be stored in the separate log file in directory ./logs

    -blank - if set than result log (for each single test) will be opened in the new browser's window.

    -test_id - Parameter filters subtests (see description of the manifest's 'test_id' tag in chapter 'HTTP gateway'). Values of that parameter can be accumulated if it was defined more than once. For example using this command line python.exe run.py -test_id 1,2 tag1 -test_id 2,3 will runs all subtests which have 1, 2 or 3 id.

    -project - using this parameter you can specify manifest for the entire testing session.

    -html_format - if this parameter is set then all logs for all tests will be formatted in HTML way (white spaces will be replaced with &nbsp;, and "\n" will be replaced with <br />).

    -send_logs - this parameter enables 'send logs using email' functionality.

    -send_logs_ftp - this parameter enables 'send logs on ftp server' functionality.

    -email <emails> - Here <email> is a comma separated list of email and if the script is executed with this option, then only those scripts will be run wich authors have one of the email from list in their author. Values of that parameter can be accumulated if it was defined more than once. For example using this command line python.exe run.py -email email1 -email email2 will runs all tests which author's have email1 or email2 in their manifests.

  String functions

  string_utilities - module with string processing functions.

  string_utilities.FindStringInFile( SearchString , FilePath ) - function returns 1 if the SearchString was found in the file with path FilePath.

  string_utilities.FileMatchesRegexp( RegexpPattern , FilePath ) - function returns 1 if the file with path FilePath matches regular expression pattern RegexpPattern.

  Common functions

  utilities - module with different utility functions.

  utilities.GetPlatform() - function returns name of the platform on wich script was executed.

  HTTP functions

  http_utilities provides HTTP requests manipulation routine.

  http_utilities.HTTPRequest( Host , URL , Timeout = 10 , Method = 'POST' ) - function sends HTTP request to the Host with the defined URL. The return value is a dictionary with two keys - 'status' and 'response'.

  http_utilities.HTTPSRequest( Host , URL , Timeout = 10 , Method = 'POST' ) - function sends HTTPS request to the Host with the defined URL. The return value is a dictionary with two keys - 'status' and 'response'.

2009 © Ra Testing Manager