feat: add matches_cql2 (#909)

This might be nice to expose to the CLI later, but for now we'll just
add the method.

cc @bitner, this was pretty easy!

Closes #567

Author: gadomski

crates/core/src/item.rs

@@ -2,6 +2,7 @@
 
 use crate::{Asset, Assets, Bbox, Error, Fields, Link, Result, STAC_VERSION, Version};
 use chrono::{DateTime, FixedOffset, NaiveDateTime, Utc};
+use cql2::Expr;
 use geojson::{Feature, Geometry, feature::Id};
 use indexmap::IndexMap;
 use serde::{Deserialize, Deserializer, Serialize};
@@ -602,6 +603,22 @@ impl Item {
             properties,
         })
     }
+
+    /// Returns true if this item matches the given CQL2 expression.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// use stac::Item;
+    ///
+    /// let item = Item::new("an-item");
+    /// assert!(item.clone().matches_cql2("id = 'an-item'".parse().unwrap()).unwrap());
+    /// assert!(!item.matches_cql2("id = 'another-item'".parse().unwrap()).unwrap());
+    /// ```
+    pub fn matches_cql2(self, expr: Expr) -> Result<bool> {
+        let result = self.into_flat_item(true)?.matches_cql2(expr)?;
+        Ok(result)
+    }
 }
 
 impl Assets for Item {
@@ -685,6 +702,15 @@ impl TryFrom<Item> for Feature {
     }
 }
 
+impl FlatItem {
+    /// Returns true if the item matches the given CQL2 expression.
+    pub fn matches_cql2(self, expr: Expr) -> Result<bool> {
+        let value = serde_json::to_value(self)?;
+        let result = expr.matches(Some(&value)).map_err(Box::new)?;
+        Ok(result)
+    }
+}
+
 fn default_stac_version() -> Version {
     STAC_VERSION
 }
@@ -945,4 +971,19 @@ mod tests {
     fn read_invalid_item_datetimes() {
         let _: Item = crate::read("data/invalid-datetimes.json").unwrap();
     }
+
+    #[test]
+    fn matches_cql2() {
+        let item = Item::new("an-item");
+        assert!(
+            item.clone()
+                .matches_cql2("id = 'an-item'".parse().unwrap())
+                .unwrap()
+        );
+        assert!(
+            !item
+                .matches_cql2("id = 'another-item'".parse().unwrap())
+                .unwrap()
+        );
+    }
 }