use_crate: Add dependencies to a Cargo.toml manifest file

In extendr/rextendr: Call Rust Code from R using the 'extendr' Crate

Add dependencies to a Cargo.toml manifest file

Description

Analogous to usethis::use_package() but for crate dependencies.

Usage

use_crate(
  crate,
  features = NULL,
  git = NULL,
  version = NULL,
  optional = FALSE,
  path = ".",
  echo = TRUE
)

Arguments

crate	character scalar, the name of the crate to add
features	character vector, a list of features to include from the crate
git	character scalar, the full URL of the remote Git repository
version	character scalar, the version of the crate to add
optional	boolean scalar, whether to mark the dependency as optional (FALSE by default)
path	character scalar, the package directory
echo	logical scalar, should cargo command and outputs be printed to console (default is TRUE)

Details

For more details regarding these and other options, see the Cargo docs for cargo-add.

Value

NULL (invisibly)

Examples

## Not run: 
# add to [dependencies]
use_crate("serde")

# add to [dependencies] and [features]
use_crate("serde", features = "derive")

# add to [dependencies] using github repository as source
use_crate("serde", git = "https://github.com/serde-rs/serde")

# add to [dependencies] with specific version
use_crate("serde", version = "1.0.1")

# add to [dependencies] with optional compilation
use_crate("serde", optional = TRUE)

## End(Not run)

extendr/rextendr documentation built on April 5, 2025, 1:53 a.m.