Add ragged_batches to mock model, fix test paths, minor docs

Author: CharlesCNorton

fiftyone/utils/qwen3_vl.py

@@ -421,8 +421,9 @@ def embed(self, arg):
         """Generate embedding for a single image or video.
 
         Args:
-            arg: a PIL image, numpy array, torch tensor, or an open
-                ``eta.core.video.FFmpegVideoReader``
+            arg: a PIL image, numpy array, torch tensor, or an active
+                (entered) ``eta.core.video.FFmpegVideoReader`` context
+                manager
 
         Returns:
             a 1D numpy array embedding

tests/unittests/utils/test_qwen3_vl.py

@@ -476,6 +476,10 @@ def has_embeddings(self):
             def embed(self, arg):
                 return np.random.randn(8).astype(np.float32)
 
+            @property
+            def ragged_batches(self):
+                return True
+
             def __enter__(self):
                 return self
 
@@ -490,7 +494,7 @@ def test_mode_none_video_dataset(self):
         ds = fo.Dataset()
         ds.media_type = "video"
         ds.add_sample(fo.Sample(
-            filepath="C:/Users/cnort/Videos/Captures/Counter-Strike 2 2023-10-03 12-54-09.mp4"
+            filepath="/tmp/test_video.mp4"
         ))
         ds.compute_embeddings(model, embeddings_field="emb")
         assert ds.has_sample_field("emb")
@@ -505,7 +509,7 @@ def test_explicit_image_not_overridden(self):
         ds = fo.Dataset()
         ds.media_type = "video"
         ds.add_sample(fo.Sample(
-            filepath="C:/Users/cnort/Videos/Captures/Counter-Strike 2 2023-10-03 12-54-09.mp4"
+            filepath="/tmp/test_video.mp4"
         ))
         ds.compute_embeddings(model, embeddings_field="emb")
         assert ds.has_frame_field("emb")
@@ -531,5 +535,16 @@ def test_mode_none_image_dataset(self):
         os.remove(tmp)
 
 
+class TestQwen3VLVideoConfig:
+    """Test video-specific config defaults"""
+
+    def test_video_fps_default(self):
+        """Test default video_fps is 2.0"""
+        from fiftyone.utils.qwen3_vl import Qwen3VLModelConfig
+
+        config = Qwen3VLModelConfig({})
+        assert config.video_fps == 2.0
+
+
 if __name__ == "__main__":
     pytest.main([__file__, "-v"])