Rust
Cargaison

Introduction

Syntaxe

• cargo new crate_name [--bin]
• cargo init [--bin]
• construction de la cargaison [--release]
• course de cargaison [--release]
• chèque de cargaison
• test de cargaison
• banc de fret
• mise à jour de la cargaison
• paquet de fret
• publication de la cargaison
• cargo [un] installe binary_crate_name
• recherche de fret crate_name
• version cargo
• identifiant de cargaison api_key

Remarques

Créer un nouveau projet

Bibliothèque

cargo new my-library

Cela crée un nouveau répertoire appelé my-library contenant le fichier de configuration cargo et un répertoire source contenant un seul fichier source Rust:

my-library/Cargo.toml
my-library/src/lib.rs

Ces deux fichiers contiendront déjà le squelette de base d'une bibliothèque, de sorte que vous pouvez effectuer un cargo test (à partir du répertoire de my-library ) immédiatement pour vérifier si tout fonctionne.

Binaire

cargo new my-binary --bin

Cela crée un nouveau répertoire appelé my-binary avec une structure similaire à celle d'une bibliothèque:

my-binary/Cargo.toml
my-binary/src/main.rs

Cette fois-ci, cargo aura mis en place un simple binaire Hello World que nous pourrons utiliser immédiatement avec cargo run .

Vous pouvez également créer le nouveau projet dans le répertoire en cours avec la sous-commande init :

cargo init --bin

Tout comme ci-dessus, supprimez l'indicateur --bin pour créer un nouveau projet de bibliothèque. Le nom du dossier actuel est utilisé comme nom de caisse automatiquement.

Construire un projet

Déboguer

cargo build

Libération

La construction avec l'indicateur --release permet certaines optimisations du compilateur qui ne sont pas effectuées lors de la construction d'une version de débogage. Cela rend le code plus rapide, mais rend également la compilation un peu plus longue. Pour des performances optimales, cette commande doit être utilisée une fois la version terminée.

cargo build --release

Tests en cours

Utilisation de base

cargo test

Afficher la sortie du programme

cargo test -- --nocapture

Exécuter un exemple spécifique

cargo test test_name

Bonjour tout le monde

Ceci est une session shell montrant comment créer un programme "Hello world" et l'exécuter avec Cargo:

$ cargo new hello --bin
$ cd hello
$ cargo run
   Compiling hello v0.1.0 (file:///home/rust/hello)
     Running `target/debug/hello`
Hello, world!

Après cela, vous pouvez éditer le programme en ouvrant src/main.rs dans un éditeur de texte.

Publier une caisse

Pour publier une caisse sur crates.io , vous devez vous connecter avec Cargo (voir « Connexion de la cargaison à un compte Crates.io »).

Vous pouvez conditionner et publier votre caisse avec les commandes suivantes:

cargo package
cargo publish

Toute erreur dans votre fichier Cargo.toml sera mise en évidence pendant ce processus. Vous devez vous assurer de mettre à jour votre version et de vous assurer que votre fichier .gitignore ou Cargo.toml exclut les fichiers indésirables.

Connecter Cargo à un compte Crates.io

Les comptes sur crates.io sont créés en se connectant avec GitHub; vous ne pouvez pas vous inscrire avec une autre méthode.

Pour connecter votre compte GitHub à crates.io, cliquez sur le bouton " Connexion avec GitHub " dans la barre de menu supérieure et autorisez crates.io à accéder à votre compte. Cela vous connectera alors à crates.io, en supposant que tout s'est bien passé.

Vous devez ensuite trouver votre clé API , que vous pouvez trouver en cliquant sur votre avatar, en sélectionnant " Paramètres du compte " et en copiant la ligne qui ressemble à ceci:

cargo login abcdefghijklmnopqrstuvwxyz1234567890rust

Cela devrait être collé dans votre terminal / ligne de commande et devrait vous authentifier avec votre installation de cargo locale.

Soyez prudent avec votre clé API - elle doit rester secrète, comme un mot de passe, sinon vos caisses pourraient être détournées!