Cargo & dépendances

mon_projet/
├── Cargo.toml       ← configuration du projet
├── Cargo.lock       ← versions exactes verrouillées
└── src/
    ├── main.rs      ← binaire principal
    └── lib.rs       ← bibliothèque (optionnel)

Important : Cargo.lock doit être commité pour les binaires, ignoré pour les bibliothèques.

[package]
name    = "mon_projet"
version = "0.1.0"
edition = "2024"
authors = ["Ton Nom <ton@email.com>"]
description = "Une courte description"
license = "MIT"

[dependencies]
# Version exacte
serde = "1.0.210"

# Avec features
serde = { version = "1.0", features = ["derive"] }

# Depuis git
ma_crate = { git = "https://github.com/user/ma_crate" }

# Depuis un chemin local
utils = { path = "../utils" }

[dev-dependencies]
# Uniquement pour les tests
pretty_assertions = "1.4"

[build-dependencies]
# Pour le script build.rs
cc = "1.0"

Sémantique des versions :

[profile.release]
opt-level = 3      # optimisation maximale
lto = true         # Link Time Optimization
strip = true       # supprime les symboles de debug

[profile.dev]
opt-level = 0      # pas d'optimisation, compilation rapide
debug = true       # symboles de debug

cargo new mon_projet          # crée un nouveau binaire
cargo new ma_lib --lib        # crée une nouvelle bibliothèque

cargo build                   # compile en debug
cargo build --release         # compile en release (optimisé)
cargo run                     # compile et exécute
cargo run -- arg1 arg2        # avec des arguments

cargo test                    # lance tous les tests
cargo test nom_du_test        # lance un test spécifique
cargo test --release          # tests en mode release

cargo check                   # vérifie sans compiler (rapide)
cargo clippy                  # linter — suggestions de qualité
cargo fmt                     # formate le code

cargo add serde               # ajoute une dépendance
cargo remove serde            # supprime une dépendance
cargo update                  # met à jour Cargo.lock

cargo doc --open              # génère et ouvre la documentation

[features]
default  = ["json"]          # features actives par défaut
json     = ["serde/derive"]  # active serde avec derive
async    = ["tokio"]         # feature async optionnelle
full     = ["json", "async"] # groupe de features

[dependencies]
serde = { version = "1.0", optional = true }
tokio = { version = "1.0", optional = true }

#[cfg(feature = "json")]
pub mod json {
    pub fn parse(input: &str) -> serde_json::Value {
        serde_json::from_str(input).unwrap()
    }
}

// Compilation conditionnelle
#[cfg(feature = "async")]
pub async fn fetch_data() -> Result<String, reqwest::Error> {
    reqwest::get("https://example.com").await?.text().await
}

cargo build --features "json,async"
cargo build --all-features
cargo build --no-default-features

# Cargo.toml racine
[workspace]
members = [
    "app",
    "core",
    "utils",
]
resolver = "2"

# Versions partagées
[workspace.dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1.0", features = ["full"] }

[workspace.package]
version = "0.1.0"
edition = "2024"

# app/Cargo.toml
[package]
name    = "app"
version.workspace = true      # hérite la version du workspace
edition.workspace = true

[dependencies]
core  = { path = "../core" }
serde.workspace = true        # hérite la dépendance du workspace

cargo build -p core           # compile uniquement la crate 'core'
cargo test --workspace        # teste toutes les crates

# 1. Connexion (token sur crates.io)
cargo login <ton_token>

# 2. Vérifier avant de publier
cargo publish --dry-run

# 3. Publier
cargo publish