25 个版本
0.2.0 | 2021 年 1 月 11 日 |
---|---|
0.1.10 | 2021 年 1 月 10 日 |
0.1.8 | 2020 年 12 月 26 日 |
0.1.6 | 2020 年 11 月 28 日 |
0.0.10 | 2020 年 10 月 22 日 |
#2164 在 开发工具
78 每月下载量
500KB
14K SLoC
yang 陽
Yang 是一个基本的、实验性的代码生成器。Yang 既是 Yin 使用的代码生成器,也依赖于 Yin 进行代码生成。有关其内部结构的详细描述,请参阅 yin.md
。
为了与 zamm_yin
保持一致,这个包被命名为 zamm_yang
。然而,在 ZAMM 宇宙中,这个工具的名字只是 yang
。
用法
首先,将 yin
和 yang
添加为构建依赖项。然后,定义你的 build.rs
用于概念生成,以及你的 main.rs
用于使用生成的概念(示例链接)。确保在 KB 启动时初始化新生成的概念。
文献编程
您可以使用 ZAMM 自动使用 Yang 从 README 中生成代码。
语义版本
语义版本 "向后兼容" 将被理解为不破坏 Yin 和 Yang 的发布构建的任何更改。例如,在 Yang 版本 0.x.0
和 0.x.y
之间可能会有许多公共 API 的更改。但是,只要依赖于 0.x.0
的 Yin 和 Yang 发布版本没有破坏,并且依赖于最新 0.x.y
版本的发布版本也没有破坏,这在所有实际意义上都将被认为是 "向后兼容"。
请注意,这意味着 Yang 版本 0.x.0
本身将免除此检查,因为 Yang 0.x.0
将取决于 Yang 0.x-1.y
,这种依赖当然将是一个破坏性变更。
开发
请注意,由于 Yang 在自身上使用自动生成功能,它需要先存在一个自身的二进制文件才能构建当前版本。如果本地找不到,build.rs
脚本将尝试从 Bintray 下载。如果 Bintray 的任何版本都不可用于您的平台,您可以通过依次构建每个版本并通过将 YANG_BINARY
环境变量设置为新构建的 yang
可执行文件的位置来启动 Yang。
依赖
~4–17MB
~180K SLoC