rig repos

Manage the R package repositories that rig configures for your R installations.

rig sets up the repositories R uses to install packages (the repos option in R), typically a CRAN mirror and the Posit Public Package Manager (P3M). These are configured per R version, and you can control them when installing R (see the --with-repos and --without-repos options of rig add) or afterwards with the subcommands here.

rig repos setup (re)configures the repositories for one or all R versions. rig repos list shows the repositories currently configured for an R version. rig repos available lists the repositories rig knows about and can set up. rig repos package-list lists the packages available from the configured repositories.

Subcommands

available: List available R package repositories
list: List configured R package repositories
package-info: Information about the package in the repositories
package-list: List packages in R package repositories
package-versions: List all versions of a package in the repositories
setup: Set up R package repositories

`rig repos available`

List the package repositories that rig knows about and can set up.

These are the repositories you can enable with --with-repos when running rig add or rig repos setup.

Usage

rig repos available [OPTIONS]

Options

--admin: Run in admin mode (overrides RIG_MODE and config)
-h, --help: Print help (see a summary with ‘-h’)
--json: JSON output
--user: Run in user mode (overrides RIG_MODE and config)

`rig repos list`

List the package repositories configured for an R version.

By default rig shows the repositories of the default R version; use --r-version to pick another. Add --all to include repositories that are not enabled by default, and --raw to show repository URLs without resolving the % variables in them.

Usage

rig repos list [OPTIONS]

Options

--admin: Run in admin mode (overrides RIG_MODE and config)
--all: Show all repositories, not just the default ones
-h, --help: Print help (see a summary with ‘-h’)
--json: JSON output
-r, --r-version <r-version>: R version to list repositories for, instead of the default
--raw: Do not resolve % variables in repository URLs.
--user: Run in user mode (overrides RIG_MODE and config)

`rig repos package-info`

Show information about a package in the configured repositories.

By default the latest available version is shown; use --version to select a specific one.

Usage

rig repos package-info [OPTIONS] <package>

Arguments

<package>: package to show

Options

--admin: Run in admin mode (overrides RIG_MODE and config)
-h, --help: Print help (see a summary with ‘-h’)
--json: JSON output
--user: Run in user mode (overrides RIG_MODE and config)
-v, --version <version>: package version to show (default: latest)

`rig repos package-list`

List the packages available from the configured package repositories, ordered by name. For each package rig shows its version and its number of hard dependencies (Depends, Imports and LinkingTo, excluding R and the base packages). A header line reports the total number of packages and the R version and package type they were resolved for.

By default rig uses the default R version and the current platform; override these with --r-version, --platform and --pkg-type (e.g. source or binary).

Use --json to print the full listing as JSON, including the complete dependency lists for every package. See rig repos package-info for a detailed view of a single package and rig repos package-versions to list all versions of a package.

Usage

rig repos package-list [OPTIONS]

Options

--admin: Run in admin mode (overrides RIG_MODE and config)
-h, --help: Print help (see a summary with ‘-h’)
--json: JSON output
--pkg-type <pkg-type>: Type of packages to list (e.g. source, binary)
--platform <platform>: Platform to use, instead of the current
--r-version <r-version>: R version to use, instead of the default
--user: Run in user mode (overrides RIG_MODE and config)

`rig repos package-versions`

List all versions of a package known to the CRAN metadata database, oldest first. For each version rig shows its publication date, its R version requirement and its number of hard dependencies (Depends, Imports and LinkingTo, excluding R and the base packages); the latest version is marked.

Use --json to print the full crandb record for every version, including the complete metadata and dependency lists. See rig repos package-info for a detailed view of a single version.

Usage

rig repos package-versions [OPTIONS] <package>

Arguments

<package>: package to show

Options

--admin: Run in admin mode (overrides RIG_MODE and config)
-h, --help: Print help (see a summary with ‘-h’)
--json: JSON output
--user: Run in user mode (overrides RIG_MODE and config)

`rig repos setup`

Set up the package repositories for installed R versions.

By default rig configures the repositories for all installed R versions; use --r-version to restrict it to one. Use --with-repos and --without-repos to control which repositories are enabled, the same way as for rig add.

Usage

rig repos setup [OPTIONS]

Options

--admin: Run in admin mode (overrides RIG_MODE and config)
-h, --help: Print help (see a summary with ‘-h’)
-r, --r-version <r-version>: R version to set up repositories for (default: all)
--user: Run in user mode (overrides RIG_MODE and config)
--with-repos=<with-repos>: Repositories to enable, in addition to the ones enabled by default. If --without-repos is also specified (without a value), then only these repositories will be enabled.
--without-repos[=<without-repos>]: Do not set up package repositories. Alternatively, specify which ones to skip, a comma-separated list. If --with-repos is also specified, then only the repositories in that argument will be enabled.