(grails-core) branch docs/continuous-testing created (now c10e485773)

[ja...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

jamesfredley pushed a change to branch docs/continuous-testing
in repository https://gitbox.apache.org/repos/asf/grails-core.git


      at c10e485773 Document continuous test mode

This branch includes the following new commits:

     new c10e485773 Document continuous test mode

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.

(grails-core) 01/01: Document continuous test mode

[ja...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

jamesfredley pushed a commit to branch docs/continuous-testing
in repository https://gitbox.apache.org/repos/asf/grails-core.git

commit c10e4857738299bd02c2a91d03a4cbada263e8b2
Author: James Fredley <ja...@users.noreply.github.com>
AuthorDate: Fri Jul 17 14:38:53 2026 -0400

    Document continuous test mode
    
    Assisted-by: opencode:gpt-5.6-sol
---
 .../guide/testing/runningTests/withGrailsCli.adoc   | 21 ++++++++++++++++++++-
 grails-doc/src/en/ref/Command Line/test-app.adoc    | 13 ++++++++++---
 2 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/grails-doc/src/en/guide/testing/runningTests/withGrailsCli.adoc b/grails-doc/src/en/guide/testing/runningTests/withGrailsCli.adoc
index 9813ed5111..12a936c25f 100644
--- a/grails-doc/src/en/guide/testing/runningTests/withGrailsCli.adoc
+++ b/grails-doc/src/en/guide/testing/runningTests/withGrailsCli.adoc
@@ -59,6 +59,25 @@ open test-report
 You can also run your unit tests from within most IDEs.
 
 
+==== Running Tests Continuously
+
+
+For a local edit-and-test loop in the Grails interactive CLI, start continuous testing:
+
+
+[source,groovy]
+----
+grails
+grails> test-app -continuous
+----
+
+
+Grails starts its `DirectoryWatcher` and reruns the selected tests after a `.groovy` or `.java` file is created or changed in `grails-app`, `src/main/groovy`, `src/test/groovy`, or `src/integration-test/groovy`. It does not run tests immediately. Combine `-continuous` with test name patterns or `-unit` and `-integration` to keep the same test selection for each rerun.
+
+
+The watcher is part of Grails, not Gradle `--continuous`, and Grails doesn't pass Gradle's continuous option to the build. It doesn't watch files outside those directories, including `src/main/java`, and `--watch` isn't an alias. Keep the interactive CLI open while using this mode, then exit the CLI or press Ctrl+C to stop it. A one-off `grails test-app -continuous` invocation exits immediately because `DirectoryWatcher` runs on a daemon thread.
+
+
 ==== Targeting Tests
 
 
@@ -162,4 +181,4 @@ Test and phase targeting can be applied at the same time:
 grails test-app some.org.**.* -unit
 ----
 
-This would run all tests in the `unit` phase that are in the package `some.org` or a subpackage.
\ No newline at end of file
+This would run all tests in the `unit` phase that are in the package `some.org` or a subpackage.
diff --git a/grails-doc/src/en/ref/Command Line/test-app.adoc b/grails-doc/src/en/ref/Command Line/test-app.adoc
index cf16261c3e..cb1fb03c82 100644
--- a/grails-doc/src/en/ref/Command Line/test-app.adoc	
+++ b/grails-doc/src/en/ref/Command Line/test-app.adoc	
@@ -45,7 +45,7 @@ grails test-app Foo Bar
 Usage:
 [source,groovy]
 ----
-grails <<environment>>* test-app <<names>>* [-unit|-integration]
+grails <<environment>>* test-app <<names>>* [-unit|-integration] [-continuous]
 ----
 
 Fired Events:
@@ -71,11 +71,18 @@ grails test-app -unit
 grails test-app -integration
 ----
 
-If you only wish to re-run failed tests use the -rerun flag
+=== Continuous Testing
 
 [source,groovy]
 ----
-grails test-app -rerun
+grails
+grails> test-app -continuous
 ----
 
+The `-continuous` option starts Grails' `DirectoryWatcher`. It watches `.groovy` and `.java` files in `grails-app`, `src/main/groovy`, `src/test/groovy`, and `src/integration-test/groovy`. Creating or changing a watched file reruns the tests selected by the command options and test name patterns.
+
+Continuous mode does not run tests when it starts. It is intended for the Grails interactive CLI, where the watcher remains active until you exit the CLI. A one-off `grails test-app -continuous` command exits immediately because `DirectoryWatcher` runs on a daemon thread. Stop interactive continuous testing by exiting the CLI or pressing Ctrl+C.
+
+This is not Gradle's `--continuous` mode. Grails does not pass `--continuous` to Gradle, and `--watch` is not an alias for `-continuous`. Files outside the watched directories, including Java source directories such as `src/main/java`, do not trigger a rerun.
+
 See the link:{guidePath}testing.html[Testing] section for examples on how to combine the different options to target tests.