クレート.

クレートは、Rustコンパイラが一度に処理するコンパイルの最小単位です。実行可能ファイルにコンパイルされるバイナリクレートと、実行可能ファイルにはならず機能を他から使わせるライブラリクレートの2種類があります¹。

バイナリクレートには実行時の入口となるmainという関数が必要で、ライブラリクレートはmainを持ちません。1つのパッケージには、ライブラリクレートを最大1つ、バイナリクレートを何個でも入れられます¹。

/// 送料込みの合計金額を計算する（3000円以上は送料無料）
pub fn total_with_shipping(prices: &[u32]) -> u32 {
    let subtotal: u32 = prices.iter().sum();
    if subtotal >= 3000 { subtotal } else { subtotal + 500 }
}

// ライブラリクレートはクレート名で参照する（Playgroundでは playground 固定）
use playground::total_with_shipping;

fn main() {
    let cart = [1200, 800]; // カートに入れた商品の価格
    println!("お支払い金額: {}円", total_with_shipping(&cart));
}

クレートルート

クレートルートは、コンパイラが最初に読み込むソースファイルで、そのクレートのルートモジュールになります¹。クレートの中身は入れ子になったモジュールのツリーで、ルートモジュールはその頂点にあたる、パス（Path）の上では名前を持たない無名のモジュールです²。絶対パスの起点に書くcrate::は、この頂点を指しています。

どのファイルがクレートルートになるかは、言語仕様ではなくCargoの規約で決まります。Cargoはファイルの配置からクレートを自動的に見つけます¹³。

src/bin/に置いたファイルはそれぞれ独立したバイナリクレートになるため、1つのパッケージから複数の実行可能ファイルを作れます¹。実行するものはcargo run --bin reportのように選びます³。

// このファイル自体が1つのバイナリクレートになる（cargo run --bin report で実行）
use playground::total_with_shipping;

fn main() {
    println!("送料込み: {}円", total_with_shipping(&[1200, 800]));
}

補足