rust: クレート、パッケージ、モジュール

目次 (最終更新日:2025/09/20)

概要
参考
クレート(crate)
パッケージ(package)
モジュール(module)
記載予定

概要

プログラムを複数のファイルに分割したときの取り扱い方について。
Cargoを使う前提とする。

参考

クレート(crate)

コンパイルは「クレート」が最小単位となっている。

バイナリクレートとライブラリクレートの種類が生まれるのはパッケージのようにも思うが、細かく区別する必要もないだろう。
バイナリクレートはcargo new --bin(--binはデフォルトなのでなくてもよい)で作られるタイプでsrc/main.rsがエントリーポイントと思っていて良いだろう。
ライブラリクレートはsrc/lib.rsを持つ。

cargo addはクレートを追加するManifestコマンドで、空のクレートを追加するのではなくCargo.tomlに依存関係を追加するコマンドである。「Cargo.toml Manifestファイル」と書いてあるので、ManifestコマンドはCargo.tomlに関するコマンドだろう。

パッケージ(package)

「パッケージ」は1つ以上のクレートを持つ。
cargo newで作られるのはパッケージである。packageコマンドという分類になっている。

ライブラリクレートは最大でも1つなのでsrc/lib.rsがあるかどうかでわかる。
Cargo.tomlでは[lib]セクションでカスタマイズできる。

バイナリクレートもsrc/main.rsがあるかどうかでわかるのだが、こちらは複数持つことができる。その場合はsrc/bin/にディレクトリを作ってmain.rsを置く。
src/main.rsを持たずにsrc/bin/*に複数のディレクトリを作ってそれぞれにmain.rsを持っても良い。
Cargo.tomlでは[[bin]]セクションでカスタマイズできる。括弧が1つ多い。

モジュール(module)

クレートやパッケージがどちらかといえば物理的？なのに対して、モジュールはどちらかといえば論理的なものだという印象を持った。
たぶんmodで定義できるからそう感じるのだろう。

mod <mod名> {...}という書き方はmodの定義と宣言を兼ねている。
mod <mod名>;とすると、このファイルでmod名というモジュールを使用するという宣言になる。

`mod`の定義

同じファイルの中にあるので定義と使用する宣言を兼ねている。
useはC++のusingとusing namespaceを混ぜたような使い方になる。

mod world_mod1 {
    pub mod world_mod2 {
        pub fn world_func() {
            println!("abc world")
        }
    }
}

use world_mod1::world_mod2::world_func as w;
use world_mod1::world_mod2 as w2;
use world_mod1 as w3;

fn main() {
    world_mod1::world_mod2::world_func();
    w();
    w2::world_func();
    w3::world_mod2::world_func();
}

`mod名` のファイルを作る

例えば hello_mod.rs というファイルを作り、その中に hello_func() という関数を作ったとする。

pub fn hello_func() {
    println!("Hello, abc!");
}

それと同じディレクトリにあるmain.rsからhello_func()を呼び出したい場合はこうなる。

mod hello_mod;

fn main() {
  hello_mod::hello_func();
}

つまり mod <ファイル名> {} で定義したのと同じ意味を持つことになる。

ディレクトリを作ってその下に`mod名`のファイルを作る

同じディレクトリではなく別のディレクトリにしたい場合もある。

hello_func() を含んだファイルを hello_mod2.rs とする。
ディレクトリ hello_mod1 を作って hello_mod2.rs を移動させる。

そうすると、なんとなく main.rs からは mod hello_mod1::hello_mod2; と書けばよさそうな気がするが、そうは書けない。
mod に書くことができるのは単独のモジュール名だけで :: は使えないのだった。
その代わりに、hello_mod1.rs というファイルを main.rs と同じディレクトリに作り、その中で pub mod hello_mod2; と書く。

ファイルの階層構造 - Rust By Example

以前は mod.rs というファイルに書く方式だったが今ではそうしなくてもよいそうだ。
テキストエディタのタブで “mod.rs” が複数表示されると面倒だ、みたいな理由らしいので特に理由がなければモジュールごとのファイル名を使えばよいだろう。

No more mod.rs

現在の方式に倣うとこうなる(はず。少なくともエラーにはならない)。
なんとなく main.rs にある mod はなくてもよいかと思ったのだがダメだった。

src/main.rs

mod hello_mod1;

use hello_mod1::hello_mod2;

fn main() {
    hello_mod2::hello_func();
}

src/hello_mod1.rs

pub mod hello_mod2;

src/hello_mod1/hello_mod2.rs

pub fn hello_func() {
    println!("Hello, abc!");
}

モジュールツリー

モジュールは入れ子にできるので、モジュールツリーと呼ぶツリー構造として表すようになっている。
ツリーのルートはmain.rsやlib.rsである。
use world_mod1::world_mod2 as w2;のように書いたあれは相対パスのような表現で、これを絶対パスのような表現にするとuse crate::world_mod1::world_mod2 as w2;とルートを表すcrate::が頭に付く。

そうなると、モジュールとして扱えるのは今のクレートの中だけということになるのでは？
もちろんそういうことはなく、外部で既に公開されている関数などを使うこともできる。

外部のパッケージを使う

「パッケージ」なのだ。
とはいえ実行ファイルを取り込むこともできないだろうから、ライブラリクレートを含むパッケージのはずである。
パッケージには最大で 1つまでしかライブラリクレートを持つことができないので、ライブラリクレートを持つパッケージのみuseで使えるようにできるのだろう。

モジュール参照の絶対パスと相対パス

useでパスをスコープに持ち込んだり、関数呼び出しでパスを指定する際の書き方に、絶対パスと相対パスがある。

crateで始まるとルートからの絶対パスになる。

ファイルのパス指定と同じで、何も書かなければカレントモジュールから始まる。 selfで初めても良い。ファイルで./を明示するかどうかに似ている。
selfはパスの途中では使用できない。

superを使うと1つ上のパスになる。これはパスの途中で使うことができるが、最初がsuperで始まるときだけだ。上がったり下がったりするような書き方はできないし、ルートであるcrateより上に上がることもできない。

なんというか、素直なパスの書き方だけと思っておけば良いだろう。

記載予定

pub
workspace

writer: hiro99ma

tags: Rust language