ostree-rs

注意：此包已废弃并重命名为 ostree。请使用 ostree 包。

Rust 对 libostree 的绑定。

libostree 既是共享库也是一系列命令行工具，它结合了“git-like”模型来提交和下载可启动的文件系统树，并包含一个用于部署和管理引导加载程序配置的层。

状态

绑定目前相当不完整。大部分可以自动生成，但我只是开启了所需的部分，其余的留待以后完成。

使用

需求

libostree 包需要 libostree 和 libostree 开发头文件。在 Debian/Ubuntu 上，可以使用以下命令安装：

$ sudo apt-get install libostree-1 libostree-dev

安装

要使用此包，请将其添加到您的 Cargo.toml

[dependencies]
libostree = "0.1"

要使用后续 libostree 版本的功能，您还需要指定发布版本

[dependencies.libostree]
version = "0.1"
features = ["v2018_7"]

开发

可以使用常规 Cargo 命令构建和测试 libostree 和 libostree-sys 包。

生成的代码

大部分代码是根据 gir 文件使用 gir 工具生成的。这些部分可以使用包含的 Makefile 重新生成

$ make generate-libostree-sys generate-libostree

运行以下命令以更新捆绑的 gir 文件

$ make update-gir-files

文档

由于 libostree API 的 LGPL 许可证，默认情况下不包括代码中的 libostree API 文档。这意味着常规的 cargo doc 运行不会包含生成的代码的 API 文档。运行 merge-lgpl-docs Makefile 目标以在源中包含 API 文档，以便它们可以被 cargo doc 消费

$ make merge-lgpl-docs

请注意，如果您将 API 文档包含在构建的包中，则它实际上受 LGPL 许可证约束，您需要遵守 LGPL 的要求（特别是，允许最终用户替换 LGPL 的部分）。

CI 包括在文档构建中包含 LGPL 文档。

发布

可以使用管道中的 publish_* 作业进行发布。目前还没有版本号辅助工具，因此版本更新需要手动完成。

许可证

libostree 包受 MIT 许可证的许可。有关详细信息，请参阅 LICENSE 文件。

libostree 本身受 LGPL2+ 许可证的许可。有关更多信息，请参阅其 许可信息。