Enum Format

pub enum Format {
    Json(bool),
    NdJson,
}

The format of STAC data.

Variants

Json(bool)

JSON data (the default).

If true, the data will be pretty-printed on write.

NdJson

Newline-delimited JSON.

Implementations

impl Format

pub fn infer_from_href(href: &str) -> Option<Format>

Infer the format from a file extension.

Examples

use stac_io::Format;

assert_eq!(Format::Json(false), Format::infer_from_href("item.json").unwrap());

pub fn extension(&self) -> &'static str

Returns this format’s file extension.

Examples

use stac_io::Format;
assert_eq!(Format::json().extension(), "json");
assert_eq!(Format::ndjson().extension(), "ndjson");
#[cfg(feature = "geoparquet")]
assert_eq!(Format::geoparquet().extension(), "parquet");

pub fn read<T: Readable + SelfHref>(&self, href: impl ToString) -> Result<T>

Reads a STAC object from an href in this format.

Examples

use stac::Item;
use stac_io::Format;

let item: Item = Format::json().read("examples/simple-item.json").unwrap();

pub fn from_path<T: Readable + SelfHref>( &self, path: impl AsRef<Path>, ) -> Result<T>

Reads a local file in the given format.

Examples

use stac::Item;
use stac_io::Format;

let item: Item = Format::json().from_path("examples/simple-item.json").unwrap();

pub fn from_bytes<T: Readable>(&self, bytes: impl Into<Bytes>) -> Result<T>

Reads a STAC object from some bytes.

Examples

use stac::Item;
use stac_io::Format;
use std::{io::Read, fs::File};

let mut buf = Vec::new();
File::open("examples/simple-item.json").unwrap().read_to_end(&mut buf).unwrap();
let item: Item = Format::json().from_bytes(buf).unwrap();

pub fn write<T: Writeable>( &self, path: impl AsRef<Path>, value: T, ) -> Result<()>

Writes a STAC value to the provided path.

Examples

use stac::Item;
use stac_io::Format;

Format::json().write("an-id.json", Item::new("an-id")).unwrap();

pub fn into_vec<T: Writeable>(&self, value: T) -> Result<Vec<u8>>

Converts a STAC object into some bytes.

Examples

use stac::Item;
use stac_io::Format;

let item = Item::new("an-id");
let bytes = Format::json().into_vec(item).unwrap();

pub fn json() -> Format

Returns the default JSON format (compact).

pub fn ndjson() -> Format

Returns the newline-delimited JSON format.

Trait Implementations

impl Clone for Format

fn clone(&self) -> Format

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Format

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Format

fn default() -> Self

Returns the “default value” for a type.

impl Display for Format

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromStr for Format

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Format>

Parses a string s to return a value of this type.

impl PartialEq for Format

fn eq(&self, other: &Format) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Format

impl StructuralPartialEq for Format