Skip to content

Commit fca2a10

Browse files
lipsillkcm
authored andcommitted
TESTING.asciidoc fix examples using forbidden annotation (#34515)
Clean up examples not to use forbidden test annotation `@Nightly`. remove references to unused annotations
1 parent 9ebbdf0 commit fca2a10

File tree

1 file changed

+4
-21
lines changed

1 file changed

+4
-21
lines changed

TESTING.asciidoc

Lines changed: 4 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -77,39 +77,24 @@ Run a single test case (variants)
7777
./gradlew test "-Dtests.class=*.ClassName"
7878
----------------------------------------------------------
7979

80-
Run all tests in a package and sub-packages
80+
Run all tests in a package and its sub-packages
8181

8282
----------------------------------------------------
8383
./gradlew test "-Dtests.class=org.elasticsearch.package.*"
8484
----------------------------------------------------
8585

86-
Run any test methods that contain 'esi' (like: ...r*esi*ze...).
86+
Run any test methods that contain 'esi' (like: ...r*esi*ze...)
8787

8888
-------------------------------
8989
./gradlew test "-Dtests.method=*esi*"
9090
-------------------------------
9191

92-
You can also filter tests by certain annotations ie:
93-
94-
* `@Nightly` - tests that only run in nightly builds (disabled by default)
95-
* `@Backwards` - backwards compatibility tests (disabled by default)
96-
* `@AwaitsFix` - tests that are waiting for a bugfix (disabled by default)
97-
* `@BadApple` - tests that are known to fail randomly (disabled by default)
98-
99-
Those annotation names can be combined into a filter expression like:
92+
Run all tests that are waiting for a bugfix (disabled by default)
10093

10194
------------------------------------------------
102-
./gradlew test -Dtests.filter="@nightly and not @backwards"
95+
./gradlew test -Dtests.filter=@awaitsfix
10396
------------------------------------------------
10497

105-
to run all nightly test but not the ones that are backwards tests. `tests.filter` supports
106-
the boolean operators `and, or, not` and grouping ie:
107-
108-
109-
---------------------------------------------------------------
110-
./gradlew test -Dtests.filter="@nightly and not(@badapple or @backwards)"
111-
---------------------------------------------------------------
112-
11398
=== Seed and repetitions.
11499

115100
Run with a given seed (seed is a hex-encoded long).
@@ -160,8 +145,6 @@ Test groups can be enabled or disabled (true/false).
160145
Default value provided below in [brackets].
161146

162147
------------------------------------------------------------------
163-
./gradlew test -Dtests.nightly=[false] - nightly test group (@Nightly)
164-
./gradlew test -Dtests.weekly=[false] - weekly tests (@Weekly)
165148
./gradlew test -Dtests.awaitsfix=[false] - known issue (@AwaitsFix)
166149
------------------------------------------------------------------
167150

0 commit comments

Comments
 (0)