REPOSITORY DESCRIPTION

This repository contains the code for a plugin to efficiently run QTestLib tests in Qt Creator. The plugin connects to "Start run" signal and captures the ouput if it thinks it is a QTestLib test. It then models test output so that it can be easily read in a simple QTreeview.

FEATURES

Here is a list of the current features of the plugin:

• Allows to parse plain text (txt) QTestLib output
• Allows to parse XML (xml) QTestLib output
• Allows to parse Light XML (lightxml) QTestLib output
• Allows to parse XUinit XML (xunitxml) QTestLib output
• Check beforehand if the parser may parse the test
• Model for a QTestLib test
• Merge models for multiple tests
• Display the models in a QTreeView
• Filters to filter the test model (by message type: Pass, Fail, ...)
• Allows to run make check for projects supporting it
• Easy test environment and arguments configuration

Ideas I currently have to extend the plugin are listed below.

COMPATIBILITY TABLE

QTestLibPlugin	Qt Creator	Linux	Windows	Mac OS
0.0.1	3.6.0	Y	Y	?
0.0.2	3.6.0	Y	Y	?
0.0.3	3.6.0	Y	Y	?
0.0.4	3.6.0	Y	Y	?
0.0.5	4.0.0	Y	Y	?
0.0.6	4.2.0	Y	Y	?
0.0.7	4.3.0	Y	Y	?
0.0.8	4.4.0	P	P	?
0.0.8	4.4.1	P	P	?
0.0.9	4.5.0	P	P	?
0.0.10	4.6.0	P	P	?
0.0.11	4.7.0	P	P	?
0.0.12	4.8.0	P	P	?
0.0.13	4.9.0	P	P	?
0.0.14	4.10.0	P	P	?
0.0.15	4.11.0	P	P	?
0.0.16	4.12.0	P	P	?
0.0.17	4.13.0	P	P	?
0.0.18	4.14.0	P	P	?

A Y means that QTestLibPlugin was tested against this Qt Creator version under the given operating system. A N means that the version of the plugin cannot work properly for the given operating system. A P means that the sources should be patched (see patches/ folder) for the plugin to work under the given operating system. A ? means that I currently do not know whether it works.

INSTALLATION

To compile this file, you will need to give some information to qMake about the location of Qt Creator files on your system. For this, you have two alternatives:

• Either set the environment variables QTC_BUILD and QTC_SOURCES to the path to Qt Creator build tree and Qt Creator source tree respectively; or
• Write a file called QtCreator.local.pri containing the following code:

# Qt Creator source tree:
isEmpty(QTCREATOR_SOURCES):QTCREATOR_SOURCES=/path/to/QtCreator/source/tree
# Qt Creator build tree:
isEmpty(IDE_BUILD_TREE):IDE_BUILD_TREE=/path/to/QtCreator/build/tree

An example file (QtCreator.local.pri.example) is provided along with the sources.

Further build-related configuration options can be provided with QTestLibPlugin.local.pri. Again an exemple file (QTestLibPlugin.local.pri.example) is provided along with the sources.

PLANNED DEVELOPMENTS

Here are some ideas I plan to implement later:

• Replace QTreeView by a specially designed view as QTreeView is not suitable for lengthy test messages.
• Complete information of the model by parsing test files.
• Allow to easily select test cases and data row.
• Have parser read in QTestLib output files (and not only stdout).
• Add parsers and models for other test libraries (gtest, cppunit)

If you have any other feature you will be interested in, please let me know. I will be pleased to develop it if I think it is a must have.

If you want to implement extension, also tell me please. Admittedly you can do what you desire with the code (under the licensing constraints), but this will avoid double work.

LICENSING INFORMATION

QTestLibPlugin is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

QTestLibPlugin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with QTestLibPlugin. If not, see http://www.gnu.org/licenses/