unitlab 3.0.1__tar.gz → 3.0.3__tar.gz

{unitlab-3.0.1 → unitlab-3.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: unitlab
-Version: 3.0.1
+Version: 3.0.3
 Summary: Python SDK for the Unitlab.ai data annotation platform
 Project-URL: Homepage, https://unitlab.ai
 Project-URL: Documentation, https://docs.unitlab.ai
@@ -214,6 +214,7 @@ project = client.projects.get("PROJECT_ID")
 project = client.projects.create("Road scenes")
 
 batch = project.upload("./data", fps=2.0)
+tiled_batch = project.upload("./maps")
 
 status = batch.status()
 status = batch.wait(timeout=1800)
@@ -228,6 +229,11 @@ status = queue.wait()
 Completion means `processing == 0`; a completed Batch Queue may still report
 individual failures.
 
+GeoTIFF and whole-slide files are detected automatically. Large tiled files
+upload directly to storage in bounded parts. Tiled processing can take hours,
+so use a longer timeout such as `batch.wait(timeout=25200)` when the next
+operation depends on the generated COG/DZI derivative.
+
 ### Data Units and project lifecycle
 
 ```python
@@ -257,12 +263,18 @@ items = folder.list_items()
 result = client.assets.upload("./images", folder_id=folder.id, tags=["train"])
 asset = result.assets[0]
 
+tiled = client.assets.upload(
+    "./slides",
+    folder_id=folder.id,
+)
+tiled.assets[0].wait()
+
 cloud_folder = client.assets.create_cloud_folder(
     "Incoming",
     "CLOUD_STORAGE_ID",
     prefix="incoming/",
 )
-cloud_folder.sync_cloud()
+cloud_folder.sync_cloud()  # Tiled files are registered as processing Assets.
 ```
 
 ### Datasets and published versions
@@ -398,6 +410,7 @@ unitlab project data-unit PROJECT_ID DATA_UNIT_ID
 unitlab project sources PROJECT_ID
 unitlab project detach-source PROJECT_ID SOURCE_LINK_ID --preview
 unitlab project upload PROJECT_ID --source ./data
+unitlab project upload PROJECT_ID --source ./maps
 unitlab batch-queue list PROJECT_ID
 unitlab batch-queue detail PROJECT_ID BATCH_QUEUE_ID
 unitlab batch-queue status PROJECT_ID BATCH_QUEUE_ID
@@ -412,6 +425,7 @@ unitlab project attach PROJECT_ID --dataset-version DATASET_ID:2
 
 # Assets
 unitlab assets upload ./data --folder "Raw data" --tag incoming
+unitlab assets upload ./slides --folder "Slides"
 
 # Folders
 unitlab folders create "Raw data"

{unitlab-3.0.1 → unitlab-3.0.3}/README.md

@@ -181,6 +181,7 @@ project = client.projects.get("PROJECT_ID")
 project = client.projects.create("Road scenes")
 
 batch = project.upload("./data", fps=2.0)
+tiled_batch = project.upload("./maps")
 
 status = batch.status()
 status = batch.wait(timeout=1800)
@@ -195,6 +196,11 @@ status = queue.wait()
 Completion means `processing == 0`; a completed Batch Queue may still report
 individual failures.
 
+GeoTIFF and whole-slide files are detected automatically. Large tiled files
+upload directly to storage in bounded parts. Tiled processing can take hours,
+so use a longer timeout such as `batch.wait(timeout=25200)` when the next
+operation depends on the generated COG/DZI derivative.
+
 ### Data Units and project lifecycle
 
 ```python
@@ -224,12 +230,18 @@ items = folder.list_items()
 result = client.assets.upload("./images", folder_id=folder.id, tags=["train"])
 asset = result.assets[0]
 
+tiled = client.assets.upload(
+    "./slides",
+    folder_id=folder.id,
+)
+tiled.assets[0].wait()
+
 cloud_folder = client.assets.create_cloud_folder(
     "Incoming",
     "CLOUD_STORAGE_ID",
     prefix="incoming/",
 )
-cloud_folder.sync_cloud()
+cloud_folder.sync_cloud()  # Tiled files are registered as processing Assets.
 ```
 
 ### Datasets and published versions
@@ -365,6 +377,7 @@ unitlab project data-unit PROJECT_ID DATA_UNIT_ID
 unitlab project sources PROJECT_ID
 unitlab project detach-source PROJECT_ID SOURCE_LINK_ID --preview
 unitlab project upload PROJECT_ID --source ./data
+unitlab project upload PROJECT_ID --source ./maps
 unitlab batch-queue list PROJECT_ID
 unitlab batch-queue detail PROJECT_ID BATCH_QUEUE_ID
 unitlab batch-queue status PROJECT_ID BATCH_QUEUE_ID
@@ -379,6 +392,7 @@ unitlab project attach PROJECT_ID --dataset-version DATASET_ID:2
 
 # Assets
 unitlab assets upload ./data --folder "Raw data" --tag incoming
+unitlab assets upload ./slides --folder "Slides"
 
 # Folders
 unitlab folders create "Raw data"

{unitlab-3.0.1 → unitlab-3.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "unitlab"
-version = "3.0.1"
+version = "3.0.3"
 description = "Python SDK for the Unitlab.ai data annotation platform"
 readme = "README.md"
 license = "MIT"

{unitlab-3.0.1 → unitlab-3.0.3}/src/unitlab/__init__.py

@@ -3,6 +3,7 @@ from importlib.metadata import version
 from ._grouping import tiles_from_template
 from .client import UnitlabClient
 from .exceptions import (
+    AmbiguousUploadCompletionError,
     AuthenticationError,
     NetworkError,
     NotFoundError,
@@ -55,6 +56,7 @@ from .types import (
 __version__ = version("unitlab")
 
 __all__ = [
+    "AmbiguousUploadCompletionError",
     "Asset",
     "AssetUploadResult",
     "AttachPreview",