Documentation

PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.21

Documentation for other releases can be found by using the version selector in the top right of any doc page.

cargo

Manage Rust crates with cargo, Rust’s package manager.

Attributes

check_mode:
  support: full

Parameters

Parameter	Type	Values	Description
executable	string		Path of the cargo binary to use. [default: `"cargo"`]
extra_args	string		Additional options to pass to cargo.
name	array		Name or list of names of the crate(s) to install, upgrade, or remove.
state	string	absent present latest	Whether to install (`present`), remove (`absent`), or ensure latest version (`latest`). `present` will simply ensure that a desired crate is installed. `absent` will remove the specified crate. `latest` will update the specified crate to the latest version. [default: `"present"`]
version	string		The version of the crate to install. Only used with `state: present`.
git	string		Git repository URL to install from.
branch	string		Branch to install from when using git.
tag	string		Tag to install from when using git.
rev	string		Specific commit to install from when using git.
features	array		List of features to install.
all_features	boolean		Install all available features. [default: `false`]
no_default_features	boolean		Do not install default features. [default: `false`]
locked	boolean		Use locked dependencies when building. [default: `false`]
force	boolean		Force reinstall even if the crate is already installed. [default: `false`]

Example

- name: Install crates
  cargo:
    name:
      - ripgrep
      - fd-find
      - bat
    state: present

- name: Install specific version
  cargo:
    name: cargo-edit
    version: "0.11.9"
    state: present

- name: Install crate with features
  cargo:
    name: cargo-watch
    features:
      - watch
    state: present

- name: Install from git
  cargo:
    name: my-crate
    git: https://github.com/user/my-crate.git
    branch: main
    state: present

- name: Remove crate
  cargo:
    name: ripgrep
    state: absent

- name: Update all packages to latest versions
  cargo:
    name:
      - ripgrep
      - fd-find
    state: latest