co♻e: A unittest framework for CODESYS

Highlights | Tour | Download | Getting Started | Automated Testing | Resources | FAQ | Acknowledgements

Highlights

Notable Differences

	co♻e
1. Targets Beckhoff systems	Targets CODESYS based systems
2. Uses bespoke C# runner	Uses built-in Python Scripting as runner
3. Uses vendor specific protocol (ADS/AMS) to collect reports from TwinCAT XAE IDE	Generates XML reports at runtime in a prespecified location

Tour

1/2 Easy Installation: package installer

2/2 Excellent Integration: E.g Jenkins or another platform of choice

Download

The package contains all components in a convenient single installer. By downloading and using our software you abide by the MIT License

Or download via these links or browse via the repo and download yourself
repo v1.2.0.0

co♻e.library
Verifier.project
Simple Example.project
Timed Test.project
Timed Test2.project
Run In Sequence Test Example.project
license.txt

Previous version(s)
repo

Getting started

A step by step tutorial to get started with a co♻e unit testing example project can be found here.

Automated testing

Integration of all your co♻e tests into a CI/CD software toolchain like Jenkins or Azure DevOps is easy. With the aid of software such as Jenkins or Azure DevOps, you can have your tests run automatically and collect test statistics every time something has changed in your software version control (like Git or Subversion). If you want to know more, please read the following documentation carefully;

• Creating a Python Script
• Starting Scripts from the Command Line Interface
• Using python Scripts to Access CODESYS Functionalities

• Using the Command-Line Interface

  • Option --runscript (run script)

• Pre-integrated into the CForge Drone CI/CD backend (beta phase!)

Resources

Userlist
If you have an interesting project in which you use the framework we can mention you.
A shortlist with users of the co♻e framework can be found here.

Wiki
The online API reference wiki can be found here.

Tutorial
cA tutorial can be found here.

Code
The code repository can be found here.

Bugs
Any found bugs can be reported here.

FAQ

Any questions? You can browse them here.
Posted questions will be moderated into the FAQ for future reference.

Acknowledgements

We are passionate software developers who develop & maintain co♻e in our spare time.
CODESYS fully supports us in our efforts by providing a free and open source platform for everybody to use.

Forked with kind permission by Jakob Sagatowski from TcUnit for TwinCAT3.

Assistance provided by @zer0g, @aliazzz, @ingo and @i-campbell greatly appreciated.
Without their assistance, porting alone would have taken me several months.
Kudos for helping me out with various tickets and providing invaluable feedback!

https://www.linkedin.com/in/hahermsen

Project Members:

• Ingo
• aliazzz
• hermsen (admin)
• i-campbell (admin)
• nothinrandom
• stmos
• zer0g