Merge pull request #167 from rolfsimoes/dev

Pre-release

DESCRIPTION

@@ -88,4 +88,3 @@ Collate:
     'rstac.R'
     'rstac-funs.R'
 Roxygen: list(markdown = TRUE)
-VignetteBuilder: knitr

NEWS.md

@@ -1,5 +1,12 @@
 # rstac (development version)
 
+# rstac 1.0.1 (Released 2024-07-18)
+
+* Add support to `jpg` in `preview_plot()` function (#161)
+* Fix variable in filter expressions (non-standard evaluation) (#160)
+* Fix `limit` parameter as integer type in `stac_search()` and `items()`
+* Improve `items_reap()` documentation (#152)
+
 # rstac 1.0.0 (Released 2024-02-14)
 
 * Add support to static catalogs;

R/assets-funs.R

@@ -91,7 +91,10 @@
 #' Multiple expressions are combine with `AND` operator. Expressions can
 #' use `asset` helper functions (i.e. `asset_key()`, `asset_eo_bands()`,
 #' and `asset_raster_bands()`). Multiple expressions are combined with
-#' `AND` operator.
+#' `AND` operator. `assets_select()` uses non-standard evaluation to evaluate
+#' its expressions. That means users must escape any variable or call to
+#' be able to use them in the expressions. The escape is done by using
+#' `double-curly-braces`, i.e., `{{variable}}`.
 #'
 #' **WARNING:** Errors in the evaluation of expressions are
 #' considered as `FALSE`.

R/ext_filter.R

@@ -36,6 +36,12 @@
 #' to CQL2 expressions. The following topics describe the correspondences
 #' between `rstac` expressions and CQL2 operators.
 #'
+#' ## Non-standard evaluation
+#' - `ext_filter()` uses non-standard evaluation to evaluate its expressions.
+#'   That means users must escape any variable or call to be able to use them
+#'   in the expressions. The escape is done by using `double-curly-braces`,
+#'   i.e., `{{variable}}`.
+#'
 #' ## Standard comparison operators
 #' - `==`, `>=`, `<=`, `>`, `<`, and `!=` operators correspond to
 #'   `=`, `>=`, `<=`, `>`, `<`, and `<>` in CQL2, respectively.

R/items-funs.R

@@ -95,8 +95,15 @@
 #' methods, such as [add_headers][httr::add_headers] or
 #' [set_cookies][httr::set_cookies].
 #'
-#' \item `items_filter()`: ellipsis is used to pass logical
-#' expressions to be evaluated against a `doc_item` field as filter criteria.
+#' \item `items_filter()`: ellipsis is used to pass logical expressions to
+#' be evaluated against a `doc_item` field as filter criteria. Expressions
+#' must be evaluated as a logical value where `TRUE` selects the item
+#' and `FALSE` discards it. Multiple expressions are combine with `AND`
+#' operator. `items_filter()` uses non-standard evaluation to evaluate
+#' its expressions. That means users must escape any variable or call to
+#' be able to use them in the expressions. The escape is done by using
+#' `double-curly-braces`, i.e., `{{variable}}`.
+
 #'
 #' **WARNING:** the evaluation of filter expressions changed in `rstac` 0.9.2.
 #' Older versions of `rstac` used `properties` field to evaluate filter

R/parse-utils.R

@@ -45,9 +45,8 @@
 .parse_limit <- function(limit) {
   if (length(limit) != 1)
     .error("Parameter `limit` must be a single value.")
-  limit <- as.character(limit)
-  limit_int <- suppressWarnings(as.integer(limit))
-  if (any(is.na(as.integer(limit))) || as.character(limit_int) != limit)
+  limit <- suppressWarnings(as.integer(limit))
+  if (is.na(limit))
     .error("Param `limit` must be an integer.")
   return(limit)
 }