EVOLUTION-MANAGER
Edit File: install_gitlab.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><title>R: Install a package from GitLab</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <link rel="stylesheet" type="text/css" href="R.css" /> </head><body> <table width="100%" summary="page for install_gitlab {remotes}"><tr><td>install_gitlab {remotes}</td><td style="text-align: right;">R Documentation</td></tr></table> <h2>Install a package from GitLab</h2> <h3>Description</h3> <p>This function is vectorised on <code>repo</code> so you can install multiple packages in a single command. Like other remotes the repository will skip installation if <code>force == FALSE</code> (the default) and the remote state has not changed since the previous installation. </p> <h3>Usage</h3> <pre> install_gitlab( repo, subdir = NULL, auth_token = gitlab_pat(quiet), host = "gitlab.com", dependencies = NA, upgrade = c("default", "ask", "always", "never"), force = FALSE, quiet = FALSE, build = TRUE, build_opts = c("--no-resave-data", "--no-manual", "--no-build-vignettes"), build_manual = FALSE, build_vignettes = FALSE, repos = getOption("repos"), type = getOption("pkgType"), ... ) </pre> <h3>Arguments</h3> <table summary="R argblock"> <tr valign="top"><td><code>repo</code></td> <td> <p>Repository address in the format <code style="white-space: pre;">username/repo[@ref]</code>.</p> </td></tr> <tr valign="top"><td><code>subdir</code></td> <td> <p>Subdirectory within repo that contains the R package.</p> </td></tr> <tr valign="top"><td><code>auth_token</code></td> <td> <p>To install from a private repo, generate a personal access token (PAT) with at least read_api scope in <a href="https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html">https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html</a> and supply to this argument. This is safer than using a password because you can easily delete a PAT without affecting any others. Defaults to the GITLAB_PAT environment variable.</p> </td></tr> <tr valign="top"><td><code>host</code></td> <td> <p>GitLab API host to use. Override with your GitLab enterprise hostname, for example, <code>"<PROTOCOL://>gitlab.hostname.com"</code>. The PROTOCOL is required by packrat during RStudio Connect deployment. While <a href="install_gitlab.html">install_gitlab</a> may work without, omitting it generally leads to package restoration errors.</p> </td></tr> <tr valign="top"><td><code>dependencies</code></td> <td> <p>Which dependencies do you want to check? Can be a character vector (selecting from "Depends", "Imports", "LinkingTo", "Suggests", or "Enhances"), or a logical vector. </p> <p><code>TRUE</code> is shorthand for "Depends", "Imports", "LinkingTo" and "Suggests". <code>NA</code> is shorthand for "Depends", "Imports" and "LinkingTo" and is the default. <code>FALSE</code> is shorthand for no dependencies (i.e. just check this package, not its dependencies). </p> <p>The value "soft" means the same as <code>TRUE</code>, "hard" means the same as <code>NA</code>. </p> <p>You can also specify dependencies from one or more additional fields, common ones include: </p> <ul> <li><p> Config/Needs/website - for dependencies used in building the pkgdown site. </p> </li> <li><p> Config/Needs/coverage for dependencies used in calculating test coverage. </p> </li></ul> </td></tr> <tr valign="top"><td><code>upgrade</code></td> <td> <p>Should package dependencies be upgraded? One of "default", "ask", "always", or "never". "default" respects the value of the <code>R_REMOTES_UPGRADE</code> 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". <code>TRUE</code> and <code>FALSE</code> are also accepted and correspond to "always" and "never" respectively.</p> </td></tr> <tr valign="top"><td><code>force</code></td> <td> <p>Force installation, even if the remote state has not changed since the previous install.</p> </td></tr> <tr valign="top"><td><code>quiet</code></td> <td> <p>If <code>TRUE</code>, suppress output.</p> </td></tr> <tr valign="top"><td><code>build</code></td> <td> <p>If <code>TRUE</code> build the package before installing.</p> </td></tr> <tr valign="top"><td><code>build_opts</code></td> <td> <p>Options to pass to <code style="white-space: pre;">R CMD build</code>, only used when <code>build</code> is <code>TRUE</code>.</p> </td></tr> <tr valign="top"><td><code>build_manual</code></td> <td> <p>If <code>FALSE</code>, don't build PDF manual ('–no-manual').</p> </td></tr> <tr valign="top"><td><code>build_vignettes</code></td> <td> <p>If <code>FALSE</code>, don't build package vignettes ('–no-build-vignettes').</p> </td></tr> <tr valign="top"><td><code>repos</code></td> <td> <p>A character vector giving repositories to use.</p> </td></tr> <tr valign="top"><td><code>type</code></td> <td> <p>Type of package to <code>update</code>.</p> </td></tr> <tr valign="top"><td><code>...</code></td> <td> <p>Other arguments passed on to <code><a href="../../utils/html/install.packages.html">utils::install.packages()</a></code>.</p> </td></tr> </table> <h3>See Also</h3> <p>Other package installation: <code><a href="install_bioc.html">install_bioc</a>()</code>, <code><a href="install_bitbucket.html">install_bitbucket</a>()</code>, <code><a href="install_cran.html">install_cran</a>()</code>, <code><a href="install_dev.html">install_dev</a>()</code>, <code><a href="install_github.html">install_github</a>()</code>, <code><a href="install_git.html">install_git</a>()</code>, <code><a href="install_local.html">install_local</a>()</code>, <code><a href="install_svn.html">install_svn</a>()</code>, <code><a href="install_url.html">install_url</a>()</code>, <code><a href="install_version.html">install_version</a>()</code> </p> <h3>Examples</h3> <pre> ## Not run: install_gitlab("jimhester/covr") ## End(Not run) </pre> <hr /><div style="text-align: center;">[Package <em>remotes</em> version 2.4.2 <a href="00Index.html">Index</a>]</div> </body></html>