prepare release 1.4.0

Signed-off-by: hankem <[email protected]>
TNG · Feb 10, 2025 · c5caa02 · c5caa02
1 parent 3495fc2
commit c5caa02
Show file tree

Hide file tree

Showing 6 changed files with 52 additions and 15 deletions.
diff --git a/README.md b/README.md
@@ -17,7 +17,7 @@ framework.
 ###### Gradle
 
 ```
-testImplementation 'com.tngtech.archunit:archunit:1.3.0'
+testImplementation 'com.tngtech.archunit:archunit:1.4.0'
 ```
 
 ###### Maven
@@ -26,7 +26,7 @@ testImplementation 'com.tngtech.archunit:archunit:1.3.0'
 <dependency>
     <groupId>com.tngtech.archunit</groupId>
     <artifactId>archunit</artifactId>
-    <version>1.3.0</version>
+    <version>1.4.0</version>
     <scope>test</scope>
 </dependency>
 ```

diff --git a/docs/_data/navigation.yml b/docs/_data/navigation.yml
@@ -10,6 +10,6 @@ main:
   - title: "User Guide"
     url: /userguide/html/000_Index.html
   - title: "API"
-    url: https://javadoc.io/doc/com.tngtech.archunit/archunit/1.3.0
+    url: https://javadoc.io/doc/com.tngtech.archunit/archunit/1.4.0
   - title: "About"
     url: /about
diff --git a/docs/_pages/getting-started.md b/docs/_pages/getting-started.md
@@ -15,15 +15,15 @@ ArchUnit can be obtained from Maven Central.
 <dependency>
     <groupId>com.tngtech.archunit</groupId>
     <artifactId>archunit</artifactId>
-    <version>1.3.0</version>
+    <version>1.4.0</version>
     <scope>test</scope>
 </dependency>
 ```
 
 #### Gradle
 ```groovy
 dependencies {
-    testImplementation 'com.tngtech.archunit:archunit:1.3.0'
+    testImplementation 'com.tngtech.archunit:archunit:1.4.0'
 }
 ```
 

diff --git a/docs/_posts/2025-02-10-release-v1.4.0.markdown b/docs/_posts/2025-02-10-release-v1.4.0.markdown
@@ -0,0 +1,8 @@
+---
+layout: splash
+title:  "New release of ArchUnit (v1.4.0)"
+date:   2025-02-10 12:00:00
+categories: news release
+---
+
+A new release of ArchUnit (v1.4.0) is out. For details see [the release on GitHub](https://github.com/TNG/ArchUnit/releases/tag/v1.4.0 "ArchUnit v1.4.0 on GitHub").
diff --git a/docs/userguide/html/000_Index.html b/docs/userguide/html/000_Index.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="">
 <head>
 <meta charset="UTF-8">
 <meta http-equiv="X-UA-Compatible" content="IE=edge">
@@ -450,7 +450,7 @@
 <div id="header">
 <h1>ArchUnit User Guide</h1>
 <div class="details">
-<span id="revnumber">version 1.3.0</span>
+<span id="revnumber">version 1.4.0</span>
 </div>
 <div id="toc" class="toc2">
 <div id="toctitle">Table of Contents</div>
@@ -619,7 +619,7 @@ <h3 id="_junit_4"><a class="anchor" href="#_junit_4"></a>2.1. JUnit 4</h3>
 <pre class="highlightjs highlight nowrap"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
     &lt;groupId&gt;com.tngtech.archunit&lt;/groupId&gt;
     &lt;artifactId&gt;archunit-junit4&lt;/artifactId&gt;
-    &lt;version&gt;1.3.0&lt;/version&gt;
+    &lt;version&gt;1.4.0&lt;/version&gt;
     &lt;scope&gt;test&lt;/scope&gt;
 &lt;/dependency&gt;</code></pre>
 </div>
@@ -628,7 +628,7 @@ <h3 id="_junit_4"><a class="anchor" href="#_junit_4"></a>2.1. JUnit 4</h3>
 <div class="title">build.gradle</div>
 <div class="content">
 <pre class="highlightjs highlight nowrap"><code class="language-none hljs">dependencies {
-    testImplementation 'com.tngtech.archunit:archunit-junit4:1.3.0'
+    testImplementation 'com.tngtech.archunit:archunit-junit4:1.4.0'
 }</code></pre>
 </div>
 </div>
@@ -649,7 +649,7 @@ <h3 id="_junit_5"><a class="anchor" href="#_junit_5"></a>2.2. JUnit 5</h3>
 <pre class="highlightjs highlight nowrap"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
     &lt;groupId&gt;com.tngtech.archunit&lt;/groupId&gt;
     &lt;artifactId&gt;archunit-junit5&lt;/artifactId&gt;
-    &lt;version&gt;1.3.0&lt;/version&gt;
+    &lt;version&gt;1.4.0&lt;/version&gt;
     &lt;scope&gt;test&lt;/scope&gt;
 &lt;/dependency&gt;</code></pre>
 </div>
@@ -658,7 +658,7 @@ <h3 id="_junit_5"><a class="anchor" href="#_junit_5"></a>2.2. JUnit 5</h3>
 <div class="title">build.gradle</div>
 <div class="content">
 <pre class="highlightjs highlight nowrap"><code class="language-none hljs">dependencies {
-    testImplementation 'com.tngtech.archunit:archunit-junit5:1.3.0'
+    testImplementation 'com.tngtech.archunit:archunit-junit5:1.4.0'
 }</code></pre>
 </div>
 </div>
@@ -675,7 +675,7 @@ <h3 id="_other_test_frameworks"><a class="anchor" href="#_other_test_frameworks"
 <pre class="highlightjs highlight nowrap"><code class="language-xml hljs" data-lang="xml">&lt;dependency&gt;
     &lt;groupId&gt;com.tngtech.archunit&lt;/groupId&gt;
     &lt;artifactId&gt;archunit&lt;/artifactId&gt;
-    &lt;version&gt;1.3.0&lt;/version&gt;
+    &lt;version&gt;1.4.0&lt;/version&gt;
     &lt;scope&gt;test&lt;/scope&gt;
 &lt;/dependency&gt;</code></pre>
 </div>
@@ -684,7 +684,7 @@ <h3 id="_other_test_frameworks"><a class="anchor" href="#_other_test_frameworks"
 <div class="title">build.gradle</div>
 <div class="content">
 <pre class="highlightjs highlight nowrap"><code class="language-none hljs">dependencies {
-   testImplementation 'com.tngtech.archunit:archunit:1.3.0'
+   testImplementation 'com.tngtech.archunit:archunit:1.4.0'
 }</code></pre>
 </div>
 </div>
@@ -2658,7 +2658,7 @@ <h4 id="_writing_tests"><a class="anchor" href="#_writing_tests"></a>9.1.1. Writ
 <h4 id="_controlling_the_import"><a class="anchor" href="#_controlling_the_import"></a>9.1.2. Controlling the Import</h4>
 <div class="paragraph">
 <p>Which classes will be imported can be controlled in a declarative way through <code>@AnalyzeClasses</code>.
-If no packages or locations are provided, the whole classpath will be imported.
+If no packages or locations are provided, the package of the annotated test class will be imported.
 You can specify packages to import as strings:</p>
 </div>
 <div class="listingblock">
@@ -2705,6 +2705,35 @@ <h4 id="_controlling_the_import"><a class="anchor" href="#_controlling_the_impor
 <p>As explained in <a href="#_the_core_api">The Core API</a>, you can write your own custom implementation of <code>ImportOption</code>
 and then supply the type to <code>@AnalyzeClasses</code>.</p>
 </div>
+<div class="paragraph">
+<p>To import the whole classpath, instead of just the package of the test class, use the option</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight nowrap"><code class="language-java hljs" data-lang="java">@AnalyzeClasses(wholeClasspath = true)</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that <code>@AnalyzeClasses</code> can also be used as a meta-annotation to avoid repeating the same configuration:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight nowrap"><code class="language-java hljs" data-lang="java">@Retention(RetentionPolicy.RUNTIME)
+@AnalyzeClasses(packagesOf = MyApplicationRoot.class, importOptions = DoNotIncludeTests.class)
+public @interface AnalyzeMainClasses {}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>This annotation can then be used on test classes without repeating the specific configuration of <code>@AnalyzeClasses</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight nowrap"><code class="language-java hljs" data-lang="java">@AnalyzeMainClasses
+public class ArchitectureTest {
+    // ...
+}</code></pre>
+</div>
+</div>
 </div>
 <div class="sect3">
 <h4 id="_controlling_the_cache"><a class="anchor" href="#_controlling_the_cache"></a>9.1.3. Controlling the Cache</h4>

diff --git a/gradle.properties b/gradle.properties
@@ -1,4 +1,4 @@
 org.gradle.parallel=true
 archunit.group=com.tngtech.archunit
-archunit.version=1.4.0-SNAPSHOT
+archunit.version=1.4.0
 org.gradle.jvmargs=--add-exports jdk.compiler/com.sun.tools.javac.code=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED