AssertJ DB - Document assertThat from AssertJ Core is directly usable

Author: jmaniquet

gradle.properties

@@ -8,7 +8,7 @@ javacRelease = 8
 
 assertjVersion         = 3.27.7
 assertjJodaTimeVersion = 2.2.0
-assertjDbVersion       = 3.0.1
+assertjDbVersion       = 3.0.2
 ota4jVersion           = 1.2.0
 
 defaultBuiltBy     = AssertJ Team

src/docs/asciidoc/user-guide/assertj-db-concepts.adoc

@@ -753,11 +753,15 @@ There are examples of the navigation in {assertj-examples-github}/blob/main/asse
 [[assertj-db-concepts-tableorrequestasroot]]
 ===== With a Table or a Request as root
 
-The `assertThat(...)` static method of `org.assertj.db.api.Assertions` allows to create a root assertion on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table].
+The `assertThat(...)` static method of `Assertions` allows to create a root assertion on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Table.html[Table].
 
 [source,java]
 ----
-import static org.assertj.db.api.Assertions.assertThat;
+// From v3.0.2
+import static org.assertj.core.api.Assertions.assertThat;
+
+// For versions <= 3.0.1 :
+// import static org.assertj.db.api.Assertions.assertThat;
 
 assertThat(table)...
 ----
@@ -766,7 +770,11 @@ or on a https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/
 
 [source,java]
 ----
-import static org.assertj.db.api.Assertions.assertThat;
+// From v3.0.2
+import static org.assertj.core.api.Assertions.assertThat;
+
+// For versions <= 3.0.1 :
+// import static org.assertj.db.api.Assertions.assertThat;
 
 assertThat(request)...
 ----
@@ -794,12 +802,16 @@ More details on this concept in assertj-db-features-highlight.html#tableorreques
 [[assertj-db-concepts-changesasroot]]
 ===== With Changes as root
 
-The `assertThat(...)` static method of `org.assertj.db.api.Assertions`
+The `assertThat(...)` static method of `Assertions`
 allows to create a root assertion on https://www.javadoc.io/doc/org.assertj/assertj-db/latest/org/assertj/db/type/Changes.html[Changes].
 
 [source,java]
 ----
-import static org.assertj.db.api.Assertions.assertThat;
+// From v3.0.2
+import static org.assertj.core.api.Assertions.assertThat;
+
+// For versions <= 3.0.1 :
+// import static org.assertj.db.api.Assertions.assertThat;
 
 assertThat(changes)...
 ----

src/docs/asciidoc/user-guide/assertj-db-quickstart.adoc

@@ -40,9 +40,16 @@ testImplementation("org.assertj:assertj-db:{assertj-db-version}")
 
 ===== Other dependency management tool
 
-Check this page to find the relevant https://search.maven.org/#artifactdetails|org.assertj|assertj-db|3.0.1|bundle[assertj db dependency declaration].
+Check this page to find the relevant https://search.maven.org/#artifactdetails|org.assertj|assertj-db|3.0.2|bundle[assertj db dependency declaration].
 
-==== Statically import org.assertj.db.api.Assertions.assertThat
+==== Statically import Assertions.assertThat
+
+[NOTE]
+====
+- From version 3.0.2 use org.assertj.**core**.api.Assertions.assertThat directly
+  - No more double import problem - see issue https://github.com/assertj/assertj-db/issues/329[329]
+- For previous versions use org.assertj.**db**.api.Assertions.assertThat
+====
 
 \... and use your preferred IDE code completion after assertThat.
 

src/docs/asciidoc/user-guide/assertj-db-release-notes.adoc

@@ -3,6 +3,8 @@
 
 Latest release notes:
 
+- link:#assertj-db-3-0-2-release-notes[AssertJ DB 3.0.2]
+- link:#assertj-db-3-0-1-release-notes[AssertJ DB 3.0.1]
 - link:#assertj-db-3-0-0-release-notes[AssertJ DB 3.0.0]
 - link:#assertj-db-2-0-2-release-notes[AssertJ DB 2.0.2]
 - link:#assertj-db-2-0-1-release-notes[AssertJ DB 2.0.1]
@@ -14,6 +16,51 @@ Latest release notes:
 - link:#assertj-db-1-0-1-release-notes[AssertJ DB 1.0.1]
 - link:#assertj-db-1-0-0-release-notes[AssertJ DB 1.0.0]
 
+[[assertj-db-3-0-2-release-notes]]
+==== AssertJ DB 3.0.2
+
+Release date: 2026-02-21
+
+[[assertj-db-3-0-2-contributors]]
+[.release-note-category]#icon:user[] Contributors#
+
+Thanks to https://github.com/fl0rian-p[@fl0rian-p] and https://github.com/jmaniquet[Jonathan Maniquet] for their contributions.
+
+[[assertj-db-3.0.2-improvements]]
+[.release-note-category]#icon:arrow-circle-up[] Improvements#
+
+- https://github.com/assertj/assertj-db/issues/329[issue #329:] Makes Core and DB assertions coexist with only one import by https://github.com/jmaniquet[Jonathan Maniquet]
+
+[[assertj-db-3.0.2-fixed]]
+[.release-note-category]#icon:wrench[] Fixed#
+
+- https://github.com/assertj/assertj-db/issues/328[issue #328:] Use Values#areEqual when looking for modified columns by https://github.com/fl0rian-p[@fl0rian-p]
+
+[[assertj-db-3.0.2-chore]]
+[.release-note-category]#icon:cog[] Chore#
+
+- https://github.com/assertj/assertj-db/issues/332[issue #332:] Replace Junit4 assertions by AssertJ ones by https://github.com/jmaniquet[Jonathan Maniquet]
+
+[[assertj-db-3-0-1-release-notes]]
+==== AssertJ DB 3.0.1
+
+Release date: 2025-12-21
+
+[[assertj-db-3-0-1-contributors]]
+[.release-note-category]#icon:user[] Contributors#
+
+Thanks to https://github.com/fl0rian-p[@fl0rian-p] for his contribution.
+
+[[assertj-db-3.0.1-fixed]]
+[.release-note-category]#icon:wrench[] Fixed#
+
+- https://github.com/assertj/assertj-db/issues/325[issue #325] Support array comparison by https://github.com/fl0rian-p[@fl0rian-p]
+
+[[assertj-db-3.0.1-chore]]
+[.release-note-category]#icon:cog[] Chore#
+
+- Upgrade to AssertJ Parent POM 2.27.6
+
 [[assertj-db-3-0-0-release-notes]]
 ==== AssertJ DB 3.0.0
 

src/test/java/example/db/TableAssertionExamples.java

@@ -1,7 +1,11 @@
 package example.db;
 
 // tag::user_guide[]
-import static org.assertj.db.api.Assertions.assertThat;
+// From v3.0.2
+import static org.assertj.core.api.Assertions.assertThat;
+
+// For versions <= 3.0.1 :
+// import static org.assertj.db.api.Assertions.assertThat;
 
 import org.assertj.db.type.AssertDbConnection;
 import org.assertj.db.type.AssertDbConnectionFactory;