From bfbda62b23c4111eb539136efac794b9a7dbaf3e Mon Sep 17 00:00:00 2001 From: GitHub Actions Date: Sat, 7 Oct 2023 17:37:15 +0000 Subject: [PATCH] Update to source b2f5e11, xp e9065d1 --- docs/byte-array-converter/index.html | 2 +- docs/cartesian-product-v1/index.html | 2 +- docs/cartesian-product/index.html | 2 +- docs/default-locale-timezone/index.html | 2 +- docs/disable-if-display-name/index.html | 2 +- docs/disable-if-test-fails/index.html | 2 +- docs/disable-parameterized-tests/index.html | 2 +- docs/disabled-until/index.html | 2 +- docs/environment-variables/index.html | 66 +++++++++++++++++---- docs/expected-to-fail-tests/index.html | 2 +- docs/issue/index.html | 2 +- docs/json-argument-source/index.html | 2 +- docs/range-sources/index.html | 2 +- docs/report-entries/index.html | 2 +- docs/resources/index.html | 2 +- docs/retrying-test/index.html | 2 +- docs/simple-arguments-aggregator/index.html | 2 +- docs/standard-input-output/index.html | 2 +- docs/stopwatch/index.html | 2 +- docs/system-properties/index.html | 2 +- docs/temp-directory-removed/index.html | 2 +- docs/temp-directory/index.html | 2 +- docs/vintage-test/index.html | 2 +- feed.xml | 2 +- sitemap.xml | 46 +++++++------- 25 files changed, 99 insertions(+), 59 deletions(-) diff --git a/docs/byte-array-converter/index.html b/docs/byte-array-converter/index.html index 56c5ad30..e57852d0 100644 --- a/docs/byte-array-converter/index.html +++ b/docs/byte-array-converter/index.html @@ -33,7 +33,7 @@ - + diff --git a/docs/cartesian-product-v1/index.html b/docs/cartesian-product-v1/index.html index bc82f5fd..51194b1e 100644 --- a/docs/cartesian-product-v1/index.html +++ b/docs/cartesian-product-v1/index.html @@ -33,7 +33,7 @@ - + diff --git a/docs/cartesian-product/index.html b/docs/cartesian-product/index.html index 80f33df2..8462f53f 100644 --- a/docs/cartesian-product/index.html +++ b/docs/cartesian-product/index.html @@ -33,7 +33,7 @@ - + diff --git a/docs/default-locale-timezone/index.html b/docs/default-locale-timezone/index.html index 93ebeb04..82ad7a96 100644 --- a/docs/default-locale-timezone/index.html +++ b/docs/default-locale-timezone/index.html @@ -33,7 +33,7 @@ - + diff --git a/docs/disable-if-display-name/index.html b/docs/disable-if-display-name/index.html index 2d6700ff..38e1c085 100644 --- a/docs/disable-if-display-name/index.html +++ b/docs/disable-if-display-name/index.html @@ -33,7 +33,7 @@ - + diff --git a/docs/disable-if-test-fails/index.html b/docs/disable-if-test-fails/index.html index b57f372a..1a1bf418 100644 --- a/docs/disable-if-test-fails/index.html +++ b/docs/disable-if-test-fails/index.html @@ -33,7 +33,7 @@ - + diff --git a/docs/disable-parameterized-tests/index.html b/docs/disable-parameterized-tests/index.html index aac4d017..25c2872c 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 c91c7e1f..a1e68290 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 4a5c1d4c..d21b327f 100644 --- a/docs/environment-variables/index.html +++ b/docs/environment-variables/index.html @@ -33,7 +33,7 @@ - + @@ -298,10 +298,10 @@

@ClearEnviron
-

Java considers environment variables to be immutable, so this extension uses reflection to change them. -This requires that the SecurityManager allows modifications and can potentially break on different operating systems and Java versions. +

Java considers environment variables to be immutable, which is why this extension uses reflection to change them. +This requires the SecurityManager to allow modifications and may break on different operating systems and/or Java versions. Be aware that this is a fragile solution and consider finding a better one for your specific situation. -For more details, see Warnings for Reflective Access.

+For more details and workarounds on Java 17+, see Warnings for Reflective Access.

@@ -532,11 +532,11 @@

Warnings for Reflective Access

-
[ERROR] WARNING: An illegal reflective access operation has occurred
-[ERROR] WARNING: Illegal reflective access by org.junitpioneer.jupiter.EnvironmentVariableUtils [...] to field [...]
-[ERROR] WARNING: Please consider reporting this to the maintainers of org.junitpioneer.jupiter.EnvironmentVariableUtils
-[ERROR] WARNING: Use --illegal-access=warn to enable warnings of further illegal reflective access operations
-[ERROR] WARNING: All illegal access operations will be denied in a future release
+
WARNING: An illegal reflective access operation has occurred
+WARNING: Illegal reflective access by org.junitpioneer.jupiter.EnvironmentVariableUtils [...] to field [...]
+WARNING: Please consider reporting this to the maintainers of org.junitpioneer.jupiter.EnvironmentVariableUtils
+WARNING: Use --illegal-access=warn to enable warnings of further illegal reflective access operations
+WARNING: All illegal access operations will be denied in a future release
@@ -549,12 +549,19 @@

Warnings for Reflective Access

+

This is because Java 17 is strongly encapsulated and the reflective access to JDK internals is no longer permitted. +(For further details, see also JEP 403.)

+
+

The best way to prevent these warnings/errors, is to change the code under test, so this extension is no longer needed. -The next best thing is to allow access to that specific package:

+However, some tests require environment variables to be cleared, set, or restored. +In this case, we recommend using --add-opens to grant JUnit Pioneer access to the aforementiond internals:

-
--add-opens java.base/java.util=$TARGET_MODULE
+
# to access java.util.Collections$UnmodifiableMap.m
+--add-opens java.base/java.util=$TARGET_MODULE
+# to access java.lang.ProcessEnvironment.theEnvironment
 --add-opens java.base/java.lang=$TARGET_MODULE
@@ -565,13 +572,46 @@

Warnings for Reflective Access

+
+

For instance, if you are using Maven and test on the class path, your Surefire configuration may look like this:

+
+
+
+
<plugin>
+    <groupId>org.apache.maven.plugins</groupId>
+    <artifactId>maven-surefire-plugin</artifactId>
+    <version><!--...--></version>
+    <configuration>
+        <argLine>
+            --add-opens java.base/java.util=ALL-UNNAMED
+            --add-opens java.base/java.lang=ALL-UNNAMED
+        </argLine>
+    </configuration>
+</plugin>
+
+
+
+ + + + + +
+
Note
+		 +
+

Depending on your IDE, these settings may not be picked up. +Therefore, you possibly also have to include --add-opens in your test’s run configuration.

+
+
+
diff --git a/docs/expected-to-fail-tests/index.html b/docs/expected-to-fail-tests/index.html index 33bdd94c..030df2f5 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 f0c79c44..390f07bb 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 021a95c0..75c997b6 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 862893f3..393b6be3 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 98738738..742ab398 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 756b9a53..9c7a3a5b 100644 --- a/docs/resources/index.html +++ b/docs/resources/index.html @@ -33,7 +33,7 @@ - + diff --git a/docs/retrying-test/index.html b/docs/retrying-test/index.html index cc5d8f38..317794d8 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 934159c6..de08b9da 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 39de9a8b..fc92d6db 100644 --- a/docs/standard-input-output/index.html +++ b/docs/standard-input-output/index.html @@ -33,7 +33,7 @@ - + diff --git a/docs/stopwatch/index.html b/docs/stopwatch/index.html index 98c0b980..01ec9df8 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 03a60e57..5f285e7f 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 66a81e7c..95c69782 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 9cd6ef20..92a6fcd0 100644 --- a/docs/temp-directory/index.html +++ b/docs/temp-directory/index.html @@ -33,7 +33,7 @@ - + diff --git a/docs/vintage-test/index.html b/docs/vintage-test/index.html index fa82b4ea..f46720ba 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 31f0e9c7..98d4db87 100644 --- a/feed.xml +++ b/feed.xml @@ -1 +1 @@ -Jekyll2023-09-13T17:08:35+00:00https://junit-pioneer.org/feed.xmlJUnit PioneerJUnit 5 Extension PackJUnit Pioneers \ No newline at end of file +Jekyll2023-10-07T17:37:10+00:00https://junit-pioneer.org/feed.xmlJUnit PioneerJUnit 5 Extension PackJUnit Pioneers \ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml index 10509a0d..3a9cf1d3 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -2,95 +2,95 @@ https://junit-pioneer.org/docs/byte-array-converter/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/cartesian-product-v1/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/cartesian-product/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/default-locale-timezone/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/disable-if-display-name/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/disable-if-test-fails/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/disable-parameterized-tests/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/disabled-until/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/environment-variables/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/expected-to-fail-tests/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/issue/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/json-argument-source/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/range-sources/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/report-entries/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/resources/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/retrying-test/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/simple-arguments-aggregator/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/standard-input-output/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/stopwatch/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/system-properties/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/temp-directory-removed/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/temp-directory/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/vintage-test/ -2023-09-13T17:08:35+00:00 +2023-10-07T17:37:10+00:00 https://junit-pioneer.org/docs/