Title: Helper Package to Install Packages for R
Version: 0.0.3
Date: 2023-02-24
Description: Helper function to install packages for R using an external 'requirements.txt' or a string containing diverse packages from several resources like Github or CRAN.
License: GPL-3
URL: https://github.com/joundso/requirements
BugReports: https://github.com/joundso/requirements/issues
Depends: R (≥ 4.1.0)
Imports: remotes
Suggests: lintr, testthat
Encoding: UTF-8
Language: en-US
RoxygenNote: 7.2.3
NeedsCompilation: no
Packaged: 2023-02-24 12:23:52 UTC; user
Author: Jonathan M. Mang ORCID iD [aut, cre], MIRACUM - Medical Informatics in Research and Care in University Medicine [fnd], Universitätsklinikum Erlangen [cph]
Maintainer: Jonathan M. Mang <jonathan.mang@uk-erlangen.de>
Repository: CRAN
Date/Publication: 2023-02-24 12:40:02 UTC

Install the packages provided to this function

Description

Install the packages provided to this function

Usage

install(
  packages = NULL,
  path_to_requirements = NULL,
  quiet = TRUE,
  upgrade = "always"
)

Arguments

packages

(Optional, String, also as vector) The actual packages to install.

path_to_requirements

(Optional, String) The path (including filename and type ending) to a text file containing all the packages to install.

quiet

If TRUE, suppress output.

upgrade

Should package dependencies be upgraded? One of "default", "ask", "always", or "never". "default" respects the value of the R_REMOTES_UPGRADE environment variable if set, and falls back to "ask" if unset. "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.

Value

(Boolean) 'TRUE' if all packages are successfully installed, 'FALSE' otherwise.

Examples

## Not run: 
 ## Test it with a string:
 demo_string <- "
 DIZutils
 data.table
 joundso/mainzelliste-connector
 miracum/misc-dizutils@development
 # this_one_will_be_ignored
 "
 requiRements::install(packages = demo_string)

 ## Test it with a vector:
 demo_vec <-
   c(
     "",
     "DIZutils",
     "data.table",
     "joundso/mainzelliste-connector",
     "miracum/misc-dizutils@development",
     "# this_one_will_be_ignored"
   )
 requiRements::install(packages = demo_vec)

 ## Test it with a file:
 demo_path <- "./data-raw/requirements.txt"
 requiRements::install(path_to_requirements = demo_path)

 ## Test it with a string AND a file:
 requiRements::install(packages = demo_string,
                       path_to_requirements = demo_path)

 ## Test it with a vector AND a file:
 requiRements::install(packages = demo_vec,
                       path_to_requirements = demo_path)

## End(Not run)