m11-ecosystem

現在の依存関係（自動挿入）

!grep -A 100 '^\[dependencies\]' Cargo.toml 2>/dev/null | head -30 || echo "No Cargo.toml found"

---

エコシステムとの統合

レイヤー 2：設計上の選択

核心となる問い

この用途にはどのクレートが適切で、どのように統合すべきでしょうか？

依存関係を追加する前に、次の点を確認します。

• 標準的な解決策はありますか？
• メンテナンス状況はどうですか？
• API の安定性はどうですか？

---

統合の判断 → 実装

ニーズ	選択肢	クレート
シリアライズ	derive ベース	serde, serde_json
非同期ランタイム	tokio または async-std	tokio（最も人気）
HTTP クライアント	使いやすさ	reqwest
HTTP サーバー	モダン	axum, actix-web
データベース	SQL または ORM	sqlx, diesel
CLI の解析	derive ベース	clap
エラー処理	アプリケーションかライブラリか	anyhow, thiserror
ロギング	ファサード	tracing, log

---

検討のためのプロンプト

依存関係を追加する前に、次の点を確認します。

1. 十分にメンテナンスされていますか？

   • 最近のコミットはありますか？
   • Issue への対応は活発ですか？
   • 破壊的変更の頻度はどのくらいですか？

2. 対象範囲はどのくらいですか？

   • クレート全体が必要ですか、それとも特定の機能だけで十分ですか？
   • フィーチャーフラグで肥大化を抑えられますか？

3. どのように統合しますか？

   • トレイトベースですか、それとも具象型ですか？
   • 同期ですか、非同期ですか？
   • どのような境界条件が必要ですか？

---

上位へのトレース ↑

ドメイン上の制約へ（レイヤー 3）：

"Which HTTP framework should I use?"
    ↑ Ask: What are the performance requirements?
    ↑ Check: domain-web (latency, throughput needs)
    ↑ Check: Team expertise (familiarity with framework)

質問	トレース先	確認事項
フレームワークの選択	domain-*	どの制約が重要ですか？
ライブラリかビルドか	domain-*	デプロイモデルはどのようなものですか？
API 設計	domain-*	利用者は誰ですか？

---

下位へのトレース ↓

実装へ（レイヤー 1）：

"Integrate external crate"
    ↓ m04-zero-cost: Trait bounds and generics
    ↓ m06-error-handling: Error type compatibility

"FFI integration"
    ↓ unsafe-checker: Safety requirements
    ↓ m12-lifecycle: Resource cleanup

---

クイックリファレンス

言語間連携

統合	クレート／ツール	用途
C/C++ → Rust	bindgen	バインディングを自動生成
Rust → C	cbindgen	C ヘッダーをエクスポート
Python ↔ Rust	pyo3	Python 拡張機能
Node.js ↔ Rust	napi-rs	Node アドオン
WebAssembly	wasm-bindgen	ブラウザー／WASI

Cargo のフィーチャー

フィーチャー	目的
[features]	オプション機能
default = [...]	デフォルトのフィーチャー
feature = "serde"	条件付き依存関係
[workspace]	複数クレートのプロジェクト

エラーコードのリファレンス

エラー	原因	修正方法
E0433	クレートが見つからない	Cargo.toml に追加
E0603	非公開項目	クレートのドキュメントを確認
フィーチャーが有効でない	オプションのフィーチャー	features で有効にする
バージョンの競合	互換性のない依存関係	cargo update を実行するか、バージョンを固定
型の重複	クレートのバージョンが異なる	ワークスペース内で統一

---

クレート選定基準

基準	良い兆候	注意すべき兆候
メンテナンス	最近のコミット	数年間更新なし
コミュニティ	活発な Issue／PR	反応がない
ドキュメント	サンプル、API ドキュメント	ドキュメントが最小限
安定性	セマンティックバージョニング	破壊的変更が頻繁
依存関係	最小限で、よく知られている	重く、なじみがない

---

アンチパターン

アンチパターン	よくない理由	より良い方法
extern crate	古い形式（2018 年以降）	use だけを使う
#[macro_use]	グローバルな名前空間を汚染する	明示的にインポート
ワイルドカード依存関係 *	予測できない	バージョンを指定
依存関係が多すぎる	サプライチェーンのリスク	必要性を評価
すべてをベンダー化	メンテナンスの負担	crates.io を信頼

---

関連スキル

場合	参照先
エラー型の設計	m06-error-handling
トレイトの統合	m04-zero-cost
FFI の安全性	unsafe-checker
リソース管理	m12-lifecycle