toml格式配置文件详解

  1. Eric
  2. toml
  3. toml格式配置文件详解
4.5 周庆 toml

Github 目前的新项目已经转用　CoffeeScript 了.CoffeeScript 比　JavaScript　要简洁优雅得多.同样地,Github　也觉得 YAML 不够简洁优雅,因此捣鼓出了一个　TOML. TOML　的全称是　Tom’s Obvious, Minimal Language,因为它的作者是 Github　联合创始人　Tom Preston-Werner .

1. TOML 的目标

TOML 的目标是成为一个极简的配置文件格式.TOML 被设计成可以无歧义地被映射为哈希表,从而被多种语言解析.

2. 例子


[owner]
name = "Tom Preston-Werner"
organization = "Github"
bio = "Github Cofounder & CEO\nLikes tater tots and beer."
dob = 1979-05-27T07:32:00Z # 日期时间是一等公民.为什么不呢？

[database]
server = "192.168.1.1"
ports = [ 8001, 8001, 8002 ]
connection_max = 5000
enabled = true

[servers]

  # 您可以依照您的意愿缩进.使用空格或Tab.TOML不会在意.
  [servers.alpha]
  ip = "10.0.0.1"
  dc = "eqdc10"

  [servers.beta]
  ip = "10.0.0.2"
  dc = "eqdc10"

[clients]
data = [ ["gamma", "delta"], [1, 2] ]

3.在数组里换行没有关系.

hosts = [
  "alpha",
  "omega"
]


    title = "TOML 例子"

    [owner]
    name = "Tom Preston-Werner"
    organization = "Github"
    bio = "Github Cofounder & CEO\nLikes tater tots and beer."
    dob = 1979-05-27T07:32:00Z # 日期时间是一等公民.为什么不呢？

    [database]
    server = "192.168.1.1"
    ports = [ 8001, 8001, 8002 ]
    connection_max = 5000
    enabled = true

    [servers]

      # 您可以依照您的意愿缩进.使用空格或Tab.TOML不会在意.
      [servers.alpha]
      ip = "10.0.0.1"
      dc = "eqdc10"

      [servers.beta]
      ip = "10.0.0.2"
      dc = "eqdc10"

    [clients]
    data = [ ["gamma", "delta"], [1, 2] ]

    # 在数组里换行没有关系.
    hosts = [
      "alpha",
      "omega"
    ]

TOML 是大小写敏感的.

4. 注释

使用 # 表示注释：

    # I am a comment. Hear me roar. Roar.
    key = "value" # Yeah, you can do this.

5.字符串

字符串和 JSON 的定义一致,只有一点除外：　TOML 要求使用　UTF-8 编码.

注释以引号包裹,里面的字符必须是　UTF-8 格式.引号,反斜杠和控制字符（U+0000 到 U+001F）需要转义.

    "I'm a string. \"You can quote me\". Name\tJos\u00E9\nLocation\tSF."

常用的转义序列：

\t     - tab             (U+0009)
\n     - linefeed        (U+000A)
\f     - form feed       (U+000C)
\r     - carriage return (U+000D)
\"     - quote           (U+0022)
\/     - slash           (U+002F)
\\     - backslash       (U+005C)
\uXXXX - unicode         (U+XXXX)


    \b     - backspace       (U+0008)
    \t     - tab             (U+0009)
    \n     - linefeed        (U+000A)
    \f     - form feed       (U+000C)
    \r     - carriage return (U+000D)
    \"     - quote           (U+0022)
    \/     - slash           (U+002F)
    \\     - backslash       (U+005C)
    \uXXXX - unicode         (U+XXXX)

使用保留的特殊字符,TOML　会抛出错误.例如,在　Windows 平台上,应该使用两个反斜杠来表示路径：


    wrong = "C:\Users\nodejs\templates" # 注意：这不会生成合法的路径.
    right = "C:\\Users\\nodejs\\templates"

二进制数据建议使用　Base64　或其他合适的编码.具体的处理取决于特定的应用.

6.整数 int

整数就是一些没有小数点的数字.想用负数？按直觉来就行.整数的尺寸最小为64位.

7.浮点数 float

浮点数带小数点.小数点两边都有数字.64位精度.



    3.1415
    -0.01

8. 布尔值 bool

布尔值永远是小写.

    true
    false

9.日期时间 time

使用　ISO 8601　完整格式.

    1979-05-27T07:32:00Z

10.数组 array/slice

数组使用方括号包裹.空格会被忽略.元素使用逗号分隔.注意,不允许混用数据类型.


[ "red", "yellow", "green" ]
[ [ 1, 2 ], [3, 4, 5] ]
[ [ 1, 2 ], ["a", "b", "c"] ] # 这是可以的.
[ 1, 2.0 ] # 注意：这是不行的.


    [ 1, 2, 3 ]
    [ "red", "yellow", "green" ]
    [ [ 1, 2 ], [3, 4, 5] ]
    [ [ 1, 2 ], ["a", "b", "c"] ] # 这是可以的.
    [ 1, 2.0 ] # 注意：这是不行的.

数组可以多行.也就是说,除了空格之外,方括号间的换行也会被忽略.在关闭方括号前的最终项后的逗号是允许的.

11. 表格 table/hash/map

表格（也叫哈希表或字典）是键值对的集合.它们在方括号内,自成一行.注意和数组相区分,数组只有值.

    [table]

在此之下,直到下一个　table 或　EOF 之前,是这个表格的键值对.键在左,值在右,等号在中间.键以非空字符开始,以等号前的非空字符为结尾.键值对是无序的.

    [table]
    key = "value"

您可以随意缩进,使用 Tab 或空格.为什么要缩进呢？因为您可以嵌套表格.

嵌套表格的表格名称中使用..您可以任意命名您的表格,只是不要用点,点是保留的.

    [dog.tater]
    type = "pug"

以上等价于如下的 JSON 结构：

    { "dog": { "tater": { "type": "pug" } } }

如果您不想的话,您不用声明所有的父表.TOML　知道该如何处理.

# [x.y] 不需要
# [x.y.z] 这些
[x.y.z.w] # 可以直接写

    # [x] 您
    # [x.y] 不需要
    # [x.y.z] 这些
    [x.y.z.w] # 可以直接写

空表是允许的,其中没有键值对.

只要父表没有被直接定义,而且没有定义一个特定的键,您可以继续写入：


[a]
d = 2

[a.b]
c = 1
[a]
d = 2

然而您不能多次定义键和表格.这么做是不合法的.

[a]
b = 1

[a]
c = 2


# 别这么干！

[a]
b = 1

[a]
c = 2

    [a]
    b = 1
    
    [a.b]
    c = 2


    # 也别这个干

    [a]
    b = 1

    [a.b]
    c = 2

12. 表格数组 Table Array

最后要介绍的类型是表格数组.表格数组可以通过包裹在双方括号内的表格名来表达.使用相同的双方括号名称的表格是同一个数组的元素.表格按照书写的顺序插入.双方括号表格如果没有键值对,会被当成空表.


[[products]]

[[products]]
name = "Nail"
sku = 284758393
color = "gray"


    [[products]]
    name = "Hammer"
    sku = 738594937

    [[products]]

    [[products]]
    name = "Nail"
    sku = 284758393
    color = "gray"

等价于以下的　JSON 结构：


  "products": [
    { "name": "Hammer", "sku": 738594937 },
    { },
    { "name": "Nail", "sku": 284758393, "color": "gray" }
  ]
}

13.但是为什么要选择TOML？

因为我们需要一个像样的人类可读的格式,同时能无歧义地映射到哈希表.然后　YAML 的规范有 80 页那么长,真是发指！不,不考虑　JSON .您知道为什么. 哈哈！想帮忙么？发合并请求过来.或者编写一个解析器.勇敢一点.

TOML Parser 实现

如果您有一个实现,请发一个合并请求,把您的实现加入到这个列表中.请在您的解析器的 README 中标记您的解析器支持的 提交SHA1 或 版本号.

14. TOML校验

@BurntSushi) - https://github.com/BurntSushi/toml/tree/master/tomlv

15.TOML 测试套件 （语言无关）

16. TOML编辑器支持

类别和标签

TCP/IP notes CPP CheatSheet 快速入门 快速查询 Jekyll Github Python Golang Shell Bash docker 教程 container nginx dockerfile golang Spider 钉钉 PhantomJS RPC protobuf gRPC 文件 操作 GUI reflect 网络请求 代理 http chromedp Go进阶 工具 Vim Javascript seaweedfs Raft raft Git Nginx RESTful gitbook node npm github pages toml lumen laravel cors markdown 日志 log mysql 定时任务 php 程序员 Python教程 redis Dockerhub Docker OSS 网络协议 python 运维开发 kali linux 树莓派 raspberryPi algorithm 算法 黑客 hack ssh xtermjs shell context gcc g++ jekyll 破解 LDAP Linux 有声读物 CSS ES6 OAuth2 Prometheus Grafana Nes Game HTTP3 Java 动手 Gateway 网关 Rust笔记 fullstack chrome

英文主站 | Golang Captcha Open Source Project | Youtube Channel | Bilibli Channel | neochau@gmail.com  |  Github Account Mojocn | 鄂ICP备16006181号-4

目录