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:

.. code-block:: 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``:

.. code-block:: bash

    ./clickhouse-test -c "../../build/dbms/src/Server/clickhouse --client"


To run a single test, i.e. ``00395_nullable``:

.. code-block:: bash

    ./clickhouse-test 00395