質問 1

ライブラリを開発する際に、作ったパブリック関数をテストするのにライブラリクレートの内側に新しくワークスペースを作りたいです。
そのテストは.dll形式でビルドしたいので、Cargo.tomlに

toml
1[lib]
2crate-type = ["cdylib"]
3path = "src/lib.rs"

を記述する必要があります。なので浮かぶ案としてはライブラリクレートの内側でcargo new sample --lib として、ビルドする際にcargo build -p sample などとする感じかなあというところなのですが、普通ライブラリ開発者様は一般的にどのような方法を取られるんでしょうか。

質問 2

質問1に付随する形になるんですが、例えばライブラリクレートの中に新しいテスト用のクレートを作ったとすると、それは他人がライブラリを使用する際に一緒にダウンロードされるのでしょうか？もしそうならサイズが無駄に大きくなってしまいますよね。(別に問題ない気もしますが)

行動規範の内容に同意します

回答1件

ベストアンサー

質問１の回答

普通ライブラリ開発者様は一般的にどのような方法を取られるんでしょうか。

クレートのテストに.dllが必要になるというのは珍しいことだと思いますので、一般的な方法はなさそうです。それぞれのクレートの作者さまが、それぞれ工夫しているように思えます。

cdylibを扱うクレートで私が知っているものについて、どうしているのか調べてみました。

libloadingクレート

Cargo標準のtestsディレクトリー内に、どこか他の場所で作成した.dllを置いている。
tests/windows.rsファイル内の#[test]指定の関数から.dllを使用している。
tests/windows.rsファイルの先頭に#![cfg(windows)]と書くことで、Windows環境でのみテストが実行されるようにしている。

こうすることで、Windows環境で単にcargo testとすればテストを実行できます。

abi-stableクレート

Cargo標準ではないtestingディレクトリーを作成し、その中にテスト用のlibクレートやbinクレートを置いている。
たとえば、testing/0/impl_0/ディレクトリーにcdylibのlibクレートがあり、testing/0/user_0/ディレクトリーにそれをロードするbinクレートがある。
テストはGitHub Actionsで実行しており、.github/workflows/rust.ymlファイルに書かれたコマンドで、それぞれのディレクトリーへの移動とcargo testまたはcargo runなどを行なっている。

GitHub Actionsのファイルにコマンドを書く方法ですと、手元の環境でテストを実行したいときは、手でいちいちcargo runなどのコマンドを入れなければならないので不便かなと感じました。もし自分でやるなら、（私はLinux/macOS環境を使用しているので）Gnu MakeなどのMakefileにcargo runなどのコマンドを書いて、make testのように実行できるようにすると思います。

質問２の回答

例えばライブラリクレートの中に新しいテスト用のクレートを作ったとすると、それは他人がライブラリを使用する際に一緒にダウンロードされるのでしょうか？

Cargo.tomlのpackageセクションでexcludeを指定することで、それにマッチするディレクトリーやファイルをパッケージから除外できます。なお、ドキュメントによると、サブパッケージ（Cargo.tomlファイルが含まれているサブディレクトリー）は自動的に除外されるそうです。

パッケージに何が含まれるか確認するにはcargo packageコマンドを実行します。target/packageディレクトリーにgzipで圧縮されたtar形式のパッケージが作られますので（拡張子は.crate）、それを解凍して中のファイルを見てみることができます。

投稿2021/09/24 14:21