Skip to content

Commit

Permalink
Update path to run-launcher script
Browse files Browse the repository at this point in the history
  • Loading branch information
hashhar committed Aug 13, 2021
1 parent 765eb2e commit bcf9d32
Showing 1 changed file with 15 additions and 10 deletions.
25 changes: 15 additions & 10 deletions testing/trino-product-tests/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,14 @@ setup is as follows: a single Docker container runs Hadoop in pseudo-distributed
mode and Trino runs either in Docker container(s) (both pseudo-distributed
and distributed setups are possible) or manually from IntelliJ (for
debugging Trino). The tests run in a separate JVM and they can be started
using the launcher found in `trino-product-tests-launcher/bin/run-launcher`. The product
using the launcher found in `testing/trino-product-tests-launcher/bin/run-launcher`. The product
tests are run using the [Tempto](https://github.com/trinodb/tempto) harness.

**There is a helper script at `bin/ptl` which calls
`testing/trino-product-tests-launcher/bin/run-launcher` and helps you avoid
typing the full path to the launcher everytime. Rest of this document uses
`bin/ptl` to start the launcher but you can use the full path too.**

Developers should consider writing product tests in addition to any unit tests
when making changes to user visible features. The product tests should also
be run after all code changes to ensure no existing functionality has been
Expand Down Expand Up @@ -52,7 +57,7 @@ groups run the following command:

```
./mvnw install -DskipTests
trino-product-tests-launcher/bin/run-launcher test run --environment <environment> \
bin/ptl test run --environment <environment> \
[--config <environment config>] \
-- <tempto arguments>
```
Expand Down Expand Up @@ -97,7 +102,7 @@ You can obtain list of available environments using command:

```
./mvnw install -DskipTests
trino-product-tests-launcher/bin/run-launcher env list
bin/ptl env list
```

#### Environment config
Expand All @@ -111,7 +116,7 @@ Most of the Hadoop-based environments can be run in multiple configurations that
You can obtain list of available environment configurations using command:

```
trino-product-tests-launcher/bin/run-launcher env list
bin/ptl env list
```

All of `test run`, `env up` and `suite run` commands accept `--config <environment config>` setting.
Expand All @@ -125,13 +130,13 @@ and each type can be run individually with the following commands:

```
# Run single Java based test
trino-product-tests-launcher/bin/run-launcher test run \
bin/ptl test run \
--environment <environment> \
[--config <environment config>] \
-- -t io.trino.tests.functions.operators.Comparison.testLessThanOrEqualOperatorExists
# Run single convention based test
trino-product-tests-launcher/bin/run-launcher test run \
bin/ptl test run \
--environment <environment> \
[--config <environment config>] \
-- -t sql_tests.testcases.system.selectInformationSchemaTables
Expand All @@ -148,7 +153,7 @@ particular group, use the `-g` argument as shown:

```
# Run all tests in the string_functions and create_table groups
trino-product-tests-launcher/bin/run-launcher test run \
bin/ptl test run \
--environment <environment> \
[--config <environment config>] \
-- -g string_functions,create_tables
Expand Down Expand Up @@ -185,16 +190,16 @@ Tests are further organized into suites which contain execution of multiple test
You can obtain list of available test suites using command:

```
trino-product-tests-launcher/bin/run-launcher suite list
bin/ptl suite list
```

Command `trino-product-tests-launcher/bin/run-launcher suite describe --suite <suite name>` shows list of tests that will be executed and environments
Command `bin/ptl suite describe --suite <suite name>` shows list of tests that will be executed and environments
that will be used when `suite run` is invoked.

You can execute single suite using command:

```
trino-product-tests-launcher/bin/run-launcher suite run --suite <suite name> \
bin/ptl suite run --suite <suite name> \
[--config <environment config>]
```

Expand Down

0 comments on commit bcf9d32

Please sign in to comment.