Sail
0.7.2

Appearance

This is a snapshot of the development guide for a released Sail version. For up-to-date information, please visit the development guide for the main branch here.

Running Ibis Tests ​

You can run Ibis unit tests with the Spark backend connected to the Sail server.

Running the Spark Connect Server ​

Use the following command to build and run the Sail Spark Connect server in the test-ibis environment.

bash
hatch run test-ibis:scripts/spark-tests/run-server.sh

Running the Tests ​

After running the server, start another terminal and use the following command to run the Ibis tests.

bash
hatch run test-ibis:env scripts/spark-tests/run-tests.sh

The test logs will be written to tmp/spark-tests/<name> where <name> is defined by the TEST_RUN_NAME environment variable whose default value is ibis.

Test Selection ​

You can run selected tests by passing pytest arguments to the script.

bash
hatch run test-ibis:env \
  TEST_RUN_NAME=ibis-selected \
  scripts/spark-tests/run-tests.sh \
  --pyargs ibis.backends -m pyspark -k "test_array"

Note that for the above command, the test logs are written to the directory tmp/spark-tests/ibis-selected, due to the TEST_RUN_NAME environment variable.