yaoxiang.toml フォーマット

yaoxiang.toml はYaoXiangプロジェクトのマニフェストファイルであり、プロジェクトメタデータと依存関係を宣言します。

ファイル構造

[package]
name = "プロジェクト名"
version = "0.1.0"
description = "プロジェクト説明"
authors = ["著者名"]
license = "MIT"

[dependencies]
# 通常依存関係

[dev-dependencies]
# 開発依存関係

package 部分

フィールド	タイプ	必須	説明
name	string	は	プロジェクト名、命名規則に準拠（小文字、数字、ハイフン）
version	string	は	セマンティックバージョニング、semver仕様に準拠
description	string	いいえ	プロジェクト簡略説明
authors	array	いいえ	著者リスト
license	string	いいえ	ライセンス識別子

例

[package]
name = "my-awesome-app"
version = "1.2.3"
description = "素晴らしいアプリケーション"
authors = ["三人 <zhangsan@example.com>"]
license = "MIT"

依存関係の宣言

シンプルバージョン

[dependencies]
http = "1.0.0"
json = "*"

詳細設定

[dependencies]
# Git 依存関係
http = { version = "1.0.0", git = "https://github.com/example/http" }

# ローカルパス依存関係
utils = { version = "0.1.0", path = "./utils" }

# ブランチ付き Git 依存関係
bleeding-edge = { git = "https://github.com/example/edge", branch = "main" }

依存関係フィールドの説明

フィールド	タイプ	説明
version	string	バージョン番号
git	string	Gitリポジトリ
branch	string	Gitブランチ
path	string	ローカルパス

バージョン番号の構文

構文	説明	例
*	任意バージョン	"*"
1.0.0	正確バージョン	"1.0.0"
>=1.0.0	最低バージョン	">=1.0.0"
<2.0.0	最高バージョン	"<2.0.0"
>=1.0.0, <2.0.0	範囲バージョン	">=1.0.0, <2.0.0"
~1.0.0	互換バージョン	"~1.0.0"
^1.0.0	caret バージョン	"^1.0.0"

完全な例

[package]
name = "web-server"
version = "0.1.0"
description = "シンプルなWebサーバー"
authors = ["開発者 <dev@example.com>"]
license = "MIT"

[dependencies]
http = "1.0.0"
json = "2.0.0"
router = { version = "0.5.0", path = "./router" }

[dev-dependencies]
test-utils = "1.0.0"
benchmark = "0.1.0"