Cargo (Software)

Cargo ist eine Paketverwaltungssoftware für Rust-Pakete, die als Crate bezeichnet werden. Cargo wird über das Rust-Toolchain-Installationsprogramm rustup standardmäßig installiert, für die Verwaltung von Paket-Metadaten greift Cargo auf das Dateiformat TOML zurück.

Cargo
Basisdaten
Hauptentwickler	Rust Project Developers
Erscheinungsjahr	1. Februar 2014[1]
Aktuelle Version	0.85.0[2] (9. Januar 2025)
Betriebssystem	Plattformunabhängig
Programmier­sprache	Rust
Kategorie	Paketverwaltung
Lizenz	MIT-Lizenz[3][4], Apache-Lizenz, Version 2.0[3]
doc.rust-lang.org/cargo

Funktionen

Cargo wird als zentrales Werkzeug für die Verwaltung von Rust-Paketen verwendet. Es übernimmt dabei für jedes Paket folgende Aufgaben:^[5]

• die Verwaltung der Metadaten über das Paket
• die Auflösung und Kompilierung der Abhängigkeiten
• den Aufruf des Referenz-Compilers rustc mit den passenden Parametern
• die Forcierung von Rust-Konventionen für eine einheitliche Paketverwaltung

Paketaufbau

Rust-Pakete bestehen aus einem definierten Aufbau:

• die Dateien Cargo.toml und Cargo.lock im Wurzelverzeichnis
• den Quellcodedateien in src/
• optional:
  • Integrationstests in tests/
  • Beispielen in examples/
  • Benchmarks in benches/

Manifest

Das Paketmanifest liegt in der Cargo.toml sieht beispielhaft folgendermaßen aus:^[6]

[package]
name = "hello_world"
version = "0.1.0"
authors = ["Your Name <[e-mail]>"]

[dependencies]
regex = "1"
rand = { git = "https://github.com/rust-lang-nursery/rand.git" }
lazy_static = "*"

[dev-dependencies]
mysql = "16.0.1"

Unter der Kategorie package werden grundlegende Informationen über das Paket wie Name und Version, sowie die beteiligten Autoren genannt. Die Kategorie dependencies umfasst alle Abhängigkeiten des Paketes, Kategorien wie dev-dependencies oder profile.*ermöglichen es, gesonderte Einstellungen für Tests oder ähnliche Szenarien festzulegen.^[7]

Die Datei Cargo.lock enthält die exakten Revisionsdaten der entsprechenden Abhängigkeiten und wird automatisiert von Cargo generiert und gepflegt.

crates.io

crates.io
Sprachen	Englisch
Registrierung	nein, nur für den Upload eigener Crates
https://crates.io

Das offizielle Repository für Crates wird unter crates.io gehostet. Für den Upload eigener Crates wird ein GitHub-Account benötigt.^[8] Seit Rust 1.34.0 können auch alternative Repositories in Cargo eingebunden werden, hiervor war ausschließlich die Benutzung von crates.io möglich.^[9]

Weblinks

• The Cargo Book