yandex-cloud-rs

Yandex Cloud gRPC API 的客户端库，如其在 GitHub 仓库 中发布的那样。

请参阅面向用户的 在线文档，此 README 旨在为库开发者提供信息。

该库的源代码位于 TVL 仓库 中。

为了构建此库，需要从 GitHub 获取 gRPC API 定义。默认情况下，这是通过 Nix（见 default.nix）完成的，然后通过 YANDEX_CLOUD_PROTOS 环境变量注入 API 定义的地址。

实际的代码生成是通过 build.rs 中的调用完成的。

此库的版本发布是从 脏 树中进行的，这意味着在 crates.io 上的版本应该已经包含所有生成的代码。为了做到这一点，在将 Cargo.toml 中的版本和 default.nix 中的 API 提交更新后，应使用以下发布程序

# Get rid of all generated source files
find src | grep '.rs$' | grep -v '^src/lib.rs$' | xargs rm

# Get rid of all old artefacts
cargo clean

# Verify that a clean build works as intended
cargo build

# Verify that all documentation builds, and verify that it looks fine:
#
# - Is the version correct (current date)?
# - Are all the services included (i.e. not an accidental empty build)?
cargo doc --open

# If everything looks fine, release:
cargo publish --allow-dirty