This is an automated email from the ASF dual-hosted git repository. asf-gitbox-commits pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/cayenne-website.git
commit 57304661cf9045887c85711007689af5ac868b30 Author: Andrus Adamchik <[email protected]> AuthorDate: Sun May 17 10:07:26 2026 -0400 documenting new instructions for running tests with a specific DB --- src/main/site/content/dev/running-unit-tests.md | 29 ++++++------------------- 1 file changed, 7 insertions(+), 22 deletions(-) diff --git a/src/main/site/content/dev/running-unit-tests.md b/src/main/site/content/dev/running-unit-tests.md index d1c1b6627..ebf3f318a 100644 --- a/src/main/site/content/dev/running-unit-tests.md +++ b/src/main/site/content/dev/running-unit-tests.md @@ -5,38 +5,26 @@ url: /dev/running-unit-tests.html --- Cayenne provides a comprehensive suite of unit and integration tests. To -execute tests you must first get Cayenne from Git and satisfy the Maven build -prerequisites. - -## Prerequisites - -Maven [build prerequisites and recommended settings](/dev/building-cayenne.html) apply here. - -{{% gap 2 %}} +execute tests you must first get Cayenne from Git and satisfy the [Maven build +prerequisites](/dev/building-cayenne.html) ## Running Against a Test Database + +The *cayenneTestConnection* property selects the database backend for tests. By default it is *hsql*, so it can be omitted: -No extra setup is required to run the default test suite. By default, -*cayenneTestConnection* is *hsql*: - - $ cd cayenne $ mvn verify -The *cayenneTestConnection* property selects the database backend for tests. -Cayenne has preconfigured local backends that do not require Docker: + +The following are in-memory database backends and can be executed without additional setup: * hsql * h2 * derby * sqlite - -For example: $ mvn verify -DcayenneTestConnection=derby -Cayenne also has preconfigured backends based on -[Testcontainers](https://www.testcontainers.org/). To run these, Docker must be -installed and running: +Cayenne also has preconfigured backends that it starts on Docker (so Docker must be installed and running) : * mysql * mariadb @@ -45,8 +33,6 @@ installed and running: * oracle * db2 -For example: - $ mvn verify -DcayenneTestConnection=mysql You can override the default Docker image tag for Testcontainers-backed @@ -57,7 +43,6 @@ databases with *cayenneTestDbVersion*: {{% gap %}} - ## Using a Custom Database You can configure your own database to be used with tests instead of the built-in options by following these steps:
