モジュールのファイル分割.

mod shop;のように本体（{}）を持たないモジュールの宣言は、その中身を外部ファイルから読み込みます¹。ファイルの置き場所は既定でモジュールのパス（Path）をそのまま写した形になります¹。ツリーの形を変えずにコードだけをファイルへ分けられるため、main.rsが膨らんできたときの整理手段になります。

modは他言語の#includeのようなテキスト取り込みではありません。ファイルを読み込むmod宣言はモジュールツリーの中で1回だけ書き、他のファイルからはそれが宣言された場所へのパスで参照します²。

// `shop`の中身を src/shop.rs から読み込む
mod shop;

fn main() {
    println!("税込合計: {}円", shop::cart::total(&[980, 1250])); // 2453円
}

// `cart`の中身を src/shop/cart.rs から読み込む
pub mod cart;

// 非公開のまま。shop自身とその子孫からは使える
const TAX_RATE: u32 = 10;

pub fn total(prices: &[u32]) -> u32 {
    let subtotal: u32 = prices.iter().sum();
    // ファイルは分かれても、ツリー上の位置は変わらない
    subtotal * (100 + crate::shop::TAX_RATE) / 100
}

ファイルの置き場所

祖先のモジュールはディレクトリになり、モジュール自身の中身は「モジュール名 + .rs」のファイルに入ります¹。

つまりsrc/の直下には、shop自身の中身であるshop.rsと、その子モジュールを入れるディレクトリshop/が並びます。役割が違うので、両方あってよいのです。

宣言は1回だけ

modは取り込みではなくツリー上の位置の宣言なので、1つのモジュールをツリーの2か所に置くことはできません。すでに読み込んであるコードを別のファイルから使いたいときに書くのは、modの再宣言ではなくuse宣言（あるいはcrate::やsuperから始まるパスでの直接参照）です²。

2つのスタイル

モジュールの中身は、モジュール名のディレクトリの中のmod.rsに置くこともできます¹。src/shop.rsスタイルが現在推奨される書き方で、src/shop/mod.rsスタイルは古い書き方ですが今も有効です²。

mod.rsスタイルの難点は、プロジェクト中にmod.rsという同名ファイルが大量にでき、エディタで同時に開いたときに見分けづらくなることです²。別々のモジュールで2つのスタイルを混在させること自体は許されますが、読み手が混乱するため避けるのが無難です²。

補足

#[path = "legacy/shop_v1.rs"]
mod shop;