Update docstring and Add a deprecation warning

Author: Val Brodsky

labelbox/data/annotation_types/data/generic_data_row_data.py

@@ -6,7 +6,7 @@
 
 
 class GenericDataRowData(BaseData, _NoCoercionMixin):
-    """Generic data row data
+    """Generic data row data. This is replacing all other DataType passed into Label
     """
     url: Optional[str] = None
     class_name: Literal["GenericDataRowData"] = "GenericDataRowData"

labelbox/data/annotation_types/label.py

@@ -29,7 +29,7 @@ class Label(pydantic_compat.BaseModel):
     """Container for holding data and annotations
 
     >>> Label(
-    >>>    data = ImageData(url = "http://my-img.jpg"),
+    >>>    data = {'global_key': 'my-data-row-key'} # also accepts uid, external_id as keys
     >>>    annotations = [
     >>>        ObjectAnnotation(
     >>>            value = Point(x = 10, y = 10),
@@ -40,7 +40,8 @@ class Label(pydantic_compat.BaseModel):
 
     Args:
         uid: Optional Label Id in Labelbox
-        data: Data of Label, Image, Video, Text
+        data: Data of Label, Image, Video, Text or dict with a single key uid | global_key | external_id. 
+            Note use of classes as data is deprecated. Use GenericDataRowData or dict with a single key instead.
         annotations: List of Annotations in the label
         extra: additional context
     """
@@ -62,6 +63,10 @@ def is_data_type(data: Union[Dict[str, Any], DataType]) -> bool:
     def validate_data(cls, label):
         if not Label.is_data_type(label.get("data")):
             label["data"]["class_name"] = "GenericDataRowData"
+        else:
+            warnings.warn(
+                f"Using {type(label['data']).__name__} class for label.data is deprecated. "
+                "Use a dict or an instance of GenericDataRowData instead.")
         return label
 
     def object_annotations(self) -> List[ObjectAnnotation]:

tests/unit/test_label_data_type.py

@@ -41,7 +41,8 @@ def test_video_data_type():
         'global_key':
             'https://lb-test-data.s3.us-west-1.amazonaws.com/image-samples/sample-image-1.jpg-BEidMVWRmyXjVCnr',
     }
-    label = Label(data=VideoData(**data))
+    with pytest.warns(UserWarning, match="Use a dict"):
+        label = Label(data=VideoData(**data))
     data = label.data
     assert isinstance(data, VideoData)
     assert data.global_key == 'https://lb-test-data.s3.us-west-1.amazonaws.com/image-samples/sample-image-1.jpg-BEidMVWRmyXjVCnr'