Layout Configuration

The HTML and any structured report of Testwell CTC++ can be adapted to the size and code distribution of the reported project. For this purpose, layout configurations are defined in ctcreport-layout.ini.

Structure Elements

The report consists of three different structure elements: one overview page, detail pages, and source code views. For overview and detail pages, the reported entities can be chosen (Directories, Files, Functions) on one or two hierarchy levels.

Overview: One overview page is always generated. On one or two aggregation levels, coverage is shown for the entities chosen (e.g. for directories and files). The overview page also contains general information about the report, like input files used, report generation time etc.
Detail Pages: Optionally, detail pages can be generated for one type of entity (e.g. files). One detail page per selected entity is generated, also providing one or two levels of granularity (e.g. functions). This entity must also appear on the overview page, so that a link is provided for each detail page.
Source Code Views: Optionally, one page per source file is generated showing the source code annotated with coverage information. All occurences of the file and its functions on overview and on detail pages are linked to this source code view.

Layout Configuration

Different layouts are configured in the configuration file ctcreport-layout.ini located in ctcreport folder of the Testwell CTC++ directory.

[D: For deeply structured projects]
OVERVIEW = Directories, Files
DETAIL_PAGES_FOR = Directories
DETAIL_PAGES = Files, Functions
SOURCE_CODE = ON
                
[S: For small projects - files and functions on one page]
OVERVIEW = Files, Functions
DETAIL_PAGES_FOR = OFF
SOURCE_CODE = ON

...

Each block defines one layout. The head of a block

[X: Description]

consists of the parameter X to be used with option -layout in a ctcreport call and a description of the layout. Parameters and descriptions are shown with ctcreport -h. The first block in ctcreport-layout.ini is the default layout.

The configuration parameters are

OVERVIEW = Entity1[, Entity2]: Defines the entities shown on level 1 and, optionally, level 2 of the overview table.
DETAIL_PAGES_FOR = OFF | Entity: If detail pages shall be generated, this parameter defines the entity. To get access from overview page to the detail pages, the entity shall be entity 1 or entity 2 chosen in OVERVIEW.
DETAIL_PAGES = Entity1[, Entity2]: If DETAIL_PAGES_FOR not set to OFF, this parameter defines the entities shown on level 1 and, optionally, level 2 of the detail pages' tables.
SOURCE_CODE = ON | OFF: Decides if the source code views are generated or not.

Available entities are: Directories, Files, Functions.