@DisableIfTestFails(onAssertion = false)
@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
-static class ThreeTestsWithSecondFailingWithUnconfiguredAssertionTestCase {
+class ThreeTestsWithSecondFailingWithUnconfiguredAssertionTestCase {
@Test
@Order(1)
@@ -377,7 +377,7 @@ Disabling on specific exceptions
@DisableIfTestFails(with = IOException.class)
@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
-static class ThreeTestsWithSecondThrowingConfiguredExceptionTestCase {
+class ThreeTestsWithSecondThrowingConfiguredExceptionTestCase {
@Test
@Order(1)
diff --git a/docs/disable-parameterized-tests/index.html b/docs/disable-parameterized-tests/index.html
index 25c2872c..a5e83360 100644
--- a/docs/disable-parameterized-tests/index.html
+++ b/docs/disable-parameterized-tests/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/disabled-until/index.html b/docs/disabled-until/index.html
index a1e68290..2e20c1f8 100644
--- a/docs/disabled-until/index.html
+++ b/docs/disabled-until/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/environment-variables/index.html b/docs/environment-variables/index.html
index d21b327f..64c8b7fd 100644
--- a/docs/environment-variables/index.html
+++ b/docs/environment-variables/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/expected-to-fail-tests/index.html b/docs/expected-to-fail-tests/index.html
index 030df2f5..0b6b03da 100644
--- a/docs/expected-to-fail-tests/index.html
+++ b/docs/expected-to-fail-tests/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/issue/index.html b/docs/issue/index.html
index 390f07bb..675ac1c2 100644
--- a/docs/issue/index.html
+++ b/docs/issue/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/json-argument-source/index.html b/docs/json-argument-source/index.html
index 75c997b6..3fb1f962 100644
--- a/docs/json-argument-source/index.html
+++ b/docs/json-argument-source/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/range-sources/index.html b/docs/range-sources/index.html
index 393b6be3..e7c350db 100644
--- a/docs/range-sources/index.html
+++ b/docs/range-sources/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/report-entries/index.html b/docs/report-entries/index.html
index 742ab398..9440de50 100644
--- a/docs/report-entries/index.html
+++ b/docs/report-entries/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/resources/index.html b/docs/resources/index.html
index 9c7a3a5b..72bcad6b 100644
--- a/docs/resources/index.html
+++ b/docs/resources/index.html
@@ -33,7 +33,7 @@
-
+
@@ -340,11 +340,13 @@ Creating a New Resource
-void test1(@New(TemporaryDirectory.class) Path tempDir) {
+@Test
+void test1(@New(TemporaryDirectory.class) Path tempDir) {
// Test code goes here, e.g.,
assertTrue(Files.exists(tempDir));
}
+@Test
void test2(@New(TemporaryDirectory.class) Path tempDir) {
// This temporary directory is different to the first one.
}
@@ -372,12 +374,13 @@ Creating a New Resource with Arg
-void testWithArg(
+@Test
+void testWithArg(
@New(value = TemporaryDirectory.class, arguments = "customPrefix")
Path tempDir) {
// Test code goes here, e.g.,
Path rootTempDir = Paths.get(System.getProperty("java.io.tmpdir"));
- assertTrue(rootTempDir.relativize(tempDir).startsWith("customPrefix"));
+ assertTrue(rootTempDir.relativize(tempDir).toString().startsWith("customPrefix"));
}
@@ -389,13 +392,15 @@ Sharing a Resource
-void sharedResourceTest1(
+@Test
+void sharedResourceTest1(
@Shared(factory = TemporaryDirectory.class, name = "sharedTempDir")
Path sharedTempDir) {
// Test code goes here, e.g.,
assertTrue(Files.exists(sharedTempDir));
}
+@Test
void sharedResourceTest2(
@Shared(factory = TemporaryDirectory.class, name = "sharedTempDir")
Path sharedTempDir) {
@@ -442,18 +447,21 @@ Sharing Multiple Resources
-void firstSharedResource1(
+@Test
+void firstSharedResource1(
@Shared(factory = TemporaryDirectory.class, name = "first")
Path first) {
// Test code working with first shared resource...
}
+@Test
void firstSharedResource2(
@Shared(factory = TemporaryDirectory.class, name = "first")
Path first) {
// Test code working with first shared resource...
}
+@Test
void secondSharedResource(
@Shared(factory = TemporaryDirectory.class, name = "second")
Path second) {
@@ -475,6 +483,7 @@ Scope of a Shared Resource
class FirstTest {
+ @Test
void test(
@Shared(
factory = TemporaryDirectory.class,
@@ -491,6 +500,7 @@ Scope of a Shared Resource
class SecondTest {
+ @Test
void test(
@Shared(
factory = TemporaryDirectory.class,
diff --git a/docs/retrying-test/index.html b/docs/retrying-test/index.html
index 317794d8..2fb1ce28 100644
--- a/docs/retrying-test/index.html
+++ b/docs/retrying-test/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/simple-arguments-aggregator/index.html b/docs/simple-arguments-aggregator/index.html
index de08b9da..b453c7ff 100644
--- a/docs/simple-arguments-aggregator/index.html
+++ b/docs/simple-arguments-aggregator/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/standard-input-output/index.html b/docs/standard-input-output/index.html
index fc92d6db..a9102556 100644
--- a/docs/standard-input-output/index.html
+++ b/docs/standard-input-output/index.html
@@ -33,7 +33,7 @@
-
+
@@ -294,7 +294,8 @@ Skip links
Depending on the configuration, the extension redirects the standard input and/or output, in which case nothing gets forwarded to the original System.in and/or System.out / System.err.
-This becomes particularly important when running tests in parallel, where other tests may interfere with tests annotated with @StdIo.
+This becomes particularly important when running tests in parallel, where other tests may interfere with tests annotated with @StdIo.
+More on that in the section Thread-Safety.
@@ -309,18 +310,110 @@ Basic use
-
-
The annotation @StdIo. It allows defining input that is read from System.in without having to wait for user input.
+The annotation @StdIo enables the extension and optionally defines input that is read from System.in without having to wait for user input.
-
-
Parameters StdIn, StdOut, and StdErr, which you can have injected into your test.
-Their capturedLines() methods allow you to access lines read from System.in or written to System.out or System.err, so you can verify them with common assertions.
+The parameters StdIn, StdOut, and StdErr can be injected into your test.
+Their capturedString() and capturedLines() methods allow you to access the strings read from System.in or written to System.out or System.err, so you can verify them with common assertions.
-For example, after calling System.out.println("Hello") and System.out.println("World"), the StdOut::capturedLines method would return an array ["Hello", "World"].
-With System.out.print("Hello") and System.out.println("World") (note that the first method does not print a line break), it would return ["HelloWorld"].
+For example, after calling System.out.println("Hello") and System.out.println("World"), StdOut::capturedString would return "Hello%nWorld%n".
+With System.out.print("Hello") and System.out.println("World") (note that the first method does not print a line break), the method would return "HelloWorld%n".
+(In both cases, %n corresponds to System.getProperty("line.separator").)
+
+Captured strings and lines
+
+Since the strings passed to @StdIo or System.out/err.print/println don’t need to end with a line separator, the question arises how they are separated for the purpose of capturedString(), i.e. how does the method’s return distinguish between println("Hello"); println("World"); and print("Hello"); println("World");?
+
+
+
+
+
+Important
+
+
+
+This extension operates under the basic assumption that every string passed to @StdIo, System.out.println, or System.err.println implicitly ends with a line separator and hence adds it explicitly to the string returned by capturedString().
+This is not the case for strings passed to System.out.print and System.err.print.
+
+
+
+
+
+
+The classes StdIn, StdOut, and StdErr also offer a method String[] capturedLines(), which divides the captured string on the line separator and includes leading, inner, and trailing empty lines but does not include the potential empty string that comes after a trailing line separator.
+(The exact algorithm is based on but behaves differently from String::split.)
+
+
+
+
+
+Warning
+
+
+
+The combination of these two approaches leads to the unfortunate situation that capturedLines() can’t be used to distinguish the cases where the last line was created by a print or a println (see the first two lines in the table below) because regardless of whether the string ends with a line separator or not, there will be no trailing empty string in the array.
+Use capturedString() to distinguish these cases.
+
+
+
+
+
+
+Here are some examples to illustrate this behavior (%n corresponds to System.getProperty("line.separator")):
+
+
+
+
+
+
+prints
+capturedString()capturedLines()
+
+
+
+println("A");
"A%n"
["A"]
+
+print("A");
"A"
["A"]
+
+print("A"); println("B");
"AB%n"
["AB"]
+
+println("A"); println("B");
"A%nB%n"
["A", "B"]
+
+println("A"); println(); println("B");
"A%n%nB%n"
["A", "", "B"]
+
+println(); println("A"); println();
"%nA%n%n"
["", "A", ""]
+
+
+
+
+Valid configurations
Here are the valid combinations of the annotation (with or without values for the read lines) and parameters:
@@ -419,6 +512,7 @@ Basic use
+
Thread-Safety
@@ -428,8 +522,8 @@ Thread-Safety
However, this does not cover all possible cases.
-Tested code that reads System.in or System.out or calls System.setIn() or System.setOut() independently of the extensions can still run in parallel to them and may thus behave erratically when, for example, it unexpectedly uses System.out that was set by the extension in another thread.
-Tests that cover code that reads or writes System.in or System.out need to be annotated with the respective annotation:
+Tested code that reads System.in or System.out or calls System.setIn() or System.setOut() independently of the extensions can still run in parallel to them and may thus behave erratically if, for example, it unexpectedly uses System.out that was set by the extension in another thread.
+Tests that cover code that reads or writes System.in, System.out, or System.err need to be annotated with the respective annotation:
diff --git a/docs/stopwatch/index.html b/docs/stopwatch/index.html
index 01ec9df8..329993f9 100644
--- a/docs/stopwatch/index.html
+++ b/docs/stopwatch/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/system-properties/index.html b/docs/system-properties/index.html
index 5f285e7f..92e3cf6b 100644
--- a/docs/system-properties/index.html
+++ b/docs/system-properties/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/temp-directory-removed/index.html b/docs/temp-directory-removed/index.html
index 95c69782..407c83dc 100644
--- a/docs/temp-directory-removed/index.html
+++ b/docs/temp-directory-removed/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/docs/temp-directory/index.html b/docs/temp-directory/index.html
index 92a6fcd0..59b1a0ab 100644
--- a/docs/temp-directory/index.html
+++ b/docs/temp-directory/index.html
@@ -33,7 +33,7 @@
-
+
@@ -315,11 +315,13 @@ Creating a New Temporary Directory
-void dirTest1(@Dir Path tempDir) {
+@Test
+void dirTest1(@Dir Path tempDir) {
// Test code goes here, e.g.,
assertTrue(Files.exists(tempDir));
}
+@Test
void dirTest2(@Dir Path tempDir) {
// This temporary directory is different to the first one.
}
@@ -330,11 +332,13 @@ Creating a New Temporary Directory
-void test1(@New(TemporaryDirectory.class) Path tempDir) {
+@Test
+void test1(@New(TemporaryDirectory.class) Path tempDir) {
// Test code goes here, e.g.,
assertTrue(Files.exists(tempDir));
}
+@Test
void test2(@New(TemporaryDirectory.class) Path tempDir) {
// This temporary directory is different to the first one.
}
@@ -350,12 +354,13 @@ Creating with Arguments
-void testWithArg(
+@Test
+void testWithArg(
@New(value = TemporaryDirectory.class, arguments = "customPrefix")
Path tempDir) {
// Test code goes here, e.g.,
Path rootTempDir = Paths.get(System.getProperty("java.io.tmpdir"));
- assertTrue(rootTempDir.relativize(tempDir).startsWith("customPrefix"));
+ assertTrue(rootTempDir.relativize(tempDir).toString().startsWith("customPrefix"));
}
@@ -384,13 +389,15 @@ Sharing a Temporary Directory
-void sharedResourceTest1(
+@Test
+void sharedResourceTest1(
@Shared(factory = TemporaryDirectory.class, name = "sharedTempDir")
Path sharedTempDir) {
// Test code goes here, e.g.,
assertTrue(Files.exists(sharedTempDir));
}
+@Test
void sharedResourceTest2(
@Shared(factory = TemporaryDirectory.class, name = "sharedTempDir")
Path sharedTempDir) {
diff --git a/docs/vintage-test/index.html b/docs/vintage-test/index.html
index f46720ba..7f4a287f 100644
--- a/docs/vintage-test/index.html
+++ b/docs/vintage-test/index.html
@@ -33,7 +33,7 @@
-
+
diff --git a/feed.xml b/feed.xml
index 98d4db87..8bc858c4 100644
--- a/feed.xml
+++ b/feed.xml
@@ -1 +1 @@
-Jekyll 2023-10-07T17:37:10+00:00 https://junit-pioneer.org/feed.xml JUnit Pioneer JUnit 5 Extension Pack JUnit Pioneers Jekyll 2023-11-16T20:16:19+00:00 https://junit-pioneer.org/feed.xml JUnit Pioneer JUnit 5 Extension Pack JUnit Pioneers JUnit Pioneer - JUnit Pioneer
-
+
@@ -23,7 +23,7 @@
-
+
@@ -175,7 +175,7 @@ Skip links
- JUnit 5 extension pack, pushing the frontiers on Jupiter.
Released on GitHub and Maven Central under
org.junit-pioneer : junit-pioneer : 2.1.0
+
JUnit 5 extension pack, pushing the frontiers on Jupiter.
Released on GitHub and Maven Central under
org.junit-pioneer : junit-pioneer : 2.2.0
@@ -193,7 +193,7 @@ Skip links
-
+
diff --git a/junit-pioneer/index.html b/junit-pioneer/index.html
index 07d01024..ad94acad 100644
--- a/junit-pioneer/index.html
+++ b/junit-pioneer/index.html
@@ -10,7 +10,7 @@
JUnit Pioneer - JUnit Pioneer
-
+
@@ -23,7 +23,7 @@
-
+
@@ -175,7 +175,7 @@ Skip links
- JUnit 5 extension pack, pushing the frontiers on Jupiter.
Released on GitHub and Maven Central under
org.junit-pioneer : junit-pioneer : 2.1.0
+
JUnit 5 extension pack, pushing the frontiers on Jupiter.
Released on GitHub and Maven Central under
org.junit-pioneer : junit-pioneer : 2.2.0
@@ -198,7 +198,7 @@ Skip links
-
+
diff --git a/sitemap.xml b/sitemap.xml
index 3a9cf1d3..d3d0f9aa 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,95 +2,95 @@
https://junit-pioneer.org/docs/byte-array-converter/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/cartesian-product-v1/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/cartesian-product/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/default-locale-timezone/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/disable-if-display-name/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/disable-if-test-fails/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/disable-parameterized-tests/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/disabled-until/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/environment-variables/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/expected-to-fail-tests/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/issue/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/json-argument-source/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/range-sources/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/report-entries/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/resources/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/retrying-test/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/simple-arguments-aggregator/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/standard-input-output/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/stopwatch/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/system-properties/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/temp-directory-removed/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/temp-directory/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/vintage-test/
-2023-10-07T17:37:10+00:00
+2023-11-16T20:16:19+00:00
https://junit-pioneer.org/docs/