Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
EDT:EUnit Testing
Contents
EUnit Test Framework Overview
- What is EUnit
EUnit stands for EGL Unit testing framework. It is a simple open source framework to write and run repeatable EGL tests.
Its features include:
- Tooling to generate test runner and run the test cases – Provided by EDT Framework
- Manually and Automated
- Can be run as often as needed (on demand, nightly build)
- GUI and command line interfaces
- Logging, Reporting, Analyzing
- Can be used in multiple language environment (java, javascript, etc)
- Test Cases - Provided by test writters
- Documentation - Provided by
- What does each test case test
- What does each test case test
Design
How to write test cases using EUnit
1. Create an EGL Project, for example: eunit.test
- Select "Basic" as the template.
- Set the generators:
1) If you run the testing on both Java and JavaScript platform, just leave the settings as default. That is, turn on both Java and JavaScript generator.
2) If you run the testing on a specific platform, select the checkbox "Override generation settings from workspace preferences" and choose a generator.
2. Create an EGL Library, for example: test.egl, and give a package name "libs".
3. Open the library with EGL Editor, remove the automatically generated code.
4. Type the variable declarations and functions(We treat each function as an EUnit test case) in the library, which should contains the annotation @Test. For example:
package libs; import org.eclipse.edt.eunit.runtime.LogResult; import org.eclipse.edt.eunit.runtime.LogResult; import org.eclipse.edt.eunit.runtime.Test; // basic library library test const constFlexName string = "Fred Smith"; varFlexName string; variation string; function runAssignmentFunction01(){@Test {}} variation = "constant initialization"; LogResult.assertStringEqual1("Fred Smith", constFlexName); end end
- Tips
If you want to disable some specific test cases, you can use "targetLang" in the annotation. For example, below is a test case which cannot be generated into JavaScript.
function runAssignmentFunction01(){@Test {targetLang = [JAVA]}} variation = "constant initialization"; LogResult.assertStringEqual1("Fred Smith", constFlexName); end
How to run tests using EUnit