implemented TextSelection.test_data() and TextSelections.test_data()

Using these new methods is more efficient than doing .annotations().test_data()

src/textselection.rs

@@ -314,6 +314,17 @@ impl PyTextSelection {
         })
     }
 
+    #[pyo3(signature = (**kwargs))]
+    fn test_data(&self, kwargs: Option<&PyDict>) -> PyResult<bool> {
+        let iterparams = IterParams::new(kwargs)?;
+        self.map(|textselection| {
+            let iter = textselection.annotations().data_unchecked();
+            Ok(iterparams
+                .evaluate_data(iter, textselection.rootstore())?
+                .test())
+        })
+    }
+
     #[pyo3(signature = (operator, **kwargs))]
     fn related_text(
         &self,
@@ -538,6 +549,20 @@ impl PyTextSelections {
         })
     }
 
+    #[pyo3(signature = (**kwargs))]
+    fn test_data(&self, kwargs: Option<&PyDict>) -> PyResult<bool> {
+        let iterparams = IterParams::new(kwargs)?;
+        self.map(|textselections, store| {
+            let iter = stam::TextSelectionsIter::from_handles(
+                textselections.iter().copied().collect(), //MAYBE TODO: work away the extra copy
+                store,
+            )
+            .annotations_unchecked()
+            .data_unchecked();
+            Ok(iterparams.evaluate_data(iter, store)?.test())
+        })
+    }
+
     #[pyo3(signature = (operator, **kwargs))]
     fn related_text(
         &self,

stam.pyi

@@ -778,6 +778,14 @@ class TextSelections:
         The annotations can be filtered using keyword arguments. See :meth:`Annotation.annotations`.
        """
 
+    def test_data(self, **kwargs) -> bool:
+        """
+        Tests whether there are any annotations that reference any of the text selections in the iterator, with data that passes the provided filters.
+        The result is functionally equivalent to doing `.annotations().test_data()`, but this shortcut method is implemented much more efficiently and therefore recommended.
+
+        The data can be filtered using keyword arguments. See :meth:`Annotations.data`.
+        """
+
     def related_text(self, operator: TextSelectionOperator, **kwargs) -> TextSelections:
         """
         Applies a :class:`TextSelectionOperator` to find all other
@@ -1321,6 +1329,14 @@ class TextSelection:
         The annotations can be filtered using keyword arguments. See :meth:`Annotation.annotations`.
        """
 
+    def test_data(self, **kwargs) -> bool:
+        """
+        Tests whether there are any annotations that reference this text selection with data that passes the provided filters.
+        The result is functionally equivalent to doing `.annotations().test_data()`, but this shortcut method is implemented much more efficiently and therefore recommended.
+
+        The data can be filtered using keyword arguments. See :meth:`Annotations.data`.
+        """
+
     def related_text(self, operator: TextSelectionOperator, **kwargs) -> TextSelections:
         """
         Applies a :class:`TextSelectionOperator` to find all other