sourceFileNames) {
+ try {
+ new WorkspaceModifyOperation() {
+ @Override
+ protected void execute(final IProgressMonitor monitor) throws CoreException, InvocationTargetException, InterruptedException {
+ for (String sourceFileName : sourceFileNames) {
+ addSourceToWorkspace(sourceFileName);
+ }
+ }
+ }.run(new NullProgressMonitor());
+ } catch (InvocationTargetException e) {
+ throw new WrappedException("failed adding sources to workspace", e);
+ } catch (InterruptedException e) {
+ throw new WrappedException("adding sources to workspace interrupted", e);
+ }
+ }
+
+ protected Collection getTestSources() {
+ return getTestProjectManager().getTestSources();
+ }
+
+ /**
+ * Returns the kernel {@link TestSource} for the given sourceFileName.
+ *
+ * @param sourceFileName
+ * the file name of the {@link TestSource}
+ * @return the {@link TestSource} for the given sourceFileName
+ */
+ protected XtextTestSource getTestSource(final String sourceFileName) {
+ return (XtextTestSource) getTestProjectManager().getTestSource(sourceFileName);
+ }
+
+ /**
+ * Returns the kernel {@link TestSource} for this test class.
+ *
+ * @return the {@link TestSource} for this test class
+ */
+ protected TestSource getTestSource() {
+ return getTestProjectManager().getTestSource(getTestSourceFileName());
+ }
+
+ /**
+ * Get the name of the main test source file.
+ *
+ * @return the file name of the main test source file
+ */
+ protected abstract String getTestSourceFileName();
+
+ /**
+ * The default implementation returns the name of the test class for the model name of the test source.
+ * A test class needs to override this, if the name of the main test source model differs from the default.
+ *
+ * @return the name of the main test source model
+ */
+ protected String getTestSourceModelName() {
+ return this.getClass().getSimpleName();
+ }
+
+ /**
+ * Wait for validation jobs to finish.
+ */
+ protected void waitForValidation() {
+ waitForJobsOfFamily(org.eclipse.xtext.ui.editor.validation.ValidationJob.XTEXT_VALIDATION_FAMILY);
+ }
+
+ /**
+ * Wait for jobs of a given family to finish.
+ *
+ * @param family
+ * to wait for.
+ */
+ protected void waitForJobsOfFamily(final Object family) {
+ getTestUtil().waitForJobsOfFamily(family);
+ }
+
+ /**
+ * Wait for synchronization jobs on opening/closing the editor.
+ *
+ * @param editor
+ * editor part
+ */
+ protected void waitForEditorJobs(final IEditorPart editor) {
+ getTestUtil().waitForEditorJobs(editor);
+ }
+
+ /**
+ * Wait for jobs of a given family to appear. A {@code null} family will
+ * cause this to wait for any job.
+ *
+ * @param family
+ * to wait for, may be {@code null}
+ * @param timeout
+ * ms to wait for.
+ */
+ protected void waitForJobOfFamilyToAppear(final Object family, final long timeout) {
+ final long timeLimit = System.currentTimeMillis() + timeout;
+ do {
+ if (Job.getJobManager().find(family).length > 0) {
+ return;
+ }
+ } while (System.currentTimeMillis() < timeLimit);
+ }
+
+ /**
+ * Returns the test information for the current test class.
+ *
+ * @return information for the current test class
+ */
+ protected TestInformation getTestInformation() {
+ synchronized (testInformationMap) {
+ return testInformationMap.get(this.getClass());
+ }
+ }
+
+ /**
+ * Create a test source for testing from an existing file.
+ *
+ * @param sourceFileName
+ * file name for source
+ * @param content
+ * content of source
+ * @return a new {@link TestSource} with the given parameters
+ */
+
+ protected TestSource createTestSource(final String sourceFileName, final String content) {
+ TestSource testSource = new TestSource(sourceFileName, content);
+ getTestProjectManager().addSourceToProject(testSource);
+ return testSource;
+ }
+
+ /**
+ * Get the test class utility for this test. The minimum functionality is given by
+ * AbstractTestUtil, which does not require that any methods be overridden. Tests
+ * that require more than this minimal functionality must override this method.
+ *
+ * This method is expected to always return the same instance, even when invoked on different instances of the test class. This is because the associated
+ * {@link ITestProjectManager} is stateful and required by {@link #beforeAllTests()}, {@link #afterAllTests()}, and {@link #getTestSources()}.
+ *
+ * @return the test class utility for this test.
+ */
+ protected abstract AbstractTestUtil getTestUtil();
+
+}
diff --git a/com.avaloq.tools.ddk.xtext.test.core/src/com/avaloq/tools/ddk/xtext/test/jupiter/AbstractXtextTest.java b/com.avaloq.tools.ddk.xtext.test.core/src/com/avaloq/tools/ddk/xtext/test/jupiter/AbstractXtextTest.java
new file mode 100644
index 0000000000..01a43815b9
--- /dev/null
+++ b/com.avaloq.tools.ddk.xtext.test.core/src/com/avaloq/tools/ddk/xtext/test/jupiter/AbstractXtextTest.java
@@ -0,0 +1,114 @@
+/*******************************************************************************
+ * Copyright (c) 2025 Avaloq Group AG and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ * Avaloq Group AG - initial API and implementation
+ *******************************************************************************/
+package com.avaloq.tools.ddk.xtext.test.jupiter;
+
+import org.eclipse.emf.ecore.EObject;
+import org.eclipse.xtext.resource.XtextResource;
+
+import com.avaloq.tools.ddk.xtext.test.AbstractXtextTestUtil;
+import com.avaloq.tools.ddk.xtext.test.XtextTestSource;
+
+
+/**
+ * Provides a test class specific custom test framework for xtext languages. Provides a language specific {@link AbstractXtextTestUtil}.
+ * All exceptions are wrapped and handed over to the JUnit framework.
+ */
+public abstract class AbstractXtextTest extends AbstractTest {
+
+ /**
+ * Returns a language specific {@link AbstractXtextTestUtil}. Test classes specify which TestUtil to use by implementing this method.
+ *
+ * @return a language specific {@link AbstractXtextTestUtil}
+ */
+ protected abstract AbstractXtextTestUtil getXtextTestUtil();
+
+ @Override
+ protected final AbstractXtextTestUtil getTestUtil() {
+ return getXtextTestUtil();
+ }
+
+ @Override
+ protected XtextTestSource getTestSource() {
+ return (XtextTestSource) super.getTestSource();
+ }
+
+ @Override
+ protected XtextTestSource createTestSource(final String sourceFileName, final String content) {
+ XtextTestSource testSource = new XtextTestSource(sourceFileName, content, getTestUtil().getResourceSet());
+ getTestProjectManager().addSourceToProject(testSource);
+ return testSource;
+ }
+
+ /**
+ * The default implementation returns the name of the source model calling {@link getTestSourceModelName} and adds the default file extension for the grammar
+ * of this test. A test class needs to override this, if the name of the main test source file differs from the default.
+ *
+ * @return the name of the main test source file
+ */
+ @Override
+ protected String getTestSourceFileName() {
+ return this.getTestSourceModelName() + '.' + getXtextTestUtil().getFileExtension();
+ }
+
+ /**
+ * Returns the xtext resource loaded by {@link loadPrimarySource}.
+ *
+ * @return
+ * the xtext resource loaded by {@link loadPrimarySource}.
+ */
+ protected XtextResource getXtextTestResource() {
+ return getTestSource(getTestSourceFileName()).getXtextResource();
+ }
+
+ /**
+ * Returns the semantic model from the xtext resource loaded by {@link loadPrimarySource}.
+ *
+ * @return
+ * the semantic model from the xtext resource loaded by {@link loadPrimarySource}.
+ */
+ protected EObject getSemanticModel() {
+ return getXtextTestResource().getParseResult().getRootASTElement();
+ }
+
+ /**
+ * {@inheritDoc}
+ */
+ @Override
+ protected void addKernelSourceToWorkspace(final String sourceFileName, final CharSequence sourceContent) {
+ refreshSourceContent(sourceFileName, sourceContent.toString());
+ super.addKernelSourceToWorkspace(sourceFileName, sourceContent);
+ }
+
+ /**
+ * {@inheritDoc}
+ */
+ @Override
+ protected void addCustomerSourceToWorkspace(final String sourceFileName, final CharSequence sourceContent) {
+ refreshSourceContent(CUSTOMER_SOURCE_PREFIX + sourceFileName, sourceContent.toString());
+ super.addCustomerSourceToWorkspace(sourceFileName, sourceContent);
+ }
+
+ /**
+ * Refresh the source content if it had already been added previously to the workspace.
+ *
+ * @param sourceFileName
+ * the source file name
+ * @param content
+ * the content
+ */
+ private void refreshSourceContent(final String sourceFileName, final String content) {
+ XtextTestSource xtextTestSource = getTestSource(sourceFileName);
+ if (xtextTestSource != null) {
+ xtextTestSource.setContent(content);
+ }
+ }
+
+}