stac-rs

GitHub Workflow Status docs.rs Crates.io Codecov Crates.io Contributor Covenant

Rust implementation of the SpatioTemporal Asset Catalog (STAC) specification.

Using the library

We are stac on crates.io. To use the library in your project:

toml [dependencies] stac = "0.0.4"

Features

There is one opt-out feature: reqwest. If you'd like to use the library without reqwest:

toml [dependencies] stac = { version = "0.0.4", features = []}

If reqwest is not enabled, Reader::read will throw an error if you try to read from a url.

API

Please see the documentation for usage examples, and the architecture diagram for a visual diagram of the key structures and traits.

Command-line interface

404: Not Found

But there is a tracking issue.

Examples

There is one example at examples/copy.rs that demonstrates a simple read-write operation. To run it from the command line:

shell cargo run --examples copy data/catalog.json tmp

Development

See CONTRIBUTING.md for information about contributing to this project. Use RELEASING.md as an alternate pull request template when releasing a new version.

License

stac-rs is dual-licensed under both the MIT license and the Apache license (Version 2.0). See LICENSE-APACHE and LICENSE-MIT for details.