Texttest.org

Navigation: home >documentation 3 15>configfile default

Documentation for 3.15

General	Interfaces	Configuration Reference
Overview of docs Installation guide Troubleshooting Tutorials Getting Started Testing a GUI Course material Screencast Basic Setup Test Suite Guide Managing test data Filtering the output Tests that write files File formats	Interface overview The Static GUI The Dynamic GUI Personalising the GUIs Batch Mode Additional Features Versions and Version Control Mocking things out CPU time and memory Automatic failure interpretation Running tests remotely Running tests in parallel Write your own configuration	Default Configuration: Config files Running/selecting options Environment variables Plugin scripts Queuesystem Configuration: (description) Config files Running/selecting options Environment variables Plugin scripts Personal Preferences: Personal GUI settings

Other versions: trunk 4.3 4.0 3.27 Older...

Possible entries for config files (application or personal)

(using the default configuration)

The file format documentation shows you how to change these entries in your config files, and explains the meaning of the "Type" column in this table.

Entry name	Type	Default Value	Brief text (links to documentation)
auto_sort_test_suites	Int	0	Automatically sort test suites in alphabetical order. 1 means sort in ascending order, -1 means sort in descending order.
base_version	List	<empty>	Versions to inherit settings from
batch_collect_compulsory_version	CompositeDictionary (List)	<empty>	When collecting multiple messages, which versions should be expected and give an error if not present?
batch_collect_max_age_days	CompositeDictionary (Int)	100000	When collecting multiple messages, what is the maximum age of run that we should accept?
batch_extra_version	CompositeDictionary (List)	<empty>	Versions to be run in addition to the one specified, for particular batch sessions
batch_filter_file	CompositeDictionary (List)	<empty>	Generic filter for batch session, more flexible than timelimit
batch_mail_on_failure_only	CompositeDictionary (String)	false	Send mails only if at least one test fails
batch_recipients	CompositeDictionary (String)	$USER@localhost	Addresses to send mail to in batch mode
batch_result_repository	CompositeDictionary (String)	<empty>	Directory to store historical batch results under
batch_sender	CompositeDictionary (String)	$USER@localhost	Sender address to use sending mail in batch mode
batch_timelimit	CompositeDictionary (String)	<empty>	Maximum length of test to include in batch mode runs
batch_use_collection	CompositeDictionary (String)	false	Do we collect multiple mails into one in batch mode
batch_use_version_filtering	CompositeDictionary (String)	false	Which batch sessions use the version filtering mechanism
batch_version	CompositeDictionary (List)	<empty>	List of versions to allow if batch_use_version_filtering enabled
binary	String	<empty>	Alias. See entry for 'executable'
binary_file	List	<empty>	Which output files are known to be binary, and hence should not be shown/diffed?
bug_system_location	Dictionary (String)	<empty>	The location of the bug system we wish to extract failure information from.
catalogue_process_string	String	<empty>	String for catalogue functionality to identify processes created
checkout_location	CompositeDictionary (List)	<empty>	Absolute paths to look for checkouts under
collate_file	Dictionary (List)	stacktrace : core* (UNIX) <empty> (Windows)	Mapping of result file names to paths to collect them from
collate_script	CompositeDictionary (List)	default : <empty> stacktrace : interpretcore.py (UNIX) <empty> (Windows)	Mapping of result file names to scripts which turn them into suitable text
collect_traffic	CompositeDictionary (List)	asynchronous : <empty> default : <empty>	List of command-line programs to intercept
collect_traffic_environment	CompositeDictionary (List)	<empty>	Mapping of collected programs to environment variables they care about
config_module	String	default	Configuration module to use
copy_test_path	List	<empty>	Paths to be copied to the sandbox when running tests
copy_test_path_merge	List	<empty>	Directories to be copied to the sandbox, and merged together
cputime_include_system_time	Int	0	Include system time when measuring CPU time?
create_catalogues	String	false	Do we create a listing of files created/removed by tests
default_checkout	String	<empty>	Default checkout, relative to the checkout location
default_filter_file	List	<empty>	Filter file to use by default, generally only useful for versions
default_interface	String	static_gui	Which interface to start if none of -con, -g and -gx are provided
default_machine	String	localhost	Default machine to run tests on
default_texttest_tmp	String	$TEXTTEST_PERSONAL_CONFIG/tmp	Default value for $TEXTTEST_TMP, if it is not set
definition_file_stems	CompositeDictionary (List)	builtin : environment, properties, testsuite, options, input, knownbugs default : <empty> regenerate : usecase, traffic	files to be shown as definition files by the static GUI
diff_program	CompositeDictionary (String)	tkdiff	External program to use for graphical file comparison
discard_file	List	<empty>	List of generated result files which should not be compared
executable	String	<empty>	Full path to the System Under Test
extra_config_directory	CompositeDictionary (List)	<empty>	Alias. See entry for 'extra_search_directory'
extra_search_directory	CompositeDictionary (List)	<empty>	Additional directories to search for TextTest files
extra_version	List	<empty>	Versions to be run in addition to the one specified
failure_display_priority	CompositeDictionary (Int)	99	Mapping of result files to which order they should be shown in the text info window.
failure_severity	CompositeDictionary (Int)	catalogue : 2 default : 99 errors : 1 output : 1 performance : 2 traffic : 1 usecase : 1	Mapping of result files to how serious diffs in them are
filter_file_directory	List	filter_files	Default directories for test filter files, relative to an application directory.
floating_point_tolerance	CompositeDictionary (Float)	0.0	Which tolerance to apply when comparing floating point values in output
follow_file_by_default	Int	0	When double-clicking running files, should we follow progress or just view them?
follow_program	CompositeDictionary (String)	xterm -bg white -T $TEXTTEST_FOLLOW_FILE_TITLE -e tail -f (UNIX) baretail (Windows)	External program to use for following progress of a file
full_name	String	<app> (capitalised)	Expanded name to use for application
gui_entry_options	CompositeDictionary (List)	<empty>	Default drop-down box options for GUI entries
gui_entry_overrides	CompositeDictionary (String)	<not set>	Default settings for entries in the GUI
historical_report_colours	Dictionary (String)	column_header_bg : gray1 failure_bg : #FF3118 memory_bg : pink no_results_bg : gray2 performance_bg : #FFC6A5 performance_fg : red6 row_header_bg : #FFFFCC run_friday_fg : black run_monday_fg : black run_saturday_fg : black run_sunday_fg : black run_thursday_fg : black run_tuesday_fg : black run_wednesday_fg : black success_bg : #CEEFBD test_default_fg : black	Colours to use for historical batch HTML reports
historical_report_location	CompositeDictionary (String)	<empty>	Directory to create reports on historical batch data under
historical_report_page_name	CompositeDictionary (String)	<app> (capitalised)	Header for page on which this application should appear
historical_report_subpage_cutoff	CompositeDictionary (Int)	Last six runs : 6 default : 100000	How many runs should the subpage show, starting from the most recent?
historical_report_subpage_weekdays	CompositeDictionary (List)	<empty>	Which weekdays should the subpage apply to (empty implies all)?
historical_report_subpages	CompositeDictionary (List)	Last six runs	Names of subselection pages to generate as part of historical report
home_operating_system	String	any	Which OS the test results were originally collected on
import_config_file	List	<empty>	Extra config files to use
interactive_action_module	String	default_gui	Module to search for InteractiveActions for the GUI
interpreter	String	<empty>	Program to use as interpreter for the SUT
lines_of_text_difference	Int	30	How many lines to present in textual previews of file diffs
link_test_path	List	<empty>	Paths to be linked from the temp. directory when running tests
log_file	String	output	Result file to search, by default
max_width_text_difference	Int	500	How wide lines can be in textual previews of file diffs
partial_copy_test_path	List	<empty>	Paths to be part-copied, part-linked to the sandbox
performance_descriptor_decrease	CompositeDictionary (String)	cputime : faster, faster, ran faster default : <empty> memory : smaller, memory-, used less memory	Descriptions to be used when the numbers decrease in a performance file
performance_descriptor_increase	CompositeDictionary (String)	cputime : slower, slower, ran slower default : <empty> memory : larger, memory+, used more memory	Descriptions to be used when the numbers increase in a performance file
performance_ignore_improvements	CompositeDictionary (String)	false	Should we ignore all improvements in performance?
performance_logfile	CompositeDictionary (List)	<empty>	Which result file to collect performance data from
performance_logfile_extractor	Dictionary (String)	<empty>	What string to look for when collecting performance data
performance_test_machine	CompositeDictionary (List)	mem : any default : <empty>	List of machines where performance can be collected
performance_test_minimum	CompositeDictionary (Float)	0.0	Minimum time/memory to be consumed before data is collected
performance_unit	CompositeDictionary (String)	mem : MB default : seconds	Name to be used to identify the units in a performance file
performance_use_normalised_%	CompositeDictionary (String)	true	Alias. See entry for 'use_normalised_percentage_change'
performance_variation_%	CompositeDictionary (Float)	10.0	How much variation in performance is allowed
performance_variation_serious_%	CompositeDictionary (Float)	0.0	Additional cutoff to performance_variation_% for extra highlighting
relative_float_tolerance	CompositeDictionary (Float)	0.0	Which relative tolerance to apply when comparing floating point values
remote_copy_program	String	<empty>	(UNIX) Program to use for copying files remotely, in case of non-shared file systems
remote_program_options	CompositeDictionary (String)	default : <empty> rsync : -azLp scp : -Crp -o StrictHostKeyChecking=no -o BatchMode=yes -o ConnectTimeout=10 ssh : -o StrictHostKeyChecking=no -o BatchMode=yes -o ConnectTimeout=10	Default options to use for particular remote shell programs
remote_shell_program	String	rsh	Program to use for running commands remotely
run_dependent_text	CompositeDictionary (List)	<empty>	Mapping of patterns to remove from result files
save_filtered_file_stems	List	<empty>	Files where the filtered version should be saved rather than the SUT output
slow_motion_replay_speed	Int	3	How long in seconds to wait between each GUI action
smtp_server	String	localhost	Server to use for sending mail in batch mode
suppress_stderr_popup	List	<empty>	Alias. See entry for 'suppress_stderr_text'
suppress_stderr_text	List	<empty>	List of patterns which, if written on TextTest's own stderr, should not be propagated to popups and further logfiles
test_data_environment	Dictionary (String)	<empty>	Environment variables to be redirected for linked/copied test data
test_data_ignore	CompositeDictionary (List)	<empty>	Elements under test data structures which should not be viewed or change-monitored
test_data_properties	CompositeDictionary (String)	<empty>	Write the contents of test_data_environment to the given Java properties file
test_data_searchpath	CompositeDictionary (List)	<empty>	Alias. See entry for 'extra_search_directory'
test_list_files_directory	List	filter_files	Alias. See entry for 'filter_file_directory'
testoverview_colours	Dictionary (String)	column_header_bg : gray1 failure_bg : #FF3118 memory_bg : pink no_results_bg : gray2 performance_bg : #FFC6A5 performance_fg : red6 row_header_bg : #FFFFCC run_friday_fg : black run_monday_fg : black run_saturday_fg : black run_sunday_fg : black run_thursday_fg : black run_tuesday_fg : black run_wednesday_fg : black success_bg : #CEEFBD test_default_fg : black	Alias. See entry for 'historical_report_colours'
text_diff_program	String	diff	External program to use for textual comparison of files
text_diff_program_filters	CompositeDictionary (List)	default : <empty> diff : ^<, ^>	Filters that should be applied for particular diff tools to aid with grouping in dynamic GUI
text_diff_program_max_file_size	Int	-1	The maximum file size to use the text_diff_program, in bytes. -1 means no limit.
unordered_text	CompositeDictionary (List)	<empty>	Mapping of patterns to extract and sort from result files
unsaveable_version	List	<empty>	Versions which should not have results saved for them
use_case_record_mode	String	disabled	Mode for Use-case recording (GUI, console or disabled)
use_case_recorder	String	<empty>	Which Use-case recorder is being used
use_normalised_percentage_change	CompositeDictionary (String)	true	Do we interpret performance percentage changes as normalised (symmetric) values?
version_priority	CompositeDictionary (Int)	99	Mapping of version names to a priority order in case of conflict.
view_program	CompositeDictionary (String)	emacs (UNIX) notepad (Windows)	External program(s) to use for viewing and editing text files
virtual_display_machine	List	localhost	(UNIX) List of machines to run virtual display server (Xvfb) on

Last updated: 05 October 2012

[news] [contact] [site info] [sitemap]