lumera 0.8.3__py3-none-any.whl → 0.9.1__py3-none-any.whl

lumera/pb.py

@@ -318,51 +318,84 @@ def delete(collection: str, record_id: str) -> None:
 # =============================================================================
 
 
-def bulk_delete(collection: str, record_ids: Sequence[str]) -> dict[str, Any]:
+def bulk_delete(
+    collection: str,
+    record_ids: Sequence[str],
+    *,
+    transaction: bool = False,
+) -> dict[str, Any]:
     """Delete multiple records by ID.
 
     Args:
         collection: Collection name or ID
         record_ids: List of record IDs to delete (max 1000)
+        transaction: If True, use all-or-nothing semantics (rollback on any failure).
+                     If False (default), partial success is allowed.
 
     Returns:
         Result with succeeded/failed counts and any errors:
         {
             "succeeded": 10,
             "failed": 0,
-            "errors": []
+            "errors": [],
+            "rolled_back": false  # only present if transaction=True and failed
         }
 
     Example:
         >>> result = pb.bulk_delete("deposits", ["id1", "id2", "id3"])
         >>> print(f"Deleted {result['succeeded']} records")
+
+        >>> # Use transaction mode for all-or-nothing
+        >>> result = pb.bulk_delete("deposits", ids, transaction=True)
     """
-    return _bulk_delete_records(collection, record_ids)
+    return _bulk_delete_records(collection, record_ids, transaction=transaction)
 
 
 def bulk_update(
     collection: str,
-    record_ids: Sequence[str],
-    data: dict[str, Any],
+    records: Sequence[dict[str, Any]],
+    *,
+    transaction: bool = False,
 ) -> dict[str, Any]:
-    """Update multiple records with the same data.
+    """Update multiple records with individual data per record.
+
+    Each record must have an 'id' field plus fields to update.
+    Records must exist (returns error if not found, does not create).
 
     Args:
         collection: Collection name or ID
-        record_ids: List of record IDs to update (max 1000)
-        data: Fields to update on all records
+        records: List of records to update (max 1000). Each must have 'id' field.
+        transaction: If True, use all-or-nothing semantics (rollback on any failure).
+                     If False (default), partial success is allowed.
 
     Returns:
-        Result with succeeded/failed counts
+        Result with succeeded/failed counts:
+        {
+            "succeeded": 2,
+            "failed": 0,
+            "errors": [],
+            "rolled_back": false  # only present if transaction=True and failed
+        }
 
     Example:
-        >>> result = pb.bulk_update("deposits", ["id1", "id2"], {"status": "processed"})
+        >>> result = pb.bulk_update("deposits", [
+        ...     {"id": "rec1", "status": "approved", "amount": 100},
+        ...     {"id": "rec2", "status": "rejected", "amount": 200},
+        ... ])
         >>> print(f"Updated {result['succeeded']} records")
+
+        >>> # Use transaction mode for all-or-nothing
+        >>> result = pb.bulk_update("deposits", records, transaction=True)
     """
-    return _bulk_update_records(collection, record_ids, data)
+    return _bulk_update_records(collection, records, transaction=transaction)
 
 
-def bulk_upsert(collection: str, records: Sequence[dict[str, Any]]) -> dict[str, Any]:
+def bulk_upsert(
+    collection: str,
+    records: Sequence[dict[str, Any]],
+    *,
+    transaction: bool = False,
+) -> dict[str, Any]:
     """Create or update multiple records by ID.
 
     Each record can include an "id" field. Records with matching IDs will be
@@ -371,25 +404,44 @@ def bulk_upsert(collection: str, records: Sequence[dict[str, Any]]) -> dict[str,
     Args:
         collection: Collection name or ID
         records: List of records (max 1000)
+        transaction: If True, use all-or-nothing semantics (rollback on any failure).
+                     If False (default), partial success is allowed.
 
     Returns:
-        Result with succeeded/failed counts and created record IDs
+        Result with succeeded/failed counts and created record IDs:
+        {
+            "succeeded": 2,
+            "failed": 0,
+            "errors": [],
+            "records": [{"id": "..."}, ...],
+            "rolled_back": false  # only present if transaction=True and failed
+        }
 
     Example:
         >>> result = pb.bulk_upsert("deposits", [
         ...     {"id": "existing_id", "amount": 100},
         ...     {"amount": 200},  # creates new record
         ... ])
+
+        >>> # Use transaction mode for all-or-nothing
+        >>> result = pb.bulk_upsert("deposits", records, transaction=True)
     """
-    return _bulk_upsert_records(collection, records)
+    return _bulk_upsert_records(collection, records, transaction=transaction)
 
 
-def bulk_insert(collection: str, records: Sequence[dict[str, Any]]) -> dict[str, Any]:
+def bulk_insert(
+    collection: str,
+    records: Sequence[dict[str, Any]],
+    *,
+    transaction: bool = False,
+) -> dict[str, Any]:
     """Insert multiple new records.
 
     Args:
         collection: Collection name or ID
         records: List of records to create (max 1000)
+        transaction: If True, use all-or-nothing semantics (rollback on any failure).
+                     If False (default), partial success is allowed.
 
     Returns:
         Result with succeeded/failed counts and created record IDs:
@@ -397,7 +449,8 @@ def bulk_insert(collection: str, records: Sequence[dict[str, Any]]) -> dict[str,
             "succeeded": 2,
             "failed": 0,
             "errors": [],
-            "records": [{"id": "..."}, {"id": "..."}]
+            "records": [{"id": "..."}, {"id": "..."}],
+            "rolled_back": false  # only present if transaction=True and failed
         }
 
     Example:
@@ -407,8 +460,11 @@ def bulk_insert(collection: str, records: Sequence[dict[str, Any]]) -> dict[str,
         ... ])
         >>> for rec in result["records"]:
         ...     print(f"Created: {rec['id']}")
+
+        >>> # Use transaction mode for all-or-nothing
+        >>> result = pb.bulk_insert("deposits", records, transaction=True)
     """
-    return _bulk_insert_records(collection, records)
+    return _bulk_insert_records(collection, records, transaction=transaction)
 
 
 def iter_all(

lumera/sdk.py

@@ -591,12 +591,15 @@ def delete_record(collection_id_or_name: str, record_id: str) -> None:
 def bulk_delete_records(
     collection_id_or_name: str,
     record_ids: Sequence[str],
+    *,
+    transaction: bool = False,
 ) -> dict[str, Any]:
     """Bulk delete records by IDs.
 
     Args:
         collection_id_or_name: Collection name or ID
         record_ids: List of record IDs to delete (max 1000)
+        transaction: If True, use all-or-nothing semantics (rollback on any failure)
 
     Returns:
         Result with succeeded/failed counts and any errors
@@ -607,46 +610,54 @@ def bulk_delete_records(
         raise ValueError("record_ids is required")
 
     path = f"collections/{collection_id_or_name}/records/bulk/delete"
-    result = _api_request("POST", path, json_body={"ids": list(record_ids)})
+    body: dict[str, Any] = {"ids": list(record_ids)}
+    if transaction:
+        body["transaction"] = True
+    result = _api_request("POST", path, json_body=body)
     return result if isinstance(result, dict) else {}
 
 
 def bulk_update_records(
     collection_id_or_name: str,
-    record_ids: Sequence[str],
-    data: Mapping[str, Any],
+    records: Sequence[Mapping[str, Any]],
+    *,
+    transaction: bool = False,
 ) -> dict[str, Any]:
-    """Update multiple records with the same data.
+    """Update multiple records with individual data per record.
 
     Args:
         collection_id_or_name: Collection name or ID
-        record_ids: List of record IDs to update (max 1000)
-        data: Fields to update on all records
+        records: List of records to update (max 1000). Each record must have an 'id' field.
+        transaction: If True, use all-or-nothing semantics (rollback on any failure)
 
     Returns:
         Result with succeeded/failed counts
     """
     if not collection_id_or_name:
         raise ValueError("collection_id_or_name is required")
-    if not record_ids:
-        raise ValueError("record_ids is required")
-    if not data:
-        raise ValueError("data is required")
+    if not records:
+        raise ValueError("records is required")
 
     path = f"collections/{collection_id_or_name}/records/bulk/update"
-    result = _api_request("POST", path, json_body={"ids": list(record_ids), "data": dict(data)})
+    body: dict[str, Any] = {"records": [dict(r) for r in records]}
+    if transaction:
+        body["transaction"] = True
+    result = _api_request("POST", path, json_body=body)
     return result if isinstance(result, dict) else {}
 
 
 def bulk_upsert_records(
     collection_id_or_name: str,
     records: Sequence[Mapping[str, Any]],
+    *,
+    transaction: bool = False,
 ) -> dict[str, Any]:
     """Upsert multiple records (create or update by ID).
 
     Args:
         collection_id_or_name: Collection name or ID
         records: List of records (max 1000). Include 'id' field to update existing.
+        transaction: If True, use all-or-nothing semantics (rollback on any failure)
 
     Returns:
         Result with succeeded/failed counts and created record IDs
@@ -657,19 +668,25 @@ def bulk_upsert_records(
         raise ValueError("records is required")
 
     path = f"collections/{collection_id_or_name}/records/bulk/upsert"
-    result = _api_request("POST", path, json_body={"records": [dict(r) for r in records]})
+    body: dict[str, Any] = {"records": [dict(r) for r in records]}
+    if transaction:
+        body["transaction"] = True
+    result = _api_request("POST", path, json_body=body)
     return result if isinstance(result, dict) else {}
 
 
 def bulk_insert_records(
     collection_id_or_name: str,
     records: Sequence[Mapping[str, Any]],
+    *,
+    transaction: bool = False,
 ) -> dict[str, Any]:
     """Insert multiple new records.
 
     Args:
         collection_id_or_name: Collection name or ID
         records: List of records to create (max 1000)
+        transaction: If True, use all-or-nothing semantics (rollback on any failure)
 
     Returns:
         Result with succeeded/failed counts and created record IDs
@@ -680,7 +697,10 @@ def bulk_insert_records(
         raise ValueError("records is required")
 
     path = f"collections/{collection_id_or_name}/records/bulk/insert"
-    result = _api_request("POST", path, json_body={"records": [dict(r) for r in records]})
+    body: dict[str, Any] = {"records": [dict(r) for r in records]}
+    if transaction:
+        body["transaction"] = True
+    result = _api_request("POST", path, json_body=body)
     return result if isinstance(result, dict) else {}
 
 

{lumera-0.8.3.dist-info → lumera-0.9.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lumera
-Version: 0.8.3
+Version: 0.9.1
 Summary: SDK for building on Lumera platform
 Requires-Python: >=3.11
 Requires-Dist: requests

{lumera-0.8.3.dist-info → lumera-0.9.1.dist-info}/RECORD

@@ -5,11 +5,11 @@ lumera/exceptions.py,sha256=bNsx4iYaroAAGsYxErfELC2B5ZJ3w5lVa1kKdIx5s9g,2173
 lumera/google.py,sha256=zpWW1qSlzLZY5Ip7cGAzrv9sJrQf3JBKH2ODc1cCM_E,1130
 lumera/llm.py,sha256=pUTZK7t3GTK0vfxMI1PJgJwNendyuiJc5MB1pUj2vxE,14412
 lumera/locks.py,sha256=8l_qxb8nrxge7YJ-ApUTJ5MeYpIdxDeEa94Eim9O-YM,6806
-lumera/pb.py,sha256=EZABRPVbrSJ8_9Yh-BLt9cp4omkwo5r10Qs8v7wc1qc,18236
-lumera/sdk.py,sha256=EZVH1FnT7smkvFgT6QjVf4gDnVuktF1w7RZFaeTPgDE,30470
+lumera/pb.py,sha256=fTGjcclIGmXxQsBCDhXVrPyKBkdPJ3DRwNZfICT5X8E,20434
+lumera/sdk.py,sha256=0Q4b0LXbr7Vl0SpstH1IKEZwGek33Jz-4ICMRe_Z60A,31217
 lumera/storage.py,sha256=b0W6JNSGfmhJIcmK3vrATXAwxIr_bfrj-hPuQRVLTYU,8206
 lumera/webhooks.py,sha256=L_Q5YHBJKQNpv7G9Nq0QqlGMRch6x9ptlwu1xD2qwUc,8661
-lumera-0.8.3.dist-info/METADATA,sha256=TRrXqx2Cm1DMVzzg-V3aoe9832IEsnnL13WMOrAriAg,1611
-lumera-0.8.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-lumera-0.8.3.dist-info/top_level.txt,sha256=HgfK4XQkpMTnM2E5iWM4kB711FnYqUY9dglzib3pWlE,7
-lumera-0.8.3.dist-info/RECORD,,
+lumera-0.9.1.dist-info/METADATA,sha256=gbS5AHAHUaw4sh8EHbKKb1ONZnzD2ph-lOidiUv49iE,1611
+lumera-0.9.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+lumera-0.9.1.dist-info/top_level.txt,sha256=HgfK4XQkpMTnM2E5iWM4kB711FnYqUY9dglzib3pWlE,7
+lumera-0.9.1.dist-info/RECORD,,