11/19 RustのLT会 Shinjuku.rs #7 @FORCIA での資料になります

1. cargo-makeを
使ってみた話
Ryosuke Kamesawa

2. 自己紹介
- 亀澤諒亮, Ryosuke Kamesawa
- Twitter: @cruelturtle
- 仕事でrustを触り始めた
- 10月〜
- 競プロ・機械学習

3. Build tool 何使ってます？

4. Cargo
https://doc.rust-lang.org/cargo/

5. GNU make
https://www.gnu.org/graphics/heckert_gnu.html

6. Build tools
- Cargo
- Rust標準
- ビルド作業は一通りできる
- lint, compile, link, test, ..etc
- GNU Make
- 言語に縛られないビルドツールのデファクト
- 大抵なんでもできる
- 目的のファイルの生成
- PHONYターゲット

7. Cargo + Make?
- Rust projectでも簡単に複雑なタスクを実行したい
- makeでいうPHONYターゲット
- e.g.
- 自動生成されたコードのclean
- CIとして実行される一連のタスク
- Cargoがあるのにmakeを使うのも…

8. Cargo-make???

9. cargo-make
https://sagiegurari.github.io/cargo-make/
Rust task runner and build tool.
- Rustに特化したタスクランナー
- Makefile.toml
- 様々なタスクの書き方
- Shell command
- Shell script
- Rust
- etc…

10. Makefile.toml
[tasks.all]
dependencies = [
"clippy",
"test",
"reformat",
]
[tasks.reformat]
script = ["cargo fmt -- --emit files"]

11. ここが便利
- Predefined tasks
- CIがラク
- clippy, coverage, doc, …
- これだけでそれっぽいタスクが走る
$ cargo make ci-flow
- 自動インストール
- e.g. cargo-audit, cargo-tarpaulin, kcov, …

12. その他の機能
- Profile
- 環境変数の切り替え
- Platform override
- Linux, Mac, Windowsで切り替え
- Conditional execution
- Profile, 環境変数等による条件実行
- Watch changes
- ファイルの変更を検知して実行
- etc...

13. ハマりポイント
- Predefined task
- 意図せずpredefined taskに上書かれてしまう
- Dependencies
- （基本的に）上から順に実行
- 依存しているタスクの中で
さらに依存関係がある場合は要注意
- Workspaces
- デフォルトではworkspaceごとに
別のタスクとして実行される

14. 欠点
- Timestampに応じたビルドはできない
- rustのビルドはあくまでcargoの仕事
- Contributeしましょう！（自分でやれ

15. 最後に
- 深入りしすぎなければ便利
- cargo-make 是非使ってみてください
- 他にいいツールがあったら教えてください