Update to source b2f5e11, xp e9065d1

junit-pioneer · Oct 7, 2023 · bfbda62 · bfbda62
1 parent b422328
commit bfbda62
Show file tree

Hide file tree

Showing 25 changed files with 99 additions and 59 deletions.
diff --git a/docs/byte-array-converter/index.html b/docs/byte-array-converter/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/cartesian-product-v1/index.html b/docs/cartesian-product-v1/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/cartesian-product/index.html b/docs/cartesian-product/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/default-locale-timezone/index.html b/docs/default-locale-timezone/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/disable-if-display-name/index.html b/docs/disable-if-display-name/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/disable-if-test-fails/index.html b/docs/disable-if-test-fails/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/disable-parameterized-tests/index.html b/docs/disable-parameterized-tests/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/disabled-until/index.html b/docs/disabled-until/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/environment-variables/index.html b/docs/environment-variables/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 
@@ -298,10 +298,10 @@ <h2 id="clearenvironmentvariable-and-setenvironmentvariable"><code>@ClearEnviron
 </td>
 <td class="content">
 <div class="paragraph">
-<p>Java considers environment variables to be immutable, so this extension uses reflection to change them.
-This requires that the <code>SecurityManager</code> allows modifications and can potentially break on different operating systems and Java versions.
+<p>Java considers environment variables to be immutable, which is why this extension uses reflection to change them.
+This requires the <code>SecurityManager</code> 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 <a href="#warnings-for-reflective-access">Warnings for Reflective Access</a>.</p>
+For more details and workarounds on Java 17+, see <a href="#warnings-for-reflective-access">Warnings for Reflective Access</a>.</p>
 </div>
 </td>
 </tr>
@@ -532,11 +532,11 @@ <h2 id="warnings-for-reflective-access">Warnings for Reflective Access</h2>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="pygments highlight" style="background: #272822; color: #f8f8f2"><code><span></span>[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</code></pre>
+<pre class="pygments highlight" style="background: #272822; color: #f8f8f2"><code><span></span>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</code></pre>
 </div>
 </div>
 <div class="paragraph">
@@ -549,12 +549,19 @@ <h2 id="warnings-for-reflective-access">Warnings for Reflective Access</h2>
 </div>
 </div>
 <div class="paragraph">
+<p>This is because <a href="https://docs.oracle.com/en/java/javase/17/migrate/migrating-jdk-8-later-jdk-releases.html#GUID-7BB28E4D-99B3-4078-BDC4-FC24180CE82B">Java 17 is strongly encapsulated</a> and the reflective access to JDK internals is no longer permitted.
+(For further details, see also <a href="https://openjdk.org/jeps/403">JEP 403</a>.)</p>
+</div>
+<div class="paragraph">
 <p>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:</p>
+However, some tests require environment variables to be cleared, set, or restored.
+In this case, we recommend using <code>--add-opens</code> to grant JUnit Pioneer access to the aforementiond internals:</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="pygments highlight" style="background: #272822; color: #f8f8f2"><code><span></span>--add-opens java.base/java.util=$TARGET_MODULE
+<pre class="pygments highlight" style="background: #272822; color: #f8f8f2"><code><span></span># 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</code></pre>
 </div>
 </div>
@@ -565,13 +572,46 @@ <h2 id="warnings-for-reflective-access">Warnings for Reflective Access</h2>
 <div class="ulist">
 <ul>
 <li>
-<p><a href="https://docs.gradle.org/current/dsl/org.gradle.api.tasks.testing.Test.html">Gradle</a></p>
+<p><a href="https://docs.gradle.org/current/dsl/org.gradle.api.tasks.testing.Test.html#org.gradle.api.tasks.testing.Test:jvmArgs(java.lang.Iterable)">Gradle Test Task</a></p>
 </li>
 <li>
-<p><a href="https://maven.apache.org/surefire/maven-surefire-plugin/test-mojo.html#argLine">Maven basics</a> and <a href="https://nipafx.dev/maven-on-java-9/">advanced</a></p>
+<p><a href="https://maven.apache.org/surefire/maven-surefire-plugin/test-mojo.html#argLine">Maven Surefire Plugin</a></p>
 </li>
 </ul>
 </div>
+<div class="paragraph">
+<p>For instance, if you are using Maven and test on the class path, your Surefire configuration may look like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="pygments highlight" style="background: #272822; color: #f8f8f2"><code data-lang="xml"><span></span><span style="color: #f92672">&lt;plugin&gt;</span>
+    <span style="color: #f92672">&lt;groupId&gt;</span>org.apache.maven.plugins<span style="color: #f92672">&lt;/groupId&gt;</span>
+    <span style="color: #f92672">&lt;artifactId&gt;</span>maven-surefire-plugin<span style="color: #f92672">&lt;/artifactId&gt;</span>
+    <span style="color: #f92672">&lt;version&gt;</span><span style="color: #75715e">&lt;!--...--&gt;</span><span style="color: #f92672">&lt;/version&gt;</span>
+    <span style="color: #f92672">&lt;configuration&gt;</span>
+        <span style="color: #f92672">&lt;argLine&gt;</span>
+            --add-opens java.base/java.util=ALL-UNNAMED
+            --add-opens java.base/java.lang=ALL-UNNAMED
+        <span style="color: #f92672">&lt;/argLine&gt;</span>
+    <span style="color: #f92672">&lt;/configuration&gt;</span>
+<span style="color: #f92672">&lt;/plugin&gt;</span></code></pre>
+</div>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<div class="title">Note</div>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>Depending on your IDE, these settings may not be picked up.
+Therefore, you possibly also have to include <code>--add-opens</code> in your test&#8217;s run configuration.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
 </div>
 </div>
 <div class="sect1">

diff --git a/docs/expected-to-fail-tests/index.html b/docs/expected-to-fail-tests/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/issue/index.html b/docs/issue/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/json-argument-source/index.html b/docs/json-argument-source/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/range-sources/index.html b/docs/range-sources/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/report-entries/index.html b/docs/report-entries/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/resources/index.html b/docs/resources/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/retrying-test/index.html b/docs/retrying-test/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/simple-arguments-aggregator/index.html b/docs/simple-arguments-aggregator/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/standard-input-output/index.html b/docs/standard-input-output/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/stopwatch/index.html b/docs/stopwatch/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/system-properties/index.html b/docs/system-properties/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/temp-directory-removed/index.html b/docs/temp-directory-removed/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/temp-directory/index.html b/docs/temp-directory/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/docs/vintage-test/index.html b/docs/vintage-test/index.html
@@ -33,7 +33,7 @@
 
 
 
-  <meta property="article:published_time" content="2023-09-13T17:08:35+00:00">
+  <meta property="article:published_time" content="2023-10-07T17:37:10+00:00">
 
 
 

diff --git a/feed.xml b/feed.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="3.9.2">Jekyll</generator><link href="https://junit-pioneer.org/feed.xml" rel="self" type="application/atom+xml" /><link href="https://junit-pioneer.org/" rel="alternate" type="text/html" /><updated>2023-09-13T17:08:35+00:00</updated><id>https://junit-pioneer.org/feed.xml</id><title type="html">JUnit Pioneer</title><subtitle>JUnit 5 Extension Pack</subtitle><author><name>JUnit Pioneers</name></author></feed>
+<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="3.9.2">Jekyll</generator><link href="https://junit-pioneer.org/feed.xml" rel="self" type="application/atom+xml" /><link href="https://junit-pioneer.org/" rel="alternate" type="text/html" /><updated>2023-10-07T17:37:10+00:00</updated><id>https://junit-pioneer.org/feed.xml</id><title type="html">JUnit Pioneer</title><subtitle>JUnit 5 Extension Pack</subtitle><author><name>JUnit Pioneers</name></author></feed>