Testing

Local testing

Tests are run locally with pytest.

Prerequisites

• pytest: pip install pytest or mamba install pytest

• Suggested: Note that pytest-xdist allows executing tests in parallel, which can allow tests to complete much more quickly.

  • pip install pytest-xdist or mamba install pytest-xdist

• Build the library following the build instructions

Running tests

pytest

or, with pytest-xdist installed, run N test processes:

pytest -nN

CI for a TileDB branch

• TileDB-Py runs nightly builds against the TileDB dev branch.

• dev or other branches may be tested on demand by creating a branch and specifying the target git SHA in setup.py:

git checkout -b xyz/test-<target short>

# edit setup.py and change TILEDB_VERSION to the FULL <target git SHA>
# must include the FULL git SHA here

git commit -m "TMP testing tiledb <target git sha>"
git push origin xyz/test-<target git SHA>

• Branch build status will be available from the orange/green/red status circle when viewing the HEAD commit or:
  • Github Actions builds: https://github.com/TileDB-Inc/TileDB-Py/actions
  • Azure pipelines builds: https://dev.azure.com/TileDB-Inc/CI/_build?definitionId=1