Added ability to upload annotations for Multimodal projects.

Author: VaghinakDev

src/superannotate/lib/app/interface/sdk_interface.py

@@ -1965,6 +1965,31 @@ def upload_annotations(
                "skipped": []
             }
 
+        Example Usage with JSONL Upload:
+        ::
+            import json
+            from pathlib import Path
+            from superannotate import SAClient
+
+            # Assuming annotations are stored in JSONL format
+            annotations_path = Path("annotations.jsonl")
+            annotations = []
+
+            # Reading the JSONL file and converting it into a list of dictionaries
+            with annotations_path.open("r", encoding="utf-8") as f:
+                for line in f:
+                    annotations.append(json.loads(line))
+
+            # Initialize the Superannotate client
+            sa = SAClient()
+
+            # Call the upload_annotations function
+            response = client.upload_annotations(
+                project="project1/folder1",
+                annotations=annotations,
+                keep_status=True
+            )
+
         """
         if keep_status is not None:
             warnings.warn(

src/superannotate/lib/core/entities/__init__.py

@@ -12,6 +12,7 @@
 from lib.core.entities.items import TiledEntity
 from lib.core.entities.items import VideoEntity
 from lib.core.entities.project import AttachmentEntity
+from lib.core.entities.project import CategoryEntity
 from lib.core.entities.project import ContributorEntity
 from lib.core.entities.project import ProjectEntity
 from lib.core.entities.project import SettingEntity
@@ -41,6 +42,7 @@
     # project
     "ProjectEntity",
     "WorkflowEntity",
+    "CategoryEntity",
     "ContributorEntity",
     "ConfigEntity",
     "StepEntity",

src/superannotate/lib/core/entities/project.py

@@ -179,3 +179,8 @@ def is_system(self):
 
     class Config:
         extra = Extra.ignore
+
+
+class CategoryEntity(BaseModel):
+    id: Optional[int]
+    name: Optional[str]

src/superannotate/lib/core/serviceproviders.py

@@ -9,6 +9,7 @@
 
 from lib.core import entities
 from lib.core.conditions import Condition
+from lib.core.entities import CategoryEntity
 from lib.core.jsx_conditions import Query
 from lib.core.reporter import Reporter
 from lib.core.service_types import AnnotationClassListResponse
@@ -87,6 +88,16 @@ def list_workflow_statuses(self, project_id: int, workflow_id: int):
     def list_workflow_roles(self, project_id: int, workflow_id: int):
         raise NotImplementedError
 
+    @abstractmethod
+    def list_project_categories(self, project_id: int) -> List[entities.CategoryEntity]:
+        raise NotImplementedError
+
+    @abstractmethod
+    def create_project_categories(
+        self, project_id: int, categories: List[CategoryEntity]
+    ):
+        raise NotImplementedError
+
 
 class BaseProjectService(SuperannotateServiceProvider):
     @abstractmethod