reactor(cli)!: major one

Author: gadomski

.github/workflows/ci.yml

@@ -50,7 +50,7 @@ jobs:
           sudo apt-get update
           sudo apt-get install libgdal-dev
       - name: Test
-        run: cargo test -p stac -p stac-cli --all-features
+        run: cargo test -p stac -p stac-duckdb -p stac-cli --all-features -F duckdb/bundled
   test-ubuntu-with-pgstac:
     runs-on: ubuntu-latest
     services:

cli/Cargo.toml

@@ -9,6 +9,7 @@ repository = "https://github.com/stac-utils/stac-rs"
 license = "MIT OR Apache-2.0"
 keywords = ["geospatial", "stac", "metadata", "geo", "raster"]
 categories = ["science", "data-structures"]
+rust-version = "1.75"
 
 [features]
 default = ["gdal", "geoparquet", "pgstac"]
@@ -47,7 +48,6 @@ tokio = { version = "1.23", features = ["macros", "rt-multi-thread"] }
 tokio-stream = "0.1"
 tracing = "0.1"
 tracing-subscriber = "0.3"
-url = "2"
 
 [dev-dependencies]
 assert_cmd = "2"

cli/README.md

@@ -34,18 +34,25 @@ If you need to use [gdal](../core/README.md#gdal) features, install via `cargo i
 **stacrs** provides the following subcommands:
 
 - `stacrs item`: create STAC items and combine them into item collections
-- `stacrs search`: search STAC APIs
-- `stacrs serve`: serve a STAC API
-- `stacrs sort`: sort the fields of STAC items, catalogs, and 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](https://github.com/stac-utils/pgstac) backend)
 - `stacrs translate`: convert STAC values from one format to another
 - `stacrs validate`: validate STAC items, catalogs, and collections using [json-schema](https://json-schema.org/)
 
 Use the `--help` flag to see all available options for the CLI and the subcommands:
 
 ## Features
 
-By default, the CLI builds w/ [GDAL](https://gdal.org) support, and will error if GDAL is not installed on your system.
-If you don't want to use GDAL, you can disable the default features:
+This crate has five features, three of them on by default:
+
+- `duckdb`: experimental support for querying [stac-geoparquet](https://github.com/stac-utils/stac-geoparquet) files using [DuckDB](https://duckdb.org/)
+- `gdal`: read geospatial data from rasters (enabled by default)
+- `geoparquet`: read and write [stac-geoparquet](https://github.com/stac-utils/stac-geoparquet) (enabled by default)
+- `pgstac`: enable a [pgstac](https://github.com/stac-utils/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:
 
 ```shell
 cargo install stac-cli --no-default-features

cli/src/args.rs

@@ -0,0 +1,68 @@
+use super::{Input, Run};
+use crate::{Result, Value};
+use stac::{item::Builder, Asset};
+use std::path::Path;
+use tokio::sync::mpsc::Sender;
+
+/// Arguments for the `item` subcommand.
+#[derive(clap::Args, Debug)]
+pub struct Args {
+    /// The item id or asset href
+    id_or_href: String,
+
+    /// The output file, if not provided the item will be printed to standard output
+    outfile: Option<String>,
+
+    /// The asset's key
+    #[arg(short, long, default_value = "data")]
+    key: String,
+
+    /// Roles to use for the created asset
+    #[arg(short, long = "role", default_values_t = ["data".to_string()])]
+    roles: Vec<String>,
+
+    /// Don't use GDAL to add geospatial metadata to the item
+    #[cfg(feature = "gdal")]
+    #[arg(long)]
+    disable_gdal: bool,
+
+    /// Allow assets to have relative hrefs
+    #[arg(long)]
+    allow_relative_hrefs: bool,
+}
+
+impl Run for Args {
+    async fn run(self, _: Input, _: Sender<Value>) -> Result<Option<Value>> {
+        let (id, href): (Option<String>, Option<String>) = if stac::href_to_url(&self.id_or_href)
+            .is_none()
+            && !Path::new(&self.id_or_href).exists()
+        {
+            (Some(self.id_or_href), None)
+        } else {
+            (None, Some(self.id_or_href))
+        };
+        let id = id
+            .or_else(|| {
+                Path::new(href.as_ref().expect("if id is none, href should exist"))
+                    .file_stem()
+                    .map(|s| s.to_string_lossy().to_string())
+            })
+            .unwrap_or_else(|| "default".to_string());
+        let mut builder = Builder::new(id).canonicalize_paths(!self.allow_relative_hrefs);
+        #[cfg(feature = "gdal")]
+        {
+            builder = builder.enable_gdal(!self.disable_gdal);
+        }
+        if let Some(href) = href {
+            let mut asset = Asset::new(href);
+            asset.roles = self.roles;
+            builder = builder.asset(self.key, asset);
+        }
+        let item = builder.build()?;
+        Ok(Some(stac::Value::from(item).into()))
+    }
+
+    fn take_outfile(&mut self) -> Option<String> {
+        self.outfile.take()
+    }
+}