Add framework for Carrara testing

Author: jp-dark

apis/python/remote_tests/carrara/README.md

@@ -0,0 +1,29 @@
+# Carrara Tests
+
+TileDB v3 aka Carrara introduces a new URL schema with supports relative paths and group membership lifecycle changes.
+
+This directory contains unit tests for Carrara-specific behavior.
+
+# Running the tests
+
+Prerequisites
+
+- You have a user account in a Carrara deployment
+- You have set up your TileDB profile so that you can log into the account with a profile name
+- You have created a teamspace for testing use
+
+With that, set the environment variables and install package dependencies:
+
+```bash
+pip install tiledb_client
+export CARRARA_TEST_PROFILE="..."    # Profile name
+export CARRARA_TEST_WORKSPACE="..."  # Workspace name (must match workspace in the profile)
+export CARRARA_TEST_TEAMSPACE="..."  # Teamspace to use for tests
+```
+
+Run the tests with pytest:
+```bash
+pytest api/python/remotes_tests/carrara/
+```
+
+Objects will be created at the specified workspace/teamspace: `tiledb://${CARRARA_TEST_WORKSPACE}/${CARRARA_TEST_TEAMSPACE}/...`. The test should remove all created objects when completed; however, assets may remain in the case of a test failure.

apis/python/remote_tests/carrara/__init__.py

@@ -0,0 +1,56 @@
+# Copyright (c) TileDB, Inc.
+# Licensed under the MIT License.
+
+from __future__ import annotations
+
+import os
+from collections.abc import Generator
+from uuid import uuid4
+
+import tiledbvcf
+import tiledb
+import pytest
+
+
+# Base CARRARA URI used for all tests.
+# - The teamspace must be owned by the test user.
+# - The workspace must match the workspace defined in the profile.
+PROFILE_NAME = os.getenv("CARRARA_TEST_PROFILE") or "qa"
+WORKSPACE_NAME = os.getenv("CARRARA_TEST_WORKSPACE") or "TileDB-Inc."
+TEAMSPACE_NAME = os.getenv("CARRARA_TEST_TEAMSPACE") or "uat-tests"
+TEST_FOLDER = os.getenv("CARRARA_TEST_FOLDER") or "remote_test"
+BASE_URI = f"tiledb://{WORKSPACE_NAME}/{TEAMSPACE_NAME}/{TEST_FOLDER}"
+
+
+@pytest.fixture(scope="session")
+def carrara_login() -> None:
+    import tiledb.client
+
+    tiledb.client.login(profile_name=PROFILE_NAME)
+    assert tiledb.client.workspaces.get_workspace(tiledb.client.client.get_workspace_id()).name == WORKSPACE_NAME
+
+
+@pytest.fixture
+def carrara_array_path() -> Generator[str, None, None]:
+    """Fixture returns an Array path that will be recursively deleted after test finishes."""
+    import tiledb.client
+
+    path = f"{BASE_URI}/{uuid4()}"
+    yield path
+
+    tiledb.client.assets.delete_asset(path, delete_storage=True)
+
+
+@pytest.fixture
+def carrara_group_path() -> Generator[str, None, None]:
+    """Fixture returns a Group path that will be recursively deleted after test finishes."""
+    path = f"{BASE_URI}/{uuid4()}"
+    yield path
+
+    try:
+        with tiledb.Group(path, mode="m") as G:
+            G.delete(recursive=True)
+    except tiledb.TileDBError:
+        pass
+
+

apis/python/remote_tests/carrara/conftest.py

@@ -0,0 +1,17 @@
+# Copyright (c) TileDB, Inc.
+# Licensed under the MIT License.
+"""
+Basic object creation with Carrara URIs.
+"""
+
+
+from __future__ import annotations
+
+import tiledbvcf
+
+def test_dataset_create(carrara_login: None, carrara_group_path: str):
+    with tiledbvcf.Dataset(carrara_group_path, mode="w") as ds:
+        ds.create_dataset()
+
+    with tiledbvcf.Dataset(carrara_group_path, mode="r") as ds:
+        assert ds.count() == 0