tiledb-cloud 2024.1

TileDB Cloud platform Python client

TileDB-Cloud-Py

This repository contains the Python client for the TileDB Cloud Service.

Quick Links

Installation

See Installation Instructions

Quickstart

See Quickstart section of the docs.

API Documentation

See https://tiledb-inc.github.io/TileDB-Cloud-Py/

Contribute to documentation

Documentation uses Quarto style documentation.

• Install Quarto for your OS
• Install documentation dependencies: pip install .[docs]
• Update the docs/_quarto.yaml file accordingly (read the quartodoc documentation on how to do that)
• Build the docs: quartodoc build --config docs/_quarto.yaml
• Preview the generated docs: quarto preview docs/
• Create a relevant PR

Testing

• Selection:
  • All tests: pytest
  • All tests with verbosity: pytest -vs
  • Tests with taskgraphs in their names: pytest -vsk taskgraphs
• Credentials:
  • These tests run on TileDB Cloud using your current environment variable TILEDB_REST_TOKEN -- you will need a valid API token for the tests to pass
  • For continuous integration, the token is configured for the unittest user and all tests should pass
  • For interactive use, if your TILEDB_REST_TOKEN points to your own account, most tests will run, except for those that explicitly check against contents of the unittest account which are skipped