Skip to main content

A STAC command-line interface written in Rust

Project description

stac-cli

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

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

Installation

cargo install stac-cli

Or:

# NOTE: The version from PyPI does not include GDAL or DuckDB support. If you
# need to use these features, install via `cargo install` (GDAL is enabled by
# default) or `cargo install -F duckdb` (DuckDB is not).
pip install stacrs-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 five features, three of them on by default:

  • duckdb: experimental support for querying stac-geoparquet files using DuckDB
  • gdal: read geospatial data from rasters (enabled by default)
  • 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 pip install stacrs-cli)

If you don't want to use GDAL or any of the other 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stacrs_cli-0.4.0.tar.gz (1.5 MB view hashes)

Uploaded Source

Built Distributions

stacrs_cli-0.4.0-cp312-none-win_amd64.whl (10.8 MB view hashes)

Uploaded CPython 3.12 Windows x86-64

stacrs_cli-0.4.0-cp312-none-win32.whl (9.7 MB view hashes)

Uploaded CPython 3.12 Windows x86

stacrs_cli-0.4.0-cp312-cp312-manylinux_2_34_x86_64.whl (15.0 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.34+ x86-64

stacrs_cli-0.4.0-cp312-cp312-macosx_11_0_arm64.whl (11.0 MB view hashes)

Uploaded CPython 3.12 macOS 11.0+ ARM64

stacrs_cli-0.4.0-cp312-cp312-macosx_10_12_x86_64.whl (11.5 MB view hashes)

Uploaded CPython 3.12 macOS 10.12+ x86-64

stacrs_cli-0.4.0-cp311-none-win_amd64.whl (10.8 MB view hashes)

Uploaded CPython 3.11 Windows x86-64

stacrs_cli-0.4.0-cp311-none-win32.whl (9.7 MB view hashes)

Uploaded CPython 3.11 Windows x86

stacrs_cli-0.4.0-cp311-cp311-macosx_11_0_arm64.whl (11.0 MB view hashes)

Uploaded CPython 3.11 macOS 11.0+ ARM64

stacrs_cli-0.4.0-cp311-cp311-macosx_10_12_x86_64.whl (11.5 MB view hashes)

Uploaded CPython 3.11 macOS 10.12+ x86-64

stacrs_cli-0.4.0-cp310-none-win_amd64.whl (10.8 MB view hashes)

Uploaded CPython 3.10 Windows x86-64

stacrs_cli-0.4.0-cp310-none-win32.whl (9.7 MB view hashes)

Uploaded CPython 3.10 Windows x86

stacrs_cli-0.4.0-cp310-cp310-manylinux_2_34_x86_64.whl (15.0 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.34+ x86-64

stacrs_cli-0.4.0-cp310-cp310-macosx_11_0_arm64.whl (11.0 MB view hashes)

Uploaded CPython 3.10 macOS 11.0+ ARM64

stacrs_cli-0.4.0-cp39-none-win_amd64.whl (10.8 MB view hashes)

Uploaded CPython 3.9 Windows x86-64

stacrs_cli-0.4.0-cp39-none-win32.whl (9.7 MB view hashes)

Uploaded CPython 3.9 Windows x86

stacrs_cli-0.4.0-cp39-cp39-macosx_11_0_arm64.whl (11.0 MB view hashes)

Uploaded CPython 3.9 macOS 11.0+ ARM64

stacrs_cli-0.4.0-cp38-none-win_amd64.whl (10.8 MB view hashes)

Uploaded CPython 3.8 Windows x86-64

stacrs_cli-0.4.0-cp38-none-win32.whl (9.7 MB view hashes)

Uploaded CPython 3.8 Windows x86

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft Sir Raditya Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page