Merge branch 'main' into test-execution-listener-adapter-coverage

mpkorstanje · web-flow · commit 34bfb45807e1 · 2025-11-25T13:51:31.000+01:00
diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
@@ -45,7 +45,7 @@ jobs:
       with:
         persist-credentials: false
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@e12f0178983d466f2f6028f5cc7a6d786fd97f4b # v4.31.4
+      uses: github/codeql-action/init@fdbfb4d2750291e159f0156def62b853c2798ca2 # v4.31.5
       with:
         languages: ${{ matrix.language }}
         build-mode: ${{ matrix.build-mode }}
@@ -60,6 +60,6 @@ jobs:
           -Dscan.tag.CodeQL \
           classes
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@e12f0178983d466f2f6028f5cc7a6d786fd97f4b # v4.31.4
+      uses: github/codeql-action/analyze@fdbfb4d2750291e159f0156def62b853c2798ca2 # v4.31.5
       with:
         category: "/language:${{matrix.language}}"
diff --git a/.github/workflows/ossf-scorecard.yml b/.github/workflows/ossf-scorecard.yml
@@ -57,6 +57,6 @@ jobs:
       # Upload the results to GitHub's code scanning dashboard (optional).
       # Commenting out will disable upload of results to your repo's Code Scanning dashboard
       - name: "Upload to code-scanning"
-        uses: github/codeql-action/upload-sarif@e12f0178983d466f2f6028f5cc7a6d786fd97f4b # v4.31.4
+        uses: github/codeql-action/upload-sarif@fdbfb4d2750291e159f0156def62b853c2798ca2 # v4.31.5
         with:
           sarif_file: results.sarif
diff --git a/junit-jupiter-api/src/main/java/org/junit/jupiter/api/ClassTemplate.java b/junit-jupiter-api/src/main/java/org/junit/jupiter/api/ClassTemplate.java
@@ -27,7 +27,7 @@
  * <em>class template</em>.
  *
  * <p>In contrast to regular test classes, a class template is not directly
- * a test class but rather a template for a set of test classes. As such, it is
+ * a test class but rather a template for a set of test cases. As such, it is
  * designed to be invoked multiple times depending on the number of {@linkplain
  * org.junit.jupiter.api.extension.ClassTemplateInvocationContext invocation contexts}
  * returned by the registered {@linkplain
@@ -46,7 +46,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited by subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.13
  * @see TestTemplate @TestTemplate
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/ParameterizedClass.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/ParameterizedClass.java
@@ -124,7 +124,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited by subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.13
  * @see Parameter
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/ArgumentsSource.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/ArgumentsSource.java
@@ -33,7 +33,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.0
  * @see org.junit.jupiter.params.provider.ArgumentsProvider
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/ArgumentsSources.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/ArgumentsSources.java
@@ -23,15 +23,15 @@
 
 /**
  * {@code @ArgumentsSources} is a simple container for one or more
- * {@link ArgumentsSource} annotations.
+ * {@link ArgumentsSource @ArgumentsSource} annotations.
  *
  * <p>Note, however, that use of the {@code @ArgumentsSources} container is completely
  * optional since {@code @ArgumentsSource} is a {@linkplain java.lang.annotation.Repeatable
  * repeatable} annotation.
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.0
  * @see org.junit.jupiter.params.provider.ArgumentsSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/CsvFileSource.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/CsvFileSource.java
@@ -70,7 +70,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.0
  * @see CsvSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/CsvFileSources.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/CsvFileSources.java
@@ -23,15 +23,15 @@
 
 /**
  * {@code @CsvFileSources} is a simple container for one or more
- * {@link CsvFileSource} annotations.
+ * {@link CsvFileSource @CsvFileSource} annotations.
  *
  * <p>Note, however, that use of the {@code @CsvFileSources} container is completely
  * optional since {@code @CsvFileSource} is a {@linkplain java.lang.annotation.Repeatable
  * repeatable} annotation.
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.11
  * @see CsvFileSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/CsvSource.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/CsvSource.java
@@ -75,7 +75,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.0
  * @see CsvFileSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/CsvSources.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/CsvSources.java
@@ -23,15 +23,15 @@
 
 /**
  * {@code @CsvSources} is a simple container for one or more
- * {@link CsvSource} annotations.
+ * {@link CsvSource @CsvSource} annotations.
  *
  * <p>Note, however, that use of the {@code @CsvSources} container is completely
  * optional since {@code @CsvSource} is a {@linkplain java.lang.annotation.Repeatable
  * repeatable} annotation.
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.11
  * @see CsvSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/EmptySource.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/EmptySource.java
@@ -47,7 +47,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.4
  * @see org.junit.jupiter.params.provider.ArgumentsSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/EnumSource.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/EnumSource.java
@@ -46,7 +46,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.0
  * @see org.junit.jupiter.params.provider.ArgumentsSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/EnumSources.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/EnumSources.java
@@ -23,15 +23,15 @@
 
 /**
  * {@code @EnumSources} is a simple container for one or more
- * {@link EnumSource} annotations.
+ * {@link EnumSource @EnumSource} annotations.
  *
  * <p>Note, however, that use of the {@code @EnumSources} container is completely
  * optional since {@code @EnumSource} is a {@linkplain java.lang.annotation.Repeatable
  * repeatable} annotation.
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.11
  * @see EnumSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/FieldSource.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/FieldSource.java
@@ -119,7 +119,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.11
  * @see MethodSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/FieldSources.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/FieldSources.java
@@ -23,15 +23,15 @@
 
 /**
  * {@code @FieldSources} is a simple container for one or more
- * {@link FieldSource} annotations.
+ * {@link FieldSource @FieldSource} annotations.
  *
  * <p>Note, however, that use of the {@code @FieldSources} container is completely
  * optional since {@code @FieldSource} is a {@linkplain java.lang.annotation.Repeatable
  * repeatable} annotation.
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.11
  * @see FieldSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/MethodSource.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/MethodSource.java
@@ -109,7 +109,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.0
  * @see FieldSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/MethodSources.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/MethodSources.java
@@ -23,15 +23,15 @@
 
 /**
  * {@code @MethodSources} is a simple container for one or more
- * {@link MethodSource} annotations.
+ * {@link MethodSource @MethodSource} annotations.
  *
  * <p>Note, however, that use of the {@code @MethodSources} container is completely
  * optional since {@code @MethodSource} is a {@linkplain java.lang.annotation.Repeatable
  * repeatable} annotation.
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.11
  * @see MethodSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/NullAndEmptySource.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/NullAndEmptySource.java
@@ -32,7 +32,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.4
  * @see org.junit.jupiter.params.ParameterizedClass
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/NullEnum.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/NullEnum.java
@@ -15,8 +15,7 @@
 import org.apiguardian.api.API;
 
 /**
- * Dummy enum class used as default value for optional attributes of
- * annotations.
+ * Dummy enum class used as the default value for optional attributes of annotations.
  *
  * @since 5.6
  * @see EnumSource#value()
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/NullSource.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/NullSource.java
@@ -32,7 +32,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.4
  * @see org.junit.jupiter.params.provider.ArgumentsSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/ValueSource.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/ValueSource.java
@@ -37,7 +37,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.0
  * @see org.junit.jupiter.params.provider.ArgumentsSource
diff --git a/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/ValueSources.java b/junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/ValueSources.java
@@ -23,15 +23,15 @@
 
 /**
  * {@code @ValueSources} is a simple container for one or more
- * {@link ValueSource} annotations.
+ * {@link ValueSource @ValueSource} annotations.
  *
  * <p>Note, however, that use of the {@code @ValueSources} container is completely
  * optional since {@code @ValueSource} is a {@linkplain java.lang.annotation.Repeatable
  * repeatable} annotation.
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.11
  * @see ValueSource
diff --git a/junit-platform-commons/src/main/java/org/junit/platform/commons/util/ExceptionUtils.java b/junit-platform-commons/src/main/java/org/junit/platform/commons/util/ExceptionUtils.java
@@ -101,16 +101,19 @@ public static String readStackTrace(Throwable throwable) {
 	/**
 	 * Prune the stack trace of the supplied {@link Throwable}.
 	 *
-	 * <p>Prune all {@linkplain StackTraceElement stack trace elements} up one
-	 * of the supplied {@code classNames} are pruned. All subsequent elements
-	 * in the stack trace will be retained.
+	 * <p>Prune all {@linkplain StackTraceElement stack trace elements} up to one
+	 * of the supplied {@code classNames}. All subsequent elements in the stack
+	 * trace will be retained.
 	 *
 	 * <p>If the {@code classNames} do not match any of the stacktrace elements
 	 * then the {@code org.junit}, {@code jdk.internal.reflect}, and
 	 * {@code sun.reflect} packages are pruned.
 	 *
-	 * <p>Additionally, all elements prior to and including the first JUnit Platform
-	 * Launcher call will be removed.
+	 * <p>Additionally:
+	 * <ul>
+	 *     <li>all elements prior to and including the first JUnit Platform Launcher call will be removed.
+	 *     <li>all elements prior to and including {@code org.junit.start} are kept.
+	 * </ul>
 	 *
 	 * @param throwable the {@code Throwable} whose stack trace should be pruned;
 	 * never {@code null}
@@ -126,14 +129,15 @@ public static void pruneStackTrace(Throwable throwable, List<String> classNames)
 
 		List<StackTraceElement> stackTrace = Arrays.asList(throwable.getStackTrace());
 		List<StackTraceElement> prunedStackTrace = new ArrayList<>();
+		List<StackTraceElement> junitStartStackTrace = new ArrayList<>(0);
 
 		Collections.reverse(stackTrace);
 
 		for (int i = 0; i < stackTrace.size(); i++) {
 			StackTraceElement element = stackTrace.get(i);
 			String className = element.getClassName();
 
-			if (classNames.contains(className)) {
+			if (classNames.contains(className) && !includesJunitStart(stackTrace, i + 1)) {
 				// We found the test
 				// everything before that is not informative.
 				prunedStackTrace.clear();
@@ -142,7 +146,9 @@ public static void pruneStackTrace(Throwable throwable, List<String> classNames)
 				break;
 			}
 			else if (className.startsWith(JUNIT_START_PACKAGE_PREFIX)) {
+				junitStartStackTrace.addAll(prunedStackTrace);
 				prunedStackTrace.clear();
+				junitStartStackTrace.add(element);
 			}
 			else if (className.startsWith(JUNIT_PLATFORM_LAUNCHER_PACKAGE_PREFIX)) {
 				prunedStackTrace.clear();
@@ -152,10 +158,22 @@ else if (STACK_TRACE_ELEMENT_FILTER.test(className)) {
 			}
 		}
 
+		if (!junitStartStackTrace.isEmpty()) {
+			junitStartStackTrace.addAll(prunedStackTrace);
+			prunedStackTrace = junitStartStackTrace;
+		}
+
 		Collections.reverse(prunedStackTrace);
 		throwable.setStackTrace(prunedStackTrace.toArray(new StackTraceElement[0]));
 	}
 
+	private static boolean includesJunitStart(List<StackTraceElement> stackTrace, int fromIndex) {
+		return stackTrace.stream() //
+				.skip(fromIndex) //
+				.map(StackTraceElement::getClassName) //
+				.anyMatch(className -> className.startsWith(JUNIT_START_PACKAGE_PREFIX));
+	}
+
 	/**
 	 * Find all causes and suppressed exceptions in the stack trace of the
 	 * supplied {@link Throwable}.
diff --git a/platform-tests/src/test/java/org/junit/platform/commons/util/ExceptionUtilsTests.java b/platform-tests/src/test/java/org/junit/platform/commons/util/ExceptionUtilsTests.java
@@ -19,6 +19,7 @@
 import static org.junit.platform.commons.util.ExceptionUtils.throwAsUncheckedException;
 
 import java.io.IOException;
+import java.util.Arrays;
 import java.util.List;
 
 import org.junit.jupiter.api.Test;
@@ -104,6 +105,30 @@ void pruneStackTraceOfEverythingPriorToFirstLauncherCall() {
 				.noneMatch(element -> element.toString().contains("org.example.Class.method(file:123)"));
 	}
 
+	@Test
+	void pruneStackTraceRetainsStackFramesFromJUnitStart() {
+		// Non-test class frames from org.junit are filtered.
+		var testClassName = "com.example.project.HelloTest";
+		var testFileName = "HelloTest.java";
+
+		var exception = new JUnitException("expected");
+		var stackTrace = exception.getStackTrace();
+		var extendedStacktrace = Arrays.copyOfRange(stackTrace, 0, stackTrace.length + 2);
+		extendedStacktrace[0] = new StackTraceElement(testClassName, "stringLength", testFileName, 10);
+		extendedStacktrace[stackTrace.length] = new StackTraceElement("org.junit.start.JUnit", "run", "JUnit.java", 3);
+		extendedStacktrace[stackTrace.length + 1] = new StackTraceElement(testClassName, "main", testFileName, 5);
+		exception.setStackTrace(extendedStacktrace);
+
+		pruneStackTrace(exception, List.of(testClassName));
+
+		assertThat(exception.getStackTrace()) //
+				.extracting(StackTraceElement::toString) //
+				.containsExactly( //
+					"com.example.project.HelloTest.stringLength(HelloTest.java:10)", //
+					"org.junit.start.JUnit.run(JUnit.java:3)", //
+					"com.example.project.HelloTest.main(HelloTest.java:5)");
+	}
+
 	@Test
 	void findSuppressedExceptionsAndCausesOfThrowable() {
 		Throwable t1 = new Throwable("#1");

Original file line number	Diff line number	Diff line change
`@@ -27,7 +27,7 @@`
`27`	`27`	`* <em>class template</em>.`
`28`	`28`	`*`
`29`	`29`	`* <p>In contrast to regular test classes, a class template is not directly`
`30`		`- * a test class but rather a template for a set of test classes. As such, it is`
	`30`	`+ * a test class but rather a template for a set of test cases. As such, it is`
`31`	`31`	`* designed to be invoked multiple times depending on the number of {@linkplain`
`32`	`32`	`* org.junit.jupiter.api.extension.ClassTemplateInvocationContext invocation contexts}`
`33`	`33`	`* returned by the registered {@linkplain`
`@@ -46,7 +46,7 @@`
`46`	`46`	`*`
`47`	`47`	`* <h2>Inheritance</h2>`
`48`	`48`	`*`
`49`		`- * <p>This annotation is inherited by subclasses.`
	`49`	`+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.`
`50`	`50`	`*`
`51`	`51`	`* @since 5.13`
`52`	`52`	`* @see TestTemplate @TestTemplate`
Original file line number	Diff line number	Diff line change
`@@ -124,7 +124,7 @@`
`124`	`124`	`*`
`125`	`125`	`* <h2>Inheritance</h2>`
`126`	`126`	`*`
`127`		`- * <p>This annotation is inherited by subclasses.`
	`127`	`+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.`
`128`	`128`	`*`
`129`	`129`	`* @since 5.13`
`130`	`130`	`* @see Parameter`
Original file line number	Diff line number	Diff line change
`@@ -33,7 +33,7 @@`
`33`	`33`	`*`
`34`	`34`	`* <h2>Inheritance</h2>`
`35`	`35`	`*`
`36`		`- * <p>This annotation is inherited to subclasses.`
	`36`	`+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.`
`37`	`37`	`*`
`38`	`38`	`* @since 5.0`
`39`	`39`	`* @see org.junit.jupiter.params.provider.ArgumentsProvider`
Original file line number	Diff line number	Diff line change
`@@ -23,15 +23,15 @@`
`23`	`23`
`24`	`24`	`/**`
`25`	`25`	`* {@code @ArgumentsSources} is a simple container for one or more`
`26`		`- * {@link ArgumentsSource} annotations.`
	`26`	`+ * {@link ArgumentsSource @ArgumentsSource} annotations.`
`27`	`27`	`*`
`28`	`28`	`* <p>Note, however, that use of the {@code @ArgumentsSources} container is completely`
`29`	`29`	`* optional since {@code @ArgumentsSource} is a {@linkplain java.lang.annotation.Repeatable`
`30`	`30`	`* repeatable} annotation.`
`31`	`31`	`*`
`32`	`32`	`* <h2>Inheritance</h2>`
`33`	`33`	`*`
`34`		`- * <p>This annotation is inherited to subclasses.`
	`34`	`+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.`
`35`	`35`	`*`
`36`	`36`	`* @since 5.0`
`37`	`37`	`* @see org.junit.jupiter.params.provider.ArgumentsSource`
Original file line number	Diff line number	Diff line change
`@@ -70,7 +70,7 @@`
`70`	`70`	`*`
`71`	`71`	`* <h2>Inheritance</h2>`
`72`	`72`	`*`
`73`		`- * <p>This annotation is inherited to subclasses.`
	`73`	`+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.`
`74`	`74`	`*`
`75`	`75`	`* @since 5.0`
`76`	`76`	`* @see CsvSource`
Original file line number	Diff line number	Diff line change
`@@ -75,7 +75,7 @@`
`75`	`75`	`*`
`76`	`76`	`* <h2>Inheritance</h2>`
`77`	`77`	`*`
`78`		`- * <p>This annotation is inherited to subclasses.`
	`78`	`+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.`
`79`	`79`	`*`
`80`	`80`	`* @since 5.0`
`81`	`81`	`* @see CsvFileSource`