Cargo के Basics

Creating a New Project

cargo new एक पूरा, ready-to-build Rust project scaffold करता है: यह एक project folder, एक Cargo.toml manifest file, एक src/ directory, और एक starter src/main.rs file बनाता है जिसमें एक 'Hello, world!' program होता है।

उदाहरण: Creating a New Project

cargo new hello_cargo

The Cargo.toml Manifest

Cargo.toml project की manifest file है। यह package name, version, Rust edition, और project को चाहिए किसी भी external dependencies (crates) को record करता है। Cargo यह जानने के लिए इस file को पढ़ता है कि आपका project कैसे build करना है।

उदाहरण: The Cargo.toml Manifest

[package]
name = "hello_cargo"
version = "0.1.0"
edition = "2021"

[dependencies]

The src Directory

Cargo आपके source code को एक src/ folder के अंदर उम्मीद करता है, src/main.rs एक binary program के लिए entry point होने के साथ। इस structure को रखने का मतलब है हर Cargo command बिना extra configuration के बिल्कुल जानता है कि आपका code कहां ढूंढना है।

उदाहरण: The src Directory

// Entry point: execution of the program starts here
fn main() {
    // Print "Generated by cargo new" to the console (with a trailing newline)
    println!("Generated by cargo new");
}

Why Use Cargo Instead of rustc Directly

जैसे ही कोई project एक file से बड़ा हो या external libraries चाहिए, सीधे rustc call करना tedious हो जाता है।

Cargo मुट्ठी भर सरल subcommands से compiling, dependency management, testing, और packaging को automate करता है, यही कारण है कि लगभग सभी असली Rust projects इसे उपयोग करते हैं।

उदाहरण: Why Use Cargo Instead of rustc Directly

// Entry point: execution of the program starts here
fn main() {
    // Declare an immutable variable `reasons`, set to `["dependency management", "consistent builds", "built-in testing"]`
    let reasons = ["dependency management", "consistent builds", "built-in testing"];
    // Loop over `reasons.iter()`, binding each item to `r`
    for r in reasons.iter() {
        // Print "Cargo handles: {}" to the console, substituting in `r` (with a trailing newline)
        println!("Cargo handles: {}", r);
    }
}