rig proj
Manage R projects (experimental).
A project is a directory with a package manifest, typically a DESCRIPTION file, that declares the R packages the project depends on. rig proj resolves those dependencies against the configured package repositories and can install them into a project library.
rig proj deps shows the direct and recursive dependencies of the project. rig proj solve resolves the full dependency tree to a concrete set of package versions, and can write the result to an renv.lock file. rig proj deploy installs the resolved dependencies into a package library.
Dependencies are resolved with rig’s built-in solver, so R does not need to be running for rig proj deps and rig proj solve.
rig proj is currently experimental, and might change in future versions. Feedback is appreciated.
Subcommands
rig proj deploy
Install the resolved dependencies of an R project into a package library.
rig solves the project dependencies and installs them into the library given by --library. Use --r-binary to select which R to build against (default: R) and --max-concurrent to limit the number of simultaneous installations (default: 4).
Usage
rig proj deploy [OPTIONS] --library <library>Options
--admin- Run in admin mode (overrides RIG_MODE and config)
-h, --help- Print help (see a summary with ‘-h’)
-l, --library <library>- Library path where packages should be installed
--max-concurrent <max-concurrent>- Maximum number of concurrent installations (default: 4)
--r-binary <r-binary>- Path to R binary (default: R)
--user- Run in user mode (overrides RIG_MODE and config)
rig proj deps
Show the dependencies of an R project.
By default rig reads the project manifest (e.g. DESCRIPTION) in the current directory; use --input to point to a different file. Add --dev to include development dependencies.
Usage
rig proj deps [OPTIONS]Options
--admin- Run in admin mode (overrides RIG_MODE and config)
--dev- Include dev (development) dependencies
-h, --help- Print help (see a summary with ‘-h’)
-i, --input <input>- Project file to solve (e.g. DESCRIPTION)
--json- JSON output
--user- Run in user mode (overrides RIG_MODE and config)
rig proj solve
Resolve the dependencies of an R project to a concrete set of package versions.
rig reads the project manifest (e.g. DESCRIPTION; override with --input) and uses its built-in solver to find a compatible set of package versions from the configured repositories, without running R.
Use --r-version to solve for a specific R version, --dev to include development dependencies, and --renv to write the result as an renv.lock file.
Usage
rig proj solve [OPTIONS]Options
--admin- Run in admin mode (overrides RIG_MODE and config)
--dev- Include dev (development) dependencies
-h, --help- Print help (see a summary with ‘-h’)
-i, --input <input>- Project file to solve (e.g. DESCRIPTION)
--json- JSON output
-r, --r-version <r-version>- R version to solve dependencies for
--renv- Output and renv.lock file
--user- Run in user mode (overrides RIG_MODE and config)