Archived

This project is currently archived. A replacement for it is in the works.

TcUnit-Runner - Build & test pipeline integration

Welcome to the documentation of TcUnit-Runner - the program that makes it possible to automate runs of TcUnit unit tests.

TcUnit-Runner is a piece of software that makes it possible to integrate TcUnit (TwinCAT unit tests) in a CI/CD software such as Jenkins.

With Jenkins and a version control system (such as Git), it's possible to automatically run all unit tests in a TwinCAT project automatically if a TwinCAT project is changed in the version control system. All test results are automatically generated and reported in standard xUnit/JUnit XML format which Jenkins natively supports.

Want to get started?
Read the user manual.

Want to download TcUnit-Runner?
Go to the releases.

If you are completely new to unit testing in general and unit testing in TwinCAT in particular it's recommended to read the:

1. Core concepts of unit testing
2. Introduction user guide to TcUnit (the TwinCAT unit testing framework)
3. TcUnit website

Want to contribute?

The software is developed using Visual Studio 2013 community edition. You will also need to:

1. Download the Visual Studio Installer Projects Extension for VS2013. The installation of this extension should be done prior to opening the project.
2. Install log4net. Open the project with VS2013. Go to TOOLS->NuGet Package Manager->Package Manager Console. In the console enter Install-Package log4net -Version 2.0.14.
3. Install Beckhoff.TwinCAT.Ads. Open the project with VS2013. Go to TOOLS->NuGet Package Manager->Package Manager Console. In the console enter Install-Package Beckhoff.TwinCAT.Ads -Version 4.4.19.