Explicit snapshot

NEWS.md

@@ -1,5 +1,9 @@
 # renv (development version)
 
+* add `dev` argument to `snapshot` and `status` to be able to capture packages
+  from *Suggests* with `type="explicit"`; this provides an option to have
+  a similar behavior of `renv` as before the update to v1.0.0
+
 # renv 1.0.2
 
 * renv now parses package `NAMESPACE` files for imported dependencies. (#1637)

R/lockfile.R

@@ -176,30 +176,31 @@ renv_lockfile_create <- function(project,
                                  packages = NULL,
                                  exclude = NULL,
                                  prompt = NULL,
-                                 force = NULL)
+                                 force = NULL,
+                                 dev = FALSE)
 {
   libpaths <- libpaths %||% renv_libpaths_all()
   type <- type %||% settings$snapshot.type(project = project)
 
   # use a restart, so we can allow the user to install packages before snapshot
   lockfile <- withRestarts(
-    renv_lockfile_create_impl(project, type, libpaths, packages, exclude, prompt, force),
+    renv_lockfile_create_impl(project, type, libpaths, packages, exclude, prompt, force, dev = dev),
     renv_recompute_records = function() {
       renv_dynamic_reset()
-      renv_lockfile_create_impl(project, type, libpaths, packages, exclude, prompt, force)
+      renv_lockfile_create_impl(project, type, libpaths, packages, exclude, prompt, force, dev = dev)
     }
   )
 }
 
-renv_lockfile_create_impl <- function(project, type, libpaths, packages, exclude, prompt, force) {
+renv_lockfile_create_impl <- function(project, type, libpaths, packages, exclude, prompt, force, dev = FALSE) {
 
   lockfile <- renv_lockfile_init(project)
 
   # compute the project's top-level package dependencies
   packages <- packages %||% renv_snapshot_dependencies(
     project = project,
     type = type,
-    dev = FALSE
+    dev = dev
   )
 
   # expand the recursive dependencies of these packages

R/snapshot.R

@@ -87,10 +87,13 @@ the$auto_snapshot_hash <- TRUE
 #'
 #'   See **Snapshot type** below for more details.
 #'
+#' @inheritParams dependencies
+#'
 #' @param repos The \R repositories to be recorded in the lockfile. Defaults
 #'   to the currently active package repositories, as retrieved by
 #'   `getOption("repos")`.
 #'
+#'
 #' @param packages A vector of packages to be included in the lockfile. When
 #'   `NULL` (the default), all packages relevant for the type of snapshot being
 #'   performed will be included. When set, the `type` argument is ignored.
@@ -113,6 +116,8 @@ the$auto_snapshot_hash <- TRUE
 #' @return The generated lockfile, as an \R object (invisibly). Note that
 #'   this function is normally called for its side effects.
 #'
+#'
+#' @seealso More on handling package [dependencies()]
 #' @family reproducibility
 #'
 #' @export
@@ -123,6 +128,7 @@ snapshot <- function(project  = NULL,
                      library  = NULL,
                      lockfile = paths$lockfile(project = project),
                      type     = settings$snapshot.type(project = project),
+                     dev      = FALSE,
                      repos    = getOption("repos"),
                      packages = NULL,
                      exclude  = NULL,
@@ -171,7 +177,8 @@ snapshot <- function(project  = NULL,
     packages = packages,
     exclude  = exclude,
     prompt   = prompt,
-    force    = force
+    force    = force,
+    dev      = dev
   )
 
   if (is.null(lockfile))

R/status.R

@@ -18,7 +18,7 @@ the$status_running <- FALSE
 #'
 #' # Missing packages
 #'
-#' `status()` first checks that all packages used by the project are installed. 
+#' `status()` first checks that all packages used by the project are installed.
 #' This must be done first because if any packages are missing we can't tell for
 #' sure that a package isn't used; it might be a dependency that we don't know
 #' about. Once you have resolve any installation issues, you'll need to run
@@ -86,6 +86,8 @@ the$status_running <- FALSE
 #'   cache are installed at the expected + proper locations, and validate the
 #'   hashes used for those storage locations.
 #'
+#' @inheritParams dependencies
+#'
 #' @return This function is normally called for its side effects, but
 #'   it invisibly returns a list containing the following components:
 #'
@@ -101,7 +103,8 @@ status <- function(project = NULL,
                    library = NULL,
                    lockfile = NULL,
                    sources = TRUE,
-                   cache = FALSE)
+                   cache = FALSE,
+                   dev = FALSE)
 {
   renv_scope_error_handler()
   renv_dots_check(...)
@@ -129,7 +132,7 @@ status <- function(project = NULL,
   lockpath <- lockfile %||% renv_paths_lockfile(project = project)
 
   # get all dependencies, including transitive
-  dependencies <- renv_snapshot_dependencies(project, dev = FALSE)
+  dependencies <- renv_snapshot_dependencies(project, dev = dev)
   packages <- sort(union(dependencies, "renv"))
   paths <- renv_package_dependencies(packages, libpaths = libpaths, project = project)
   packages <- as.character(names(paths))