R: Find all dependencies of a CRAN or dev package.

package_deps {remotes} | R Documentation

## Find all dependencies of a CRAN or dev package.

### Description

Find all the dependencies of a package and determine whether they are ahead or behind CRAN. A `print()` method identifies mismatches (if any) between local and CRAN versions of each dependent package; an `update()` method installs outdated or missing packages from CRAN.

### Usage

    package_deps(packages, dependencies = NA, repos = getOption("repos"),
      type = getOption("pkgType"))

    local_package_deps(pkgdir = ".", dependencies = NA)

    dev_package_deps(pkgdir = ".", dependencies = NA,
      repos = getOption("repos"), type = getOption("pkgType"), ...)

    ## S3 method for class 'package_deps'
    update(object, dependencies = NA,
      upgrade = c("ask", "always", "never"), force = FALSE,
      quiet = FALSE, build = TRUE, build_opts = c("--no-resave-data",
      "--no-manual", "--no-build-vignettes"), repos = getOption("repos"),
      type = getOption("pkgType"), ...)

### Arguments

`packages` | A character vector of package names.
`dependencies` | Which dependencies do you want to check? Can be a character vector (selecting from "Depends", "Imports", "LinkingTo", "Suggests", or "Enhances"), or a logical vector. `TRUE` is shorthand for "Depends", "Imports", "LinkingTo" and "Suggests". `NA` is shorthand for "Depends", "Imports" and "LinkingTo" and is the default. `FALSE` is shorthand for no dependencies (i.e. just check this package, not its dependencies).
`repos` | A character vector giving repositories to use.
`type` | Type of package to `update`.
`pkgdir` | path to a package directory, or to a package tarball.
`...` | Additional arguments passed to `install_packages`.
`object` | A `package_deps` object.
`upgrade` | One of "ask", "always" or "never". "ask" prompts the user for which out of date packages to upgrade. For non-interactive sessions "ask" is equivalent to "always". `TRUE` and `FALSE` are also accepted and correspond to "always" and "never" respectively.
`force` | Force installation, even if the remote state has not changed since the previous install.
`quiet` | If `TRUE`, suppress output.
`build` | If `TRUE` build the package before installing.
`build_opts` | Options to pass to `R CMD build`, only used when `build` is `TRUE`.

### Value

A `data.frame` with columns:

`package` | The dependent package's name,
`installed` | The currently installed version,
`available` | The version available on CRAN,
`diff` | An integer denoting whether the locally installed version of the package is newer (1), the same (0) or older (-1) than the version currently available on CRAN.

### Examples

    ## Not run:
    package_deps("devtools")
    # Use update to update any out-of-date dependencies
    update(package_deps("devtools"))

    ## End(Not run)

[Package remotes version 2.0.1 Index]