home | help 
pas2ut(1)	       Free Pascal unit test creation tool	       pas2ut(1)

NAME
     pas2ut - The Free Pascal unit to unit test case conversion tool.

SYNOPSIS
     pas2ut [options] inputfile [outputfile]

DESCRIPTION
     pas2ut  Scans  the input file for classes and routines, and creates a test-
     case for all classes and routines found in the  interface	section  of  the
     file.   It  can  generate	a unit or an include file. All tests are created
     with a standard fail message. By default, only tests for public,  published
     and default visibility members of classes are generated.

USAGE
     pas2ut takes the following options at this time:

     --defaultclasstest=list
	    Specify a comma-separated list of default tests for each class.  The
	    elements in the list must be valid pascal identifiers.

     --failmessage=Msg
	    Set the message for the Fail() statement inside each test method.

     --limit=list
	    Specify  a	comma-separated  list of global identifiers for which to
	    generate tests.  By default, tests	are  generated	for  all  global
	    identifiers in the interface section of a unit.

     --prefix=name
	    Set  the  prefix  for  the	test names (default is Test ). A test is
	    named after the identifier it tests, with this prefix.

     --singletestclass
	    Use a single test class for each class found.   The  default  is  to
	    create a testcase class per class in the input unit.

     --skip-classes
	    Do not generate test code for classes, only for functions and proce-
	    dures.

     --skip-declaration
	    Do not generate declarations for the tests, only implementations.

     --skip-default
	    skip  tests  for  default  visibility members.  By default, they are
	    generated, together with Public or published members.

     --skip-fail
	    Do not create fail() statements in test routine implementations.

     --skip-fields
	    Do not generate testcases for fields of classes  (only  for  methods
	    and properties).

     --skip-functions
	    Do not generate tests for functions/procedures, only for classes.

     --skip-implementation
	    Do	not  generate (empty) implementation for the tests, only a class
	    declaration is generated.  (it can be completed in an  IDE	such  as
	    Lazarus or MSIDE)

     --skip-methods
	    Do	not  generate  tests for methods of classes, only for fields and
	    properties.

     --skip-properties
	    Do not generate tests for properties of classes, only for fields and
	    methods.

     --skip-property-default
	    Do not generate a default test for each property.

     --skip-public
	    Skip tests for public members, only protected members will be tested
	    if --test-protected is in effect.

     --skip-published
	    Do not generate tests for published members, only public and default
	    members will be tested.

     --skip-register
	    Do not generate RegisterTests statement.

     --skip-setup
	    Do not override the TTestCase.Setup() method in the generated class.

     --skip-teardown
	    Do not override the TTestCase.TearDown()  method  in  the  generated
	    class.

     --skip-unit
	    Do not generate a unit, just an include file.

     --testparentname=name
	    Set the name of the parent class for generated test classes. The de-
	    fault is TTestCase	this can be used to set another class name.

     --test-property-bounds
	    Generate a GetBounds test for each property.

     --test-property-maxlen
	    Generate a MaxLen test for each property.

     --test-property-notify
	    Generate a Notify test for each property.

     --test-property-required
	    Generate a Required test for each property.

     --test-protected
	    Also  generate tests for protected class members.  By default, tests
	    are only generated for public, published and default visibility mem-
	    bers.

     --testunitname=name
	    Set the name of the generated unit (default  is  taken  from  output
	    file name)

     --tiopf
	    Create   tiopf   tests   (this  is	the  same  as  specifying  --de-
	    fault,--bounds,--required,--notify and --maxlen tests.)

     --unittestclassname=name
	    Set the global unit test class name. To be used  with  --singletest-
	    class.
     The --limit and --defaultclasstest may be specified multiple times.

SEE ALSO
	    fpc(1)

Free Pascal			   5 sep 2015			       pas2ut(1)
home | help