Scroll to navigation

CXXTESTGEN(1) User Manual CXXTESTGEN(1)

NAME

cxxtestgen - Generates test source files for CxxTest
 

SYNOPSIS

cxxtestgen [ options] [-o output] <file> ...
 

DESCRIPTION

This script parses the files provided and generates an output source file that can be build with traditional compiler to produce the test-runner executable.
 

OPTIONS

-h
--help Show help message and exit.
 
--version
Write the CxxTest version.
 
-o NAME
--output=NAME Write output to file NAME.
 
-w WORLD
--world=WORLD The label of the tests, used to name the XML results.
 
--include=HEADER
Include file HEADER in the test runner before other headers.
 
--abort-on-fail
Abort tests on failed asserts (like xUnit).
 
--main=MAIN
Specify an alternative name for the main() function.
 
--headers=FILENAME
Specify a filename that contains a list of header files that are processed to generate a test runner.
 
--runner=CLASS
Create a test runner that processes test events using the class CxxTest:: CLASS.
The currently available runners are:
-
ErrorPrinter This is the standard error printer, which formats its output to the standard output stream (std::cout). Same as --error-printer.
-
ParenPrinter Identical to ErrorPrinter except that it prints line numbers in parantheses. This is the way Visual Studio expects it.
-
StdioPrinter The same as ErrorPrinter except that it uses printf instead of std::cout.
-
XmlPrinter Print test results to an XML file.
-
XUnitPrinter This test listener generates output using both ErrorPrinter and XmlPrinter. Same as --xunit-printer.
 
--gui=CLASS
Create a GUI test runner that processes test events using the class CxxTest:: CLASS. (deprecated)
 
--error-printer
Create a test runner using the ErrorPrinter class, and allow the use of the standard library.
 
--xunit-printer
Create a test runner using the XUnitPrinter class.
 
--xunit-file=XUNIT-FILE
The file to which the XML summary is written for test runners using the XUnitPrinter class. The default XML filename is TEST-< WORLD>.xml, where <WORLD> is the value of the --world option. (default: cxxtest)
 
--have-std
Use the standard library (even if not found in tests).
 
--no-std
Do not use standard library (even if found in tests).
 
--have-eh
Use exception handling (even if not found in tests).
 
--no-eh
Do not use exception handling (even if found in tests).
 
--longlong=TYPE
Use TYPE as for long long integers. The default is for 'no' long long integer type to be specified, which is consistent with the current C++ standard.
 
--no-static-init
Do not rely on static initialization in the test runner.
 
--template=TEMPLATE
Generate the test runner using file TEMPLATE to define a template.
 
--root
Write the main() function and global data for a test runner.
 
--part
Write the tester classes for a test runner.
 
-f
--fog-parser Use new FOG C++ parser (Python 2.7 is required).
 
 

COPYRIGHT

Copyright (C) 2008 Sandia Corporation
 
This software is distributed under the LGPL License v2.1 Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software
 
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY.
2012-01-06 CxxTest generator version 4