Cargo

• Description
• Configuration
• Commands
  • Create project
  • Build & run project
    • Backtrace
  • Publish to Crates.io
  • Install package
  • Linting & testing
    • Check code
    • Testing
    • Fix
  • Builds
    • Profiles
      • dev
      • build
  • Documentation
    • Generation
    • Open in browser

Description

Cargo is Rust’s build system and package manager.

Configuration

• Cargo.toml

Commands

Create project

cargo new hello_cargo

Build & run project

cargo run

Backtrace

When you want to see an error backtrace set the RUST_BACKTRACE environment variable:

RUST_BACKTRACE=1 cargo run

Publish to Crates.io

cargo publish

Install package

cargo install ripgrep

Linting & testing

Check code

cargo check

Testing

cargo test

Backtrace

To backtrace set the RUST_BACKTRACE environment variable:

RUST_BACKTRACE=1 cargo run

Threads

By default cargo runs test in parallel. For more control over this you can pass the number of threads you want to use. For example to only use 1 thread:

cargo test -- --test=threads=1

Show output for passing tests as well as failed tests

cargo test -- --show-output

Pass test name to cargo (this equals test function name)

cargo test one_hundred

Run ignored tests

cargo test -- --ignored

Fix

The rustfix tool is included with Rust installations and can automatically fix some compiler warnings.

cargo fix

Builds

Profiles

In Rust, release profiles are predefined and customizable profiles with different configurations that allow a programmer to have more control over various options for compiling code. Each profile is configured independently of the others.

Cargo has two main profiles: the dev profile Cargo uses when you run cargo build and the release profile Cargo uses when you run src_shell{cargo build —release}. The dev profile is defined with good defaults for development, and the release profile has good defaults for release builds.

dev

cargo build

build

cargo build --release

Documentation

See [Rust Comments](Rust Comments) for documentation syntax.

Generation

cargo doc

Open in browser

cargo doc --open