stac-io 0.2.8

Input and output (I/O) for the SpatioTemporal Asset Catalog (STAC)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

use crate::Result;
use serde::Serialize;
use stac::{FromJson, SelfHref, ToJson};
use std::{fs::File, io::Read, path::Path};

/// Create a STAC object from JSON.
pub trait FromJsonPath: FromJson + SelfHref {
    /// Reads JSON data from a file.
    ///
    /// # Examples
    ///
    /// ```
    /// use stac::Item;
    /// use stac_io::FromJsonPath;
    ///
    /// let item = Item::from_json_path("examples/simple-item.json").unwrap();
    /// ```
    fn from_json_path(path: impl AsRef<Path>) -> Result<Self> {
        let path = path.as_ref();
        let mut buf = Vec::new();
        let _ = File::open(path)?.read_to_end(&mut buf)?;
        let mut value = Self::from_json_slice(&buf)?;
        value.set_self_href(path.to_string_lossy());
        Ok(value)
    }
}

pub trait ToJsonPath: ToJson {
    /// Writes a value to a path as JSON.
    ///
    /// # Examples
    ///
    /// ```no_run
    /// use stac::Item;
    /// use stac_io::ToJsonPath;
    ///
    /// Item::new("an-id").to_json_path("an-id.json", true).unwrap();
    /// ```
    fn to_json_path(&self, path: impl AsRef<Path>, pretty: bool) -> Result<()> {
        let file = File::create(path)?;
        self.to_json_writer(file, pretty)?;
        Ok(())
    }
}

impl<T: FromJson + SelfHref> FromJsonPath for T {}
impl<T: Serialize> ToJsonPath for T {}

#[cfg(test)]
mod tests {
    use super::FromJsonPath;
    use stac::{Item, SelfHref};

    #[test]
    fn set_href() {
        let item = Item::from_json_path("examples/simple-item.json").unwrap();
        assert!(
            item.self_href()
                .unwrap()
                .ends_with("examples/simple-item.json")
        );
    }
}