feat: Add DatabricksDeltaS3ConnectionConfig to configs

Author: jiatolentino

HISTORY.rst

@@ -2,6 +2,11 @@
 History
 =======
 
+1.0.2 (2026-05-14)
+------------------
+
+* Added ``DatabricksDeltaS3ConnectionConfig`` for Databricks Delta tables stored in S3.
+
 1.0.1 (2026-05-11)
 ------------------
 

datamasque/client/__init__.py

@@ -30,6 +30,7 @@
     ConnectionId,
     DatabaseConnectionConfig,
     DatabaseType,
+    DatabricksDeltaS3ConnectionConfig,
     DynamoConnectionConfig,
     FileConnectionConfig,
     MongoConnectionConfig,
@@ -128,6 +129,7 @@
     "DataMasqueUserError",
     "DatabaseConnectionConfig",
     "DatabaseType",
+    "DatabricksDeltaS3ConnectionConfig",
     "DiscoveryMatch",
     "DynamoConnectionConfig",
     "FailedToStartError",

datamasque/client/models/connection.py

@@ -391,10 +391,19 @@ class MountedShareConnectionConfig(FileConnectionConfig):
     type: Literal["mounted_share_connection"] = "mounted_share_connection"
 
 
+class DatabricksDeltaS3ConnectionConfig(FileConnectionConfig):
+    """Connection configuration for Databricks Delta tables stored in S3."""
+
+    type: Literal["databricks_delta_s3_connection"] = "databricks_delta_s3_connection"
+    bucket: str = ""
+    iam_role_arn: Optional[str] = None
+
+
 FILE_TYPE_MAP: dict[str, type[FileConnectionConfig]] = {
     "s3_connection": S3ConnectionConfig,
     "azure_blob_connection": AzureConnectionConfig,
     "mounted_share_connection": MountedShareConnectionConfig,
+    "databricks_delta_s3_connection": DatabricksDeltaS3ConnectionConfig,
 }
 
 DB_TYPE_MAP: dict[str, type[ConnectionConfig]] = {

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "datamasque-python"
-version = "1.0.1"
+version = "1.0.2"
 description = "Official Python client for the DataMasque data-masking API."
 authors = [
     { name = "DataMasque Ltd" },

setup.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 1.0.1
+current_version = 1.0.2
 commit = True
 tag = True
 

tests/test_connections.py

@@ -9,6 +9,7 @@
     ConnectionId,
     DatabaseConnectionConfig,
     DatabaseType,
+    DatabricksDeltaS3ConnectionConfig,
     DynamoConnectionConfig,
     MongoConnectionConfig,
     MountedShareConnectionConfig,
@@ -695,6 +696,65 @@ def test_s3_connection_model_validate_no_iam_role():
     assert conn.iam_role_arn is None
 
 
+def test_databricks_delta_s3_connection_model_validate():
+    payload = {
+        "id": "11223344-5566-7788-99aa-bbccddeeff00",
+        "name": "delta_s3",
+        "mask_type": "file",
+        "type": "databricks_delta_s3_connection",
+        "base_directory": "delta/",
+        "is_file_mask_source": True,
+        "is_file_mask_destination": False,
+        "bucket": "my-delta-bucket",
+        "iam_role_arn": "arn:aws:iam::111122223333:role/delta-role",
+    }
+
+    conn = DatabricksDeltaS3ConnectionConfig.model_validate(payload)
+
+    assert isinstance(conn, DatabricksDeltaS3ConnectionConfig)
+    assert conn.id == "11223344-5566-7788-99aa-bbccddeeff00"
+    assert conn.name == "delta_s3"
+    assert conn.bucket == "my-delta-bucket"
+    assert conn.base_directory == "delta/"
+    assert conn.is_file_mask_source is True
+    assert conn.is_file_mask_destination is False
+    assert conn.iam_role_arn == "arn:aws:iam::111122223333:role/delta-role"
+
+
+def test_databricks_delta_s3_connection_model_validate_no_iam_role():
+    payload = {
+        "id": "id-delta",
+        "name": "delta_s3",
+        "mask_type": "file",
+        "type": "databricks_delta_s3_connection",
+        "base_directory": "",
+        "is_file_mask_source": True,
+        "is_file_mask_destination": False,
+        "bucket": "my-delta-bucket",
+    }
+
+    conn = DatabricksDeltaS3ConnectionConfig.model_validate(payload)
+    assert conn.iam_role_arn is None
+
+
+def test_validate_connection_dispatches_databricks_delta_s3():
+    payload = {
+        "id": "aabb-ccdd",
+        "name": "delta",
+        "mask_type": "file",
+        "type": "databricks_delta_s3_connection",
+        "base_directory": "",
+        "is_file_mask_source": False,
+        "is_file_mask_destination": True,
+        "bucket": "delta-bucket",
+    }
+
+    conn = validate_connection(payload)
+
+    assert isinstance(conn, DatabricksDeltaS3ConnectionConfig)
+    assert conn.bucket == "delta-bucket"
+
+
 def test_azure_connection_model_validate_blanks_encrypted_connection_string():
     payload = {
         "id": "490502e5-5bf6-4abb-b67b-c6091d40ecf0",