blob: b071377ecd3517426321407c1cf66e3ced30e191 (
about) (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
\name{guix.install}
\alias{guix.install}
\encoding{UTF-8}
\title{guix.install}
\description{
This procedure installs a given package with Guix. If the package is
available in any enabled Guix channel, the package and its
dependencies will be installed from there.
If the package is not available in Guix the procedure attempts to
generate a package definition by recursively importing metadata from
CRAN, Bioconductor, or a git/mercurial repository. Upon successful
generation of package definitions in \code{~/.Rguix/packages.scm} the
package is installed with Guix.
The file \code{~/.Rguix/packages.scm} is only appended to for
reproducibility reasons. Each entry has a comment with a timestamp
for convenience. The package definitions in that file could be
upstreamed to a Guix channel to make it easier for others to reproduce
the environment. Consider sending package definitions to either the
\href{https://guix.gnu.org/en/contribute/}{Guix project} or the
\href{https://github.com/guix-science/guix-science}{Guix Science project}.
}
\usage{
guix.install(package, profile = NULL, guix = "guix", archive = NULL)
}
\arguments{
\item{package}{
The name of the R package to be installed as used on CRAN or
Bioconductor, or a HTTP URL of a git repository holding an R
package.
}
\item{profile}{
The target Guix profile where the package should be installed. By
default this is the default Guix profile at
\code{$HOME/.guix-profile}.
}
\item{guix}{
The absolute file name of the \code{guix} executable. By default
this is just \code{guix} and will be searched on the user's \code{PATH}.
}
\item{archive}{
This argument is used to override the Guix importer's \code{archive}
option, e.g. to explicitly specify that the package should be imported
from Bioconductor or from a Mercurial repository.
}
}
\value{
This procedure is run for its side-effects.
}
\author{
Ricardo Wurmus, \email{ricardo.wurmus@mdc-berlin.de}
}
\examples{
\dontrun{
guix.install("methylKit")
guix.install("methylKit", profile="/home/foo/custom/.guix-profile")
guix.install("methylKit", guix="/gnu/remote/bin/guix")
}
}
\keyword{ utilities }
\concept{ package management }
\concept{ reproducibility }
|