plugins - added is_empty() to accompany video_bytes() or audio_bytes()

tikuma-lsuhsc · tikuma-lsuhsc · commit 2d6007a229ec · 2026-06-07T22:12:57.000-05:00
diff --git a/src/ffmpegio/plugins/hookspecs.py b/src/ffmpegio/plugins/hookspecs.py
@@ -132,3 +132,13 @@ def device_sink_api() -> tuple[str, dict[str, Callable]]:
 
     Partial definition is OK
     """
+    ...
+
+
+@hookspec(firstresult=True)
+def is_empty(obj: object) -> bool:
+    """True if data blob object has no data
+
+    :param obj: object containing media data
+    """
+    ...
diff --git a/src/ffmpegio/plugins/rawdata_bytes.py b/src/ffmpegio/plugins/rawdata_bytes.py
@@ -172,3 +172,12 @@ def bytes_to_audio(
         }
     except:
         return None
+
+
+@hookimpl
+def is_empty(obj: BytesRawDataBlob) -> bool:
+    """True if data blob object has no data
+
+    :param obj: object containing media data
+    """
+    return not bool(obj["buffer"])
diff --git a/src/ffmpegio/plugins/rawdata_mpl.py b/src/ffmpegio/plugins/rawdata_mpl.py
@@ -43,3 +43,12 @@ def video_bytes(obj: Figure) -> memoryview:
             return io_buf.getvalue()
     except:
         None
+
+
+@hookimpl
+def is_empty(obj: Figure) -> bool:
+    """True if data blob object has no data
+
+    :param obj: object containing media data
+    """
+    return False
diff --git a/src/ffmpegio/plugins/rawdata_numpy.py b/src/ffmpegio/plugins/rawdata_numpy.py
@@ -147,3 +147,12 @@ def bytes_to_audio(
         return x.squeeze() if squeeze else x
     except:
         return None
+
+
+@hookimpl
+def is_empty(obj: bytes) -> bool:
+    """True if data blob object has no data
+
+    :param obj: object containing media data
+    """
+    return not bool(obj)
