11 个版本

0.0.11 2021 年 8 月 1 日
0.0.10 2021 年 7 月 29 日
0.0.3 2020 年 9 月 22 日
0.0.1 2020 年 8 月 26 日

#2636解析器实现

Download history 3/week @ 2024-03-12 4/week @ 2024-03-19 2/week @ 2024-03-26 22/week @ 2024-04-02 31/week @ 2024-04-09 1/week @ 2024-04-23 2/week @ 2024-05-28

52 每月下载量
4 个crate(直接使用2个) 中使用

MIT/Apache

72KB
2K SLoC

TAML

Lib.rs Crates.io Docs.rs

Rust 1.53 CI Crates.io - License

GitHub open issues open pull requests crev reviews

TAML 是一种结合了 Markdown、CSV、TOML、YAML 和 Rust 的一些方面的配置文件格式。

作为配置语言,TAML 的主要设计目标是

  • 可由人类编写
  • 可由人类阅读
  • 无歧义且可调试
  • 可由计算机阅读

由于它主要面向人类,并且相同的数据可以用多种方式表示,因此实际上这个库中没有序列化器。如果您需要数据传输格式,几乎任何其他东西都会给您带来更好的性能。

话虽如此,我相信对于人类编写的文件,TAML 在简洁性和简单性之间提供了非常好的平衡,并且具有足够的性能。

taml-cli crate 中提供了命令行验证器和格式化程序。
serde_taml 中可以找到 Serde 集成。

有关格式的文档请参阅 https://taml.schichler.dev

安装

请使用 cargo-edit 来始终添加此库的最新版本

cargo add taml

示例

TODO:在此处添加一个好的示例文件。

许可证

许可协议为以下之一

任选其一。

贡献

除非您明确声明,否则任何有意提交以包含在您的工作中的贡献,根据 Apache-2.0 许可证定义,应按上述方式双重许可,不附加任何额外条款或条件。

行为准则

更新日志

版本控制

taml 严格遵循 语义版本控制 2.0.0,以下有一些例外

  • 无效的 TAML 变为有效被视为功能添加。
  • 次要版本号在主版本号更改时不会重置为 0(v1 除外)。
    将其视为全局功能级别。
  • 修补程序版本号在主版本号或次要版本号更改时不会重置为 0(v0.1 和 v1 除外)。
    将其视为全局修补程序级别。

这包括上述 Rust 版本要求。
早期Rust版本可能兼容,但可能会随着小版本或补丁版本更新而改变。

受功能和补丁影响的具体版本可以通过CHANGELOG.md中的相应标题确定。

依赖项

~4MB
~54K SLoC