TOML简介
来源:互联网 发布:历史api数据后原油波动 编辑:程序博客网 时间:2024/06/04 00:28
TOML简介
GitHub 目前的新项目已经转用 CoffeeScript 了。CoffeeScript 比 JavaScript 要简洁优雅得多。同样地,GitHub 也觉得 YAML 不够简洁优雅,因此捣鼓出了一个 TOML。
TOML 的全称是 Tom’s Obvious, Minimal Language,因为它的作者是 GitHub 联合创始人 Tom Preston-Werner 。GitHub 这是要革 YAML 的命呀!
TOML 的目标
TOML 的目标是成为一个极简的配置文件格式。TOML 被设计成可以无歧义地被映射为哈希表,从而被多种语言解析。
例子
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 = 5000enabled = 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 是大小写敏感的。
注释
使用 # 表示注释:
# I am a comment. Hear me roar. Roar.key = "value" # Yeah, you can do this.
字符串
字符串和 JSON 的定义一致,只有一点除外: TOML 要求使用 UTF-8 编码。
注释以引号包裹,里面的字符必须是 UTF-8 格式。引号、反斜杠和控制字符(U+0000 到 U+001F)需要转义。
"I'm a string. \"You can quote me\". Name\tJos\u00E9\nLocation\tSF."
常用的转义序列:
\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 或其他合适的编码。具体的处理取决于特定的应用。
整数
整数就是一些没有小数点的数字。想用负数?按直觉来就行。整数的尺寸最小为64位。
浮点数
浮点数带小数点。小数点两边都有数字。64位精度。
3.1415-0.01
布尔值
布尔值永远是小写。
true
false
日期时间
使用 ISO 8601 完整格式。
1979-05-27T07:32:00Z
数组
数组使用方括号包裹。空格会被忽略。元素使用逗号分隔。注意,不允许混用数据类型。
[ 1, 2, 3 ][ "red", "yellow", "green" ][ [ 1, 2 ], [3, 4, 5] ][ [ 1, 2 ], ["a", "b", "c"] ] # 这是可以的。[ 1, 2.0 ] # 注意:这是不行的。
数组可以多行。也就是说,除了空格之外,方括号间的换行也会被忽略。在关闭方括号前的最终项后的逗号是允许的。
表格
表格(也叫哈希表或字典)是键值对的集合。它们在方括号内,自成一行。注意和数组相区分,数组只有值。
[table]
在此之下,直到下一个 table 或 EOF 之前,是这个表格的键值对。键在左,值在右,等号在中间。键以非空字符开始,以等号前的非空字符为结尾。键值对是无序的。
[table]key = "value"
你可以随意缩进,使用 Tab 或空格。为什么要缩进呢?因为你可以嵌套表格。
嵌套表格的表格名称中使用.。你可以任意命名你的表格,只是不要用点,点是保留的。
[dog.tater]type = "pug"
以上等价于如下的 JSON 结构:
{ "dog": { "tater": { "type": "pug" } } }
如果你不想的话,你不用声明所有的父表。TOML 知道该如何处理。
# [x] 你# [x.y] 不需要# [x.y.z] 这些[x.y.z.w] # 可以直接写
空表是允许的,其中没有键值对。
只要父表没有被直接定义,而且没有定义一个特定的键,你可以继续写入:
[a.b]
c = 1
[a]d = 2
然而你不能多次定义键和表格。这么做是不合法的。
# 别这么干!
[a]
b = 1
[a]
c = 2
# 也别这个干
[a]
b = 1
表格数组
最后要介绍的类型是表格数组。表格数组可以通过包裹在双方括号内的表格名来表达。使用相同的双方括号名称的表格是同一个数组的元素。表格按照书写的顺序插入。双方括号表格如果没有键值对,会被当成空表。
[[products]]name = "Hammer"sku = 738594937[[products]][[products]]name = "Nail"sku = 284758393color = "gray"
等价于以下的 JSON 结构:
{ "products": [ { "name": "Hammer", "sku": 738594937 }, { }, { "name": "Nail", "sku": 284758393, "color": "gray" } ]}
表格数组同样可以嵌套。只需在子表格上使用相同的双方括号语法。每一个双方括号子表格回从属于最近定义的上层表格元素。
[[fruit]] name = "apple" [fruit.physical] color = "red" shape = "round" [[fruit.variety]] name = "red delicious" [[fruit.variety]] name = "granny smith"[[fruit]] name = "banana" [[fruit.variety]] name = "plantain"
等价于如下的 JSON 结构:
{ "fruit": [ { "name": "apple", "physical": { "color": "red", "shape": "round" }, "variety": [ { "name": "red delicious" }, { "name": "granny smith" } ] }, { "name": "banana", "variety": [ { "name": "plantain" } ] } ]}
尝试定义一个普通的表格,使用已经定义的数组的名称,将抛出一个解析错误:
# 不合法的 TOML[[fruit]] name = "apple" [[fruit.variety]] name = "red delicious" # 和上面冲突了 [fruit.variety] name = "granny smith"
为什么需要TOML
因为我们需要一个像样的人类可读的格式,同时能无歧义地映射到哈希表。然后 YAML 的规范有 80 页那么长,真是发指!不,不考虑 JSON 。你知道为什么。
如果你有一个实现,请发一个合并请求,把你的实现加入到这个列表中。请在你的解析器的 README 中标记你的解析器支持的 提交SHA1 或 版本号。
C#/.NET - https://github.com/LBreedlove/Toml.netC#/.NET - https://github.com/rossipedia/toml-netC#/.NET - https://github.com/RichardVasquez/TomlDotNetC (@ajwans) - https://github.com/ajwans/libtomlC++ (@evilncrazy) - https://github.com/evilncrazy/ctomlC++ (@skystrife) - https://github.com/skystrife/cpptomlClojure (@lantiga) - https://github.com/lantiga/clj-tomlClojure (@manicolosi) - https://github.com/manicolosi/clojomlCoffeeScript (@biilmann) - https://github.com/biilmann/coffee-tomlCommon Lisp (@pnathan) - https://github.com/pnathan/pp-tomlErlang - https://github.com/kalta/etoml.gitErlang - https://github.com/kaos/tomleEmacs Lisp (@gongoZ) - https://github.com/gongo/emacs-tomlGo (@thompelletier) - https://github.com/pelletier/go-tomlGo (@laurent22) - https://github.com/laurent22/toml-goGo w/ Reflection (@BurntSushi) - https://github.com/BurntSushi/tomlHaskell (@seliopou) - https://github.com/seliopou/tomlHaxe (@raincole) - https://github.com/raincole/haxetomlJava (@agrison) - https://github.com/agrison/jtomlJava (@johnlcox) - https://github.com/johnlcox/toml4jJava (@mwanji) - https://github.com/mwanji/toml4jJava - https://github.com/asafh/jtomlJava w/ ANTLR (@MatthiasSchuetz) - https://github.com/mschuetz/tomlJulia (@pygy) - https://github.com/pygy/TOML.jlLiterate CoffeeScript (@JonathanAbrams) - https://github.com/JonAbrams/tomljsnode.js - https://github.com/aaronblohowiak/tomlnode.js/browser - https://github.com/ricardobeat/toml.js (npm install tomljs)node.js - https://github.com/BinaryMuse/toml-nodenode.js (@redhotvengeance) - https://github.com/redhotvengeance/topl (topl npm package)node.js/browser (@alexanderbeletsky) - https://github.com/alexanderbeletsky/toml-js (npm browser amd)Objective C (@mneorr) - https://github.com/mneorr/toml-objc.gitObjective-C (@SteveStreza) - https://github.com/amazingsyco/TOMLOcaml (@mackwic) https://github.com/mackwic/to.mlPerl (@alexkalderimis) - https://github.com/alexkalderimis/config-toml.plPerl - https://github.com/dlc/tomlPHP (@leonelquinteros) - https://github.com/leonelquinteros/php-toml.gitPHP (@jimbomoss) - https://github.com/jamesmoss/tomlPHP (@coop182) - https://github.com/coop182/toml-phpPHP (@checkdomain) - https://github.com/checkdomain/tomlPHP (@zidizei) - https://github.com/zidizei/toml-phpPHP (@yosymfony) - https://github.com/yosymfony/tomlPython (@socketubs) - https://github.com/socketubs/pytomlPython (@f03lipe) - https://github.com/f03lipe/toml-pythonPython (@uiri) - https://github.com/uiri/tomlPython - https://github.com/bryant/pytomlPython (@elssar) ) https://github.com/elssar/tomlgunPython (@marksteve) - https://github.com/marksteve/toml-plyPython (@hit9) - https://github.com/hit9/toml.pyRuby (@jm) - https://github.com/jm/toml (toml gem)Ruby (@eMancu) - https://github.com/eMancu/toml-rb (toml-rb gem)Ruby (@charliesome) - https://github.com/charliesome/toml2 (toml2 gem)Ruby (@sandeepravi) - https://github.com/sandeepravi/tomlp (tomlp gem)Scala - https://github.com/axelarge/tomelette
校验
@BurntSushi) - https://github.com/BurntSushi/toml/tree/master/tomlv
TOML 测试套件 (语言无关)
toml-test (@BurntSushi) - https://github.com/BurntSushi/toml-test
编辑器支持
Emacs (@dryman) - https://github.com/dryman/toml-mode.el
Sublime Text 2 & 3 (@lmno) - https://github.com/lmno/TOML
TextMate (@infininight) - https://github.com/textmate/toml.tmbundle
Vim (@cespare) - https://github.com/cespare/vim-toml
编码器
。PHP (@ayushchd) - https://github.com/ayushchd/php-toml-encoder
- TOML简介
- toml
- toml使用中容易遇到的问题
- go语言学习之----读取配置文件的方式toml
- go语言配置文件解析库的使用TOML parser and encoder for Go with reflection
- Go实战--也许最快的Go语言Web框架kataras/iris初识二(TOML、Cache、Cookie)
- 简介
- 简介
- 简介
- 简介
- 简介
- 简介
- 简介
- 简介
- 简介
- 简介
- 简介
- 简介
- python3+PyQt5 实现自定义窗口部件--Counters自定窗口部件
- C++ 大数的+-*/算法
- 递归--【全排列问题】九度1459.Prime ring problem
- LZMA压缩文件与解压文件
- 数列分段Section I
- TOML简介
- 华为P8桌面上的短信图标不见了怎么办
- offsetleft和style.left的区别
- Dynamics CRM 2015-Form之添加Ribbon Button
- 重建二叉树
- MACOS: 如何在应用程序中应用文件超链接,直接打开文件
- 二分法入门(二)——POJ 3258,2976;HDU 4430;CodeForces 535C;Gym 101194D;ACdream 1066
- Unity3d中UnassignedReferenceException: The variable target of Moving has not been assigned. You proba
- StringBuffer和StringBuilder的区别