BOML

BOML 是一个为 Rust 语言的、无依赖的（几乎）零拷贝的 TOML 解析器。

快速演示

解析

BOML 使用 Toml 结构体来解析 TOML 文件并加载其根表。这可能会返回成功解析的 TOML，或者有关语法错误的详细信息。如果解析成功，则可以像使用 HashMap 一样使用 Toml 结构体从根表中获取值。

use boml::prelude::*;

fn parse_cargo_toml() {
	let source = include_str!("../Cargo.toml");
  let toml = Toml::parse(source).unwrap();
  // If you prefer, `Toml::new()` will do the same thing:
  // let toml = Toml::new(source).unwrap();

  // Get the package table from the `Cargo.toml` file
  let package = toml.get("package").unwrap();
}

类型

BOML 将 TOML 数据存储在 TomlValue 枚举中，每个类型都有一个变体。在上面的示例中，package 变量只是存储一个 TomlValue，这可以是任何 TOML 类型，对我们来说并不太有用。我们希望 package 是一个表。BOML 提供了多种便捷的方式来实现这一点

// Tables provide `get_<type>` methods, which will return the value as that type if it matches.
// If this method fails, it provides detailed error information, described below.
let package = toml.get_table("package").unwrap();
// All tables provide the `get_<type>` methods, so we can use them to get values from package, too
let name = package.get_string("name").unwrap();
assert_eq!(name, "boml");

// `TomlValue`s can be converted to one of their enum variants - this works similarly to the `.ok()` and
// `.err()` methods on `Result`s.
let package = toml.get("package").unwrap().table().unwrap();
let name = package.get("name").unwrap().string().unwrap();
assert_eq!(name, "boml");

// If you're really dedicated to boilerplate, you can also manually unwrap the enum variant.
let Some(TomlValue::Table(package)) = toml.get("package") else {
  panic!("I love boilerplate");
};

BOML 还提供了一个 TomlValueType 枚举，允许你在运行时确定值的类型。在 TomlValue 上的 .ty() 方法提供了这些信息

let package = toml.get("package").unwrap();
assert_eq!(package.ty(), TomlValueType::Table);

错误处理

BOML 中有两个错误来源：解析错误或来自表格中 get_<type> 方法之一的一个错误。这些分别使用 TomlError 和 TomlGetError 类型。