USAGE:(1)

USAGE:(1) 💅

okay bestie, this page lives in section 1 of the User Commands manual, and it's literally the glow-up guide for stac — the command line tool for working with STAC. no cap, it's a whole vibe. 🦋

✨ NAME ✨

Usage: — the command line tool for working with STAC. yes the name is literally "Usage:" with the colon, she's quirky like that, we love her. 👑

🌸 SYNOPSIS 🌸

stac [OPTIONS] COMMAND [ARGS]...

that's the whole shape of it: some options, then a command, then whatever args that command wants. periodt. 💖

🎀 OPTIONS 🎀

• -v, --verbose — turns on verbose mode, aka she starts yapping (affectionately) and tells you everything she's doing. 🔥
• -q, --quiet — quiet mode, which means no output at all. she goes fully silent. lowkey iconic. 💀
• --help — shows you this message and then dips. 👋

🌈 Commands: 🌈

here's the whole crew, no gatekeeping:

• add — add an item to a catalog/collection. 🍓
• add-asset — add an asset to an item or collection.
• add-raster — add the raster extension to an Item. ✨
• copy — copy a STAC Catalog. 🫶
• create-item — creates an item from an asset.
• describe — prints out a list of all catalogs, collections and items in this STAC. the full tea. ☕
• info — display info about a static STAC catalog.
• layout — reformat the layout of a STAC based on templating. 💅
• lint — lint a stac object with stac-check.
• merge — merge items from one STAC into another.
• migrate — migrate a STAC object to the latest version. ⭐
• move-assets — move or copy assets in a STAC catalog to the locations... 🦋
• summary — summarize a STAC collection's contents.
• update-extent — update a STAC collection's extent.
• update-geometry — update an item geometry from an asset footprint.
• validate — validate a stac object. ✅
• version — display version info. 👑

then she hits you with:

Try 'stac --help' for help.

and then, because she's dramatic:

Error: No such option: --version Did you mean --verbose?

not the --version jumpscare 😭 fr fr, there is no --version option here — she will absolutely suggest --verbose instead and leave you on read. use the version command if that's what you were reaching for, bestie. iykyk.

💜 sign-off 💜

and that's the whole page! it was published as part of the User Commands manual set, and the footer reads Usage: stac [OPTIONS] COMMAND ... with the date August 2023 — so go forth and slay your STAC catalogs, you've got this. 🧚✨🎀