packrat-options {packrat} | R Documentation |
Get and set options for the current packrat-managed project.
get_opts(options = NULL, simplify = TRUE, project = NULL) set_opts(..., project = NULL) opts
options |
A character vector of valid option names. |
simplify |
Boolean; |
project |
The project directory. When in packrat mode, defaults to the current project; otherwise, defaults to the current working directory. |
... |
Entries of the form |
auto.snapshot
: Perform automatic, asynchronous snapshots when running interactively?
(logical; defaults to TRUE
)
use.cache
:
Install packages into a global cache, which is then shared across projects? The
directory to use is read through Sys.getenv("R_PACKRAT_CACHE_DIR")
.
Not yet implemented for Windows.
(logical; defaults to FALSE
)
print.banner.on.startup
:
Print the banner on startup? Can be one of TRUE
(always print),
FALSE
(never print), and 'auto'
(do the right thing)
(defaults to "auto"
)
vcs.ignore.lib
:
Add the packrat private library to your version control system ignore?
(logical; defaults to TRUE
)
vcs.ignore.src
:
Add the packrat private sources to your version control system ignore?
(logical; defaults to FALSE
)
external.packages
:
Packages which should be loaded from the user library. This can be useful for
very large packages which you don't want duplicated across multiple projects,
e.g. BioConductor annotation packages, or for package development scenarios
wherein you want to use e.g. devtools
and roxygen2
for package
development, but do not want your package to depend on these packages.
(character; defaults to Sys.getenv("R_PACKRAT_EXTERNAL_PACKAGES")
)
local.repos
:
Ad-hoc local 'repositories'; i.e., directories containing package sources within
sub-directories.
(character; empty by default)
load.external.packages.on.startup
:
Load any packages specified within external.packages
on startup?
(logical; defaults to TRUE
)
ignored.packages
:
Prevent packrat from tracking certain packages. Dependencies of these packages
will also not be tracked (unless these packages are encountered as dependencies
in a separate context from the ignored package).
(character; empty by default)
quiet.package.installation
:
Emit output during package installation?
(logical; defaults to TRUE
)
snapshot.recommended.packages
:
Should 'recommended' packages discovered in the system library be
snapshotted? See the Priority
field of available.packages()
for more information – 'recommended' packages are those normally bundled
with CRAN releases of R on OS X and Windows, but new releases are also
available on the CRAN server.
(logical; defaults to FALSE
)
## Not run: ## use 'devtools' and 'knitr' from the user library packrat::set_opts(external.packages = c("devtools", "knitr")) ## set local repository packrat::set_opts(local.repos = c("~/projects/R")) ## get the set of 'external packages' packrat::opts$external.packages() ## set the external packages packrat::opts$external.packages(c("devtools", "knitr")) ## End(Not run)