ClickHouse/docs/en/development/tests.md

33 lines
764 B
Markdown
Raw Normal View History

# How to run ClickHouse tests
The `clickhouse-test` utility that is used for functional testing is written using Python 2.x.It also requires you to have some third-party packages:
```bash
$ pip install lxml termcolor
```
In a nutshell:
- Put the `clickhouse` program to `/usr/bin` (or `PATH`)
- Create a `clickhouse-client` symlink in `/usr/bin` pointing to `clickhouse`
- Start the `clickhouse` server
- `cd dbms/tests/`
- Run `./clickhouse-test`
## Example usage
Run `./clickhouse-test --help` to see available options.
To run tests without having to create a symlink or mess with `PATH`:
```bash
2018-06-05 20:09:51 +00:00
./clickhouse-test -c "../../build/dbms/programs/clickhouse --client"
```
To run a single test, i.e. `00395_nullable`:
```bash
./clickhouse-test 00395
```