cargo

Cargo

Cargo is Rust's build system and package manager. It is famous for its reliability and developer experience.

When to Use

• Rust Dependency & Build Management: Compiling, building, packaging, and publishing Rust packages and crates.
• Workspace Multi-Crate Architectures: Managing monorepos with shared dependencies and unified lockfiles.
• Continuous Integration & Static Analysis: Running cargo test, cargo clippy, cargo fmt, and cargo audit.
• Release Optimization & Cross-Compilation: Building stripped, LTO-optimized release binaries for production.

Quick Start

cargo new my-project
cd my-project
cargo run

# Cargo.toml
[dependencies]
serde = "1.0"

Core Concepts

Cargo Workspace Configuration (Cargo.toml)

Managing multiple interdependent crates in a monorepo:

# /Cargo.toml (Workspace Root)
[workspace]
members = [
    "crates/api-server",
    "crates/core-domain",
    "crates/db-migrations",
]
resolver = "2"

[workspace.dependencies]
tokio = { version = "1.40", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
tracing = "0.1"
thiserror = "1.0"

[profile.release]
opt-level = 3
lto = "fat"            # Link-time optimization
codegen-units = 1      # Maximize optimizations across units
panic = "abort"        # Eliminate unwinding code overhead
strip = true           # Automatically strip symbols from binary

High-Speed Testing, Benchmarking & Lints

Automating quality checks in CI/CD pipelines:

# Format check
cargo fmt --all -- --check

# Clippy linter with strict warning enforcement
cargo clippy --all-targets --all-features -- -D warnings

# Execute all workspace unit and integration tests in parallel
cargo test --workspace --all-features

# Security audit against RustSec advisory database
cargo audit

Adding and Managing Dependencies

Adding pinned crates with specific feature sets:

# Add dependency with targeted features
cargo add tokio --features full
cargo add serde --features derive
cargo add axum --features ws

# Update dependencies adhering to SemVer
cargo update