编程语言配置文件格式TOML
前言
互联网项目常用的配置文件格式比较丰富，比如xml，yml，json，dotenv，ini等等。今天再给大家分享一种在Rust中常用的一种配置文件格式，TOML。
TOML (Tom's Obvious, Minimal Language) 是一种易于阅读和编写的配置文件格式。它旨在解决配置文件中的一些常见问题，如JSON不支持注释和复杂的类型结构。TOML被设计为简单、直观且易于解析。
庐山真面目
一起来看一个案例。一个基本的TOML文件看起来像这样：
title = "TOML Example"
[owner]
name = "Tom Preston-Werner"
dob = 1979-05-27T07:32:00-08:00 # First class dates
[database]
server = "192.168.1.1"
ports = [ 8001, 8001, 8002 ]
connection_max = 5000
enabled = true
[servers]
[ servers.alpha ]
ip = "10.0.0.1"
dc = "eqdc10"
[ servers.beta ]
ip = "10.0.0.2"
dc = "eqdc10"
[clients]
data = [ [1, 2], [1, 2] ]
# Line breaks between key-value pairs are OK.
hosts = [
"alpha",
"omega"
]在上面的例子中：
- `title` 是一个字符串值。
- `[owner]` 和 `[database]` 是表（table），可以理解为字典或哈希映射。
- `[database.ports]` 是一个整数数组。
- `[servers]` 和 `[clients]` 是包含其他表的表。
- `#` 开头的行是注释，会被忽略。
数据类型
TOML支持的数据类型包括：
- 字符串（`"string"`）
- 整数（123）
- 浮点数（123.45）
- 布尔值（true, false）
- 数组（[1, 2, 3]）
- 表（[table]）
- 日期时间（1979-05-27T07:32:00-08:00）
TOML还支持内联表（inline tables）和数组表（array of tables）。例如：
# Inline table
fruit = { name = "apple", color = "red" }
# Array of inline tables
fruits = [
{ name = "apple", color = "red" },
{ name = "banana", color = "yellow" }
]Rust使用TOML案例
下面的代码给出了Rust如何使用TOML。首先要在Crago.toml中添加toml依赖。
[dependencies]
toml = "0.5"然后编写解析toml的代码
use std::fs::File;
use std::io::Read;
use toml;
// 定义一个结构体来匹配TOML配置文件的内容
#[derive(Debug, Deserialize)]
struct Config {
title: String,
owner: Owner,
database: Database,
}
#[derive(Debug, Deserialize)]
struct Owner {
name: String,
dob: String,
}
#[derive(Debug, Deserialize)]
struct Database {
server: String,
ports: Vec<u16>,
connection_max: u32,
enabled: bool,
}
fn main() -> std::io::Result<()> {
// 读取TOML配置文件
let mut file = File::open("config.toml")?;
let mut contents = String::new();
file.read_to_string(&mut contents)?;
// 解析TOML字符串为Rust结构体
let config: Config = toml::from_str(&contents)?;
// 打印解析后的配置信息
println!("Configuration: {:?}", config);
Ok(())
}其他语言对TOML的支持
很多其他语言也都支持TOML配置文件格式，比如Python，Golang等等。篇幅有限，不在本篇给出具体案例。