Skip to content

rig 0.10.0

Latest
Latest

Choose a tag to compare

View all tags
@gaborcsardi gaborcsardi released this 21 Sep 13:19
· 44 commits to main since this release
v0.10.0
c16577f

Web site

  • rig has a new documentation website at https://rig.r-lib.org/,
    including a full CLI reference and a guide to admin vs. user mode.

User mode

  • rig now supports a user mode on all platforms, in addition to the
    default admin mode. In user mode rig installs everything into the user's
    home directory and never needs sudo or administrator privileges. R goes
    into ~/.local/share/rig/r (%APPDATA%\rig\data\r on Windows) and quick
    links into ~/.local/bin (%USERPROFILE%\.local\bin on Windows). Select
    the mode with the --user / --admin global flags, the RIG_MODE
    environment variable, or the mode key in the rig config file. The new
    rig system user-mode command switches an existing admin-mode setup to
    user mode.

  • On Linux, rig can now install portable R builds, for glibc- and
    musl-based Linux distros. If there is no distro-specific build for your
    platform, rig falls back to a portable build automatically.

R package management

  • New rig pkg subcommand to query and manage R packages. Two subcommands
    from rig repos moved to rig pkg: rig pkg available and
    rig pkg info. rig pkg deps lists the packages a package needs, in a
    table, and rig pkg tree shows the same dependencies as a tree.
    rig pkg list lists the packages installed in a library,
    rig pkg remove deletes packages from a library, and
    rig pkg install installs packages, and their dependencies, into a
    library.

Projects

  • New and redesigned rig proj commands to manage isolated R projects and
    virtual environments: rig proj init, rig proj import, rig proj add,
    rig proj remove, rig proj lock, rig proj sync, rig proj status.

  • New rig proj tree shows the dependency closure of a project as a tree.

  • rig run now uses the project environment, if you call it in a project
    directory: it starts .rvenv/bin/R, with the project's package library
    and the R version the project's lock file names, and it syncs the project
    first if the environment is missing or out of date. Use --no-project
    (or --r-version) to run the default R version instead.

  • rig run <name> now runs a script the project declares in a [[bin]]
    table of its rproj.toml, passing the remaining arguments on to the
    script. rig run --list lists the declared scripts.

  • rig proj sync can now centralize project package libraries outside the
    project directory: set the RIG_PROJ_LIBRARY_ROOT environment variable or
    the proj-library-root config key to a root directory, and each project
    gets its own library under it, keyed by project name and location. A
    compatibility symlink is left at the project's usual .rvenv/lib.
    rig system dirs --library-root reports the effective root (#372).

Windows specific

  • Windows builds of rig are now signed, thanks to the SignPath Foundation,
    https://signpath.org/.

  • On Windows rig now creates .exe shims instead of bat shims.
    With .exe shims it is easier to pass command line arguments to
    R and Rscript. In particular, Rscript -e <code> now works if
    <code> has line breaks. Call rig system make-links to create all
    .exe shims and remove the .bat shims. If you hardcoded shims with
    a .bat extension, change them to .exe or remove the extension
    completely (#362).

  • New rig system fix-r-alias subcommand.

  • rig rtools is now a top-level command (it used to be rig system rtools).

  • On Windows, R CMD config now works without manually putting Rtools on
    the PATH. So do R CMD sh, R CMD make and rig run --cmd config.

macOS specific

Other new features

  • rig add no longer reinstalls a version that is already installed,
    except for R-devel and R-next. Use --reinstall for force a re-install
    (#293).

  • rig add can now install the R version an renv.lock file requires,
    e.g. rig add renv.lock or rig add path/to/renv.lock (#294).

  • New rig system blas commands, to check and switch which BLAS/LAPACK
    library an installed R version uses on macOS, e.g. to switch to Apple's
    faster Accelerate/vecLib BLAS (#212).

  • New rig self update to update rig, new rig self uninstall to remove
    rig, if it was installed via the install script.

  • New rig cache command to inspect and manage rig's download and build
    caches. rig now reflinks or hardlinks packages from the cache when
    possible, instead of copying them, to save disk space and time.

  • New rig ppm command queries Posit Package Manager. New
    rig ppm build-log shows the build log of a package on Posit Package Manager.

  • New rig repos status checks the configured package repositories.

  • New rig system fix-aliases to update R-release, R-oldrel etc.
    aliases (#234).

  • rig library add, rig library default, rig library list and
    rig library rm have a new --r-version (-r) option, to operate on
    the libraries of an R version other than the default one.

  • New rig system dirs command to show the directories rig uses. With
    --r, --binary, --data, --cache, --download, --log, --rtools
    (Windows only) or --fonts (Linux only) it prints a single path, for use
    in scripts.

  • New rig config command to manage the rig configuration file.

  • rig run --cmd <command> [args...] now runs R CMD <command> [args...]
    with the selected R version.

  • rig run -- <flags> now passes raw arguments straight to the R process,
    e.g. rig run -- --vanilla or rig run -e '1+1' -- --vanilla (#249).

  • Plain rig run (i.e. without -e/-f/an app/--cmd) now defaults to
    --no-save --no-restore, so it no longer shows the "Save workspace
    image?" prompt on exit. Use rig run -- --save --restore to get the old
    behavior back (#249).

Other changes

  • rig add --without-p3m works correctly again (#369).

  • macOS user mode: rig default now sets the default R version correctly
    for newer RStudio versions. Also, rig system allow-debugger-rstudio
    now works for newer RStudio versions.

  • rig now uses a user-dependent download directory, to avoid interference
    between users.

  • rig now does not edit the shell startup files in admin mode,
    like rig 0.8.1 did on macOS. rig now only does this in user mode.

  • rig repos available now prints a compact table. New
    rig repos available <name> shows complete information about a single
    repository.

  • rig system setup-user-lib (and its create-lib alias) now works again.

  • rig rstudio --config-path is now implemented on Linux and macOS.

  • rig now warns instead of failing when it encounters a broken R
    installation (#346).

Assets 16
Loading