Serial execution

The default mode for running tests is serially; in other words, scenario files are executed one after the other.

Parallel execution

WebTau supports executing tests in parallel. In this mode, scenario files are executed in parallel. Individual scenarios are still executed sequentially.For large test suites, it is therefore advisable to create many small focused scenario files instead of few large files.Use --parallel parameter to run each test file in a separate thread.Use numberOfThreads to specify the maximum number of threads either through the configuration file or as a CLI parameter. Value of -1 is equivalent of using --parallel and will use as many threads as there are files.Note: scenario file execution order is not guaranteed.

Scenario discovery

WebTau via CLI or Maven plugin supports a number of methods for specifying and discovering scenarios.The simplest way is to list the scenario files explicitly: CLI webtau scenarios/rest/simpleGet.groovy scnearios/rest/simplePost.groovy Maven <plugin> <groupId>org.testingisdocumenting.webtau</groupId> <artifactId>webtau-maven-plugin</artifactId> <version>2.2</version> <executions> <execution> <phase>test</phase> <goals> <goal>run</goal> </goals> </execution> </executions> <configuration> <workingDir>${project.basedir}/src/main/groovy</workingDir> <tests> <directory>${project.basedir}/src/main/groovy</directory> <includes> <include>scenarios/simpleGet.groovy</include> <include>scenarios/simplePost.groovy</include> </includes> </tests> </configuration> </plugin> Wildcard matching is also supported. In the CLI version this is normal shell https://en.wikipedia.org/wiki/Glob_(programming) glob and in Maven it's a standard Maven file inclusion block: CLI webtau scenarios/rest/simple*.groovy Maven <plugin> <groupId>org.testingisdocumenting.webtau</groupId> <artifactId>webtau-maven-plugin</artifactId> <version>2.2</version> <executions> <execution> <phase>test</phase> <goals> <goal>run</goal> </goals> </execution> </executions> <configuration> <workingDir>${project.basedir}/src/main/groovy</workingDir> <tests> <directory>${project.basedir}/src/main/groovy</directory> <includes> <include>scenarios/simple*.groovy</include> </includes> </tests> </configuration> </plugin> It is also possible to include a set of base directories and WebTau will then find all *.groovy files within them, recursively: CLI webtau scenarios/rest Maven <plugin> <groupId>org.testingisdocumenting.webtau</groupId> <artifactId>webtau-maven-plugin</artifactId> <version>2.2</version> <executions> <execution> <phase>test</phase> <goals> <goal>run</goal> </goals> </execution> </executions> <configuration> <workingDir>${project.basedir}/src/main/groovy</workingDir> <tests> <directory>${project.basedir}/src/main/groovy</directory> </tests> </configuration> </plugin> In this mode, the HTML report that WebTau generates will show paths to the files relative to the requested directories.