Toml路径和指针

概述

根据json路径语法实现TOML指针，类型为Option<&toml::Value>，依赖于crate toml。重载/作为路径操作符以指向TOML树中的节点，以及一些其他有意义的操作符重载。例如，管道操作符|用于从标量叶节点获取原始值，推入操作符<<用于覆盖标量节点或将新项目推入数组或表，以及推入赋值操作符<<=用于无条件地重新分配给TOML节点。而/或操作符<<可能会使指针失效，我们可以使用!操作符或is_none()方法来测试这种失败情况。

示例

use toml_ops::PathOperator;
let tv = r#"
[host]
ip="127.0.0.1"
port=8080
proto=["tcp", "udp"]
"#;
let mut v: toml::Value = tv.parse().unwrap(); 

let port = v.path() / "host" / "port" | 0;
assert_eq!(port, 8080);

let node = v.path_mut() / "host" / "port" << 8989;
let port = node | 0;
assert_eq!(port, 8989);

let proto = v.path() / "host" / "proto" / 0 | "";
assert_eq!(proto, "tcp");

let host = v.path_mut() / "host";
let host = host << ("newkey", "newval") << ("morekey", 1234);
assert_eq!(host.is_none(), false);
assert_eq!(!host, false);

let mut proto = v.path_mut() / "host" / "proto";
proto = proto << ("json", ) << ["protobuf"];
assert_eq!(proto.as_ref().unwrap().as_array().unwrap().len(), 4);

proto <<= "default";
assert_eq!(proto.as_ref().unwrap().is_str(), true);
let proto = v.path() / "host" / "proto" | "";
assert_eq!(proto, "default");

let invalid = v.path() / "host" / "no-key";
assert_eq!(!invalid, true);
assert_eq!(invalid.is_none(), true);

路径语法

类似于Unix文件系统中的文件路径，每个组件通过斜杠/分隔，特别是对于数组索引也使用/而不是[]。因此，您不应在表中使用数字键以避免混淆。

请参阅详细或标准json路径语法，因为TOML在数据模型上与JSON大致相同。

Toml操作符重载指南

操作符触发

我们不能在 toml::Value 的外部直接重载操作符形式。因此，我在 toml_ops 包中定义了一个名为 PathOperator 的 trait，并为 toml::Value 实现了它。然后，您可以从 toml::Value 调用以下方法来创建 toml 指针

• path()：指向自身的 toml 值。
• pathto(subpath: &str)：指向自身 toml 值的某个子节点。
• path_mut()：path() 的可变版本。
• pathto_mut(subpath: &str)：pathto() 的可变版本。

let node = toml_value.path() / "path" / "to" / "node";
let node = toml_value.pathto("path/to/node");
let node = toml_value.path() / "path/to/node";
let node = toml_value.path() / "path.to.node";

let node = toml_value.path() / "sub-array" / 0 / "sub-key";
// not so good to use:
// let node = toml_value.path() / "sub-array/0/sub-key";

let str_val: &str = toml_value().path() / "path" / "to" / "node" | "";
let int_val: i64 = toml_value().path() / "path" / "to" / "node" | 0;
let float_val: f64 = toml_value().path() / "path" / "to" / "node" | 0.0;
let bool_val: bool = toml_value().path() / "path" / "to" / "node" | false;

let node = toml_vaule.path_mut() / "path" / "to" / "int-node" << 314;
let node = toml_vaule.path_mut() / "path" / "to" / "float-node" << 3.14;
let _ = toml_vaule.path_mut() / "path" / "to" / "string-node" << "PI";
let _ = toml_vaule.path_mut() / "path" / "to" / "bool-node" << true;

let node = toml_vaule.path_mut() / "table" << ("int", 314) << ("float", 3.14);
let _ = toml_vaule.path_mut() / "array" << (314,) << [3.14];

let node = toml_vaule.path_mut() / "path" / "to" / "bool-node" << true;
node <<= "true";

let node = node << val; // may fail when mistype
node <<= val; // always sucesse expect node already invalid pointer.

let node = toml_value.path() / "path" / "to" / "nil";
if (!node) { return; }
if (node.is_none()) { return; }

let root = toml_value.path();
let table = root / "path" / "to" / "table";
let val1 = table / "key1" | 0;
let val2 = table / "key2" | "";