rig library
Manage package libraries [alias: lib] (experimental)
rig supports multiple user package libraries. The usual user library is called “main”.
rig library default shows or sets the default library for the current R version. rig library list lists all libraries for the current R version. rig library add adds a new library for the current R version. rig library rm deletes a library, including all packages in it. It is not possible to delete the current default library, and it is not possible to delete the main library.
User libraries are implemented at the user level, no administrator or root password is needed to add, set or delete them. If you delete an R installation, the user package libraries and their configurations are kept for all users on the system.
rig library is currently experimental, and might change in future versions. Feedback is appreciated.
Subcommands
rig library add
Add a new user package library for the current R version.
The new library is created empty. Adding a library does not change the default library; use rig library default to switch to it. No administrator rights are needed.
Usage
rig library add [OPTIONS] <lib-name>
Arguments
<lib-name>- name of new library
Options
--admin- Run in admin mode (overrides RIG_MODE and config)
-h, --help- Print help (see a summary with ‘-h’)
--user- Run in user mode (overrides RIG_MODE and config)
rig library default
Show or set the default package library for the current R version.
Call without arguments to print the current default library. Call with a library name to make it the default. New R sessions of the current R version will then use that library.
Usage
rig library default [OPTIONS] [lib-name]
Arguments
[lib-name]- library name to set as default
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 library list
List the package libraries of the current R version [alias: ls].
The default library is marked. See rig library for an overview of user package libraries.
Usage
rig library 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
--user- Run in user mode (overrides RIG_MODE and config)
rig library rm
Remove a user package library of the current R version, including all packages installed in it.
You cannot remove the current default library, and you cannot remove the main library. Switch to another library with rig library default first if needed.
Usage
rig library rm [OPTIONS] <lib-name>
Arguments
<lib-name>- name of library to remove
Options
--admin- Run in admin mode (overrides RIG_MODE and config)
-h, --help- Print help (see a summary with ‘-h’)
--user- Run in user mode (overrides RIG_MODE and config)