Release v0.2.18: bump companion package to 0.1.1

Pulls the new uvr-r tarball (commit 2503f7a) so users get update_uvr() on
their next sync — closes the v0.2.10 #43 promise that was blocked by the
companion repo not having the function on its default branch.

Local r-package/ also resynced with the upstream repo:
  - r_version.R (r_install / r_list / r_use / r_pin) brought in
  - update_uvr export already present locally
  - NAMESPACE + uvr-package.Rd union the two function sets

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: nbafrank

Cargo.lock

@@ -3,7 +3,7 @@ members = ["crates/uvr", "crates/uvr-core"]
 resolver = "2"
 
 [workspace.package]
-version = "0.2.17"
+version = "0.2.18"
 edition = "2021"
 authors = ["uvr contributors"]
 license = "MIT"

Cargo.toml

@@ -567,8 +567,8 @@ pub async fn install_from_lockfile(
 
 /// Pinned commit SHA and expected SHA-256 hash of the companion R package tarball.
 /// Update these together when releasing a new companion version.
-const COMPANION_SHA: &str = "4ddd0e991ebd19679b7c0343495250a201820ee4";
-const COMPANION_HASH: &str = "820dd6eb191fb4496662de3d524005c1c876206831724d4e2183e60591f4841e";
+const COMPANION_SHA: &str = "2503f7a2d3bfa6dd4e5977266444a016638222b6";
+const COMPANION_HASH: &str = "3bb74e3e59a24a1244970e529be7b54289c2cc74d3297cab2f8fff9505241ec2";
 
 /// Install the uvr R companion package from GitHub into the project library
 /// if it's not already installed. Failures are silently ignored — the companion

crates/uvr/src/commands/sync.rs

@@ -1,6 +1,6 @@
 Package: uvr
 Title: R Interface to the 'uvr' Package Manager
-Version: 0.1.0
+Version: 0.1.1
 Authors@R: person("Francesco", "Grazzini", role = c("aut", "cre"),
                   email = "francesco@example.com")
 Description: Provides R functions that wrap the 'uvr' command-line tool for

r-package/DESCRIPTION

@@ -6,3 +6,7 @@ export(remove_pkgs)
 export(sync)
 export(lock)
 export(run)
+export(r_install)
+export(r_list)
+export(r_use)
+export(r_pin)

r-package/NAMESPACE

@@ -0,0 +1,56 @@
+#' Install an R version
+#'
+#' Downloads and installs a specific R version to \code{~/.uvr/r-versions/}.
+#' Equivalent to \code{uvr r install <version>} on the command line.
+#'
+#' @param version R version string, e.g. \code{"4.4.2"}.
+#' @param quiet If \code{TRUE}, suppress output.
+#' @return Invisible \code{TRUE} on success.
+#' @export
+r_install <- function(version, quiet = FALSE) {
+  run_uvr(c("r", "install", version), quiet = quiet)
+}
+
+#' List R versions
+#'
+#' Shows installed R versions. Use \code{all = TRUE} to show all available
+#' versions from CRAN.
+#' Equivalent to \code{uvr r list} on the command line.
+#'
+#' @param all If \code{TRUE}, show all available versions (not just installed).
+#' @param quiet If \code{TRUE}, suppress output.
+#' @return Invisible \code{TRUE} on success.
+#' @export
+r_list <- function(all = FALSE, quiet = FALSE) {
+  args <- c("r", "list")
+  if (isTRUE(all)) args <- c(args, "--all")
+  run_uvr(args, quiet = quiet)
+}
+
+#' Set the R version constraint
+#'
+#' Sets the R version constraint in \code{uvr.toml}.
+#' Equivalent to \code{uvr r use <version>} on the command line.
+#'
+#' @param version Version constraint, e.g. \code{">=4.3.0"} or \code{"4.4.2"}.
+#' @param dir Optional working directory. Defaults to \code{getwd()}.
+#' @param quiet If \code{TRUE}, suppress output.
+#' @return Invisible \code{TRUE} on success.
+#' @export
+r_use <- function(version, dir = NULL, quiet = FALSE) {
+  run_uvr(c("r", "use", version), dir = dir, quiet = quiet)
+}
+
+#' Pin the R version
+#'
+#' Writes an exact R version to the \code{.r-version} file.
+#' Equivalent to \code{uvr r pin <version>} on the command line.
+#'
+#' @param version Exact R version, e.g. \code{"4.4.2"}.
+#' @param dir Optional working directory. Defaults to \code{getwd()}.
+#' @param quiet If \code{TRUE}, suppress output.
+#' @return Invisible \code{TRUE} on success.
+#' @export
+r_pin <- function(version, dir = NULL, quiet = FALSE) {
+  run_uvr(c("r", "pin", version), dir = dir, quiet = quiet)
+}

r-package/R/r_version.R

@@ -17,7 +17,8 @@ with a lockfile, similar to how \code{uv} works for Python.
   \item{\code{\link{lock}}}{Re-resolve dependencies and update the lockfile}
   \item{\code{\link{run}}}{Run an R script in the project environment}
   \item{\code{\link{install_uvr}}}{Install the uvr CLI binary}
-  \item{\code{\link{update_uvr}}}{Update both R package and CLI binary}
+  \item{\code{\link{update_uvr}}}{Update both R package and CLI binary in one call}
+  \item{\code{\link{r_install}}, \code{\link{r_list}}, \code{\link{r_use}}, \code{\link{r_pin}}}{Manage R versions}
 }
 
 \strong{Typical workflow:}