expose and document new option bspm.weak.deps

R/bridge.R

@@ -76,8 +76,11 @@ root_call <- function(method, pkgs, sudo=NULL) {
 
   cmd <- system.file("service/bspm.py", package="bspm")
   args <- c(method, "-o", tmp)
-  if (!missing(pkgs))
+  if (!missing(pkgs)) {
+    if (!is.null(weak.deps <- getOption("bspm.weak.deps", NULL)))
+      args <- c(args, paste0("--", if (!weak.deps) "no-", "weak-deps"))
     args <- c(args, pkgs)
+  }
   if (!is.null(sudo)) {
     args <- c(cmd, args)
     cmd <- sudo
@@ -107,9 +110,13 @@ dbus_call <- function(method, pkgs) {
 
   cmd <- Sys.which("busctl")
   args <- c("call", "--timeout=1h", BUS_NAME, OPATH, IFACE, method)
-  if (!missing(pkgs))
-    args <- c(args, "ias", Sys.getpid(), length(pkgs), pkgs)
-  else args <- c(args, "i", Sys.getpid())
+  if (missing(pkgs)) {
+    args <- c(args, "i", Sys.getpid())
+  } else {
+    weak.deps <- getOption("bspm.weak.deps", NULL)
+    sign <- paste0("ias", if (!is.null(weak.deps)) "b")
+    args <- c(args, sign, Sys.getpid(), length(pkgs), pkgs, weak.deps)
+  }
   out <- system2nowarn(cmd, args, stdout=TRUE, stderr=TRUE)
 
   if (!length(out))

R/integration.R

@@ -27,7 +27,7 @@
 #' \emph{fast} mode can be enabled via \code{options(bspm.version.check=FALSE)},
 #' (true by default) which completely skips version checking.
 #'
-#' @seealso \code{\link{manager}}
+#' @seealso \code{\link{manager}}, \code{\link{bspm-options}}
 #'
 #' @examples
 #' \dontrun{

R/options.R

@@ -1,6 +1,7 @@
 #' Package Options
 #'
 #' List of \code{\link{options}()} supported to configure \pkg{bspm}'s behavior.
+#' In general, these should be set \emph{before} calling any package function.
 #'
 #' @section Options specific to \pkg{bspm}:
 #' \describe{
@@ -9,6 +10,10 @@
 #' \item{\code{bspm.version.check}:}{logical, default \code{TRUE}. If false,
 #'   as many binaries are installed as possible without any version check,
 #'   and then installation from source is used as a fallback.}
+#' \item{\code{bspm.weak.deps}:}{logical, default \code{NULL}, i.e. does not
+#'   change the system's default. If true (or false=, it forces the installation
+#'   (or avoids the installation) of weak dependencies (i.e. recommended or
+#'   suggested packages).}
 #' \item{\code{bspm.sudo.autodetect}:}{logical, default \code{FALSE}. If true,
 #'   enables autodetection and selection of password-less \code{sudo}.}
 #' \item{\code{bspm.sudo}:}{logical, default \code{FALSE}. If true, forces