14 releases (4 breaking)

0.4.1 Oct 22, 2024
0.3.1 Sep 6, 2024
0.1.0 Apr 29, 2024
0.0.6 Oct 18, 2023
0.0.1 May 20, 2022

#614 in Science

MIT/Apache

2MB
9K SLoC

stac-cli

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

Command Line Interface (CLI) for STAC, named stacrs.

Installation

python -m pip install stacrs-cli

Or:

cargo install stac-cli

Then:

stacrs --help

Usage

stacrs provides the following subcommands:

  • stacrs item: create STAC items and combine them into item collections
  • stacrs migrate: migrate a STAC object to another version
  • stacrs search: search STAC APIs (and geoparquet, with the experimental duckdb feature)
  • stacrs serve: serve a STAC API (optionally, with a pgstac backend)
  • stacrs translate: convert STAC values from one format to another
  • stacrs validate: validate STAC items, catalogs, and collections using json-schema

Use the --help flag to see all available options for the CLI and the subcommands:

Features

This crate has features:

  • duckdb: experimental support for querying stac-geoparquet files using DuckDB
  • geoparquet: read and write stac-geoparquet (enabled by default)
  • pgstac: enable a pgstac backend for stacrs serve (enabled by default)
  • python: create an entrypoint that can be called from Python (used to enable python -m pip install stacrs-cli)

If you don't want to use any of the default features:

cargo install stac-cli --no-default-features

Other info

This crate is part of the stac-rs monorepo, see its README for contributing and license information.

Dependencies

~109MB
~2M SLoC