Configuration

Log options

The Test Engine maintains a log of all activity. All of these options work in both the startup and project files.

These options are located in the log section.

name   append
default   false
description  

If True, the Test Engine preserves the existing log in file_name (if save is true).

Note: if html is true, then append is ignored

 

name   file_name
default   (see description)
description  

If the save option is true, then this is name of the file to which the log is saved. You can use any path and file name. If the value is a relative path, then it is resolved relative to the 'logs' location.

The default file names are:

startup   startup_log.txt (startup_log.html if html is true)
project   <project_name>_log.txt (<project_name>_log.html if html is true)

 

name   filter
default   warnings
description  

Tells the log which messages to record (and which to ignore). You can use any of the following values (each level includes those above it):

none   Only system messages are recorded
user   Trace messages are recorded
alerts   Errors are recorded
warnings   Warnings are recorded
all   Information messages are recorded

 

name   flush
default   false
description  

If True, the Test Engine writes every log message to file immediately. This should only be used for debugging when the application is crashing. It can sgnificantly slow down the Test Engine.

 

name   granularity
default   500
description  

Sets how many log messages to remove from memory when limit is reached. Larger numbers means the log flushes less often, but remains near the limit less.

 

name   html
default   false
description  

If True, the Test Engine saves the log in HTML format (if save is true).

Note: if html is true, then append is ignored

 

name   limit
default   1000
description  

Sets the number of log messages to keep in memory at one time. Lower this value to decrease memory usage. Increase this value when debugging if the log window doesn't display enough information.

 

name   save
default   true
description  

If True, the Test Engine saves the log to file_name.

 

name   show
default   false
description  

If True, the Test Engine opens the log window as soon as possible. Use this feature to watch your project initializing and look for errors and/or warnings.

Example

[log]
file_name=errors.txt ; will be located in the 'logs' location
show=true
filter=all
html=true