YAML (YAML Ain't Markup Language) 是一种用于配置文件和数据交换的数据序列化格式。它以数据为核心,比 XML 和 JSON 更易于人类阅读和编写。
YAML 的优点:
易读性好:YAML 的可读性好,比 XML 和 JSON 更有条理。
简洁性:YAML 不像 XML 那样需要额外的开始和结束标签。
可扩展性:YAML 支持不同的数据类型,包括字符串、整数、浮点数、布尔值、日期、null,甚至可以包含其他的 YAML 文件。
易于实现:YAML 可以很容易地被转换成编程语言中的数据结构。
YAML 的缺点:
不支持处理循环依赖:YAML 文件中的复杂结构可能导致加载文件时的循环依赖问题。
不支持注释的多行文本:YAML 不支持注释多行文本,这可能是一个限制因素。
不保留数据顺序:在某些情况下,YAML 可能不会保留数据的顺序。
基本语法
大小写敏感
使用缩进表示层级关系
缩进时不允许使用Tab键,只允许使用空格。
缩进的空格数目不重要,只要相同层级的元素左侧对齐即可
'#'表示注释,从这个字符一直到行尾,都会被解析器忽略。
数据类型
YAML 支持的数据结构有三种。
对象:键值对的集合,又称为映射(mapping)/ 哈希(hashes) / 字典(dictionary)
数组:一组按次序排列的值,又称为序列(sequence) / 列表(list)
纯量(scalars):单个的、不可再分的值
yaml对象
对象键值对使用冒号结构表示 key: value,冒号后面要加一个空格。
也可以使用 key:{key1: value1, key2: value2, ...}。
还可以使用缩进表示层级关系;
实例1:
key:
child-key: value
child-key2: value2
转换json如下:
{"key": {"child-key": "value", "child-key2": "value2"}}
实例2
hash: { name: Steve, foo: bar }
转换json如下:
{"hash": {"name": "Steve", "foo": "bar"}}
yaml数组
以 - 开头的行表示构成一个数组
实例1
- A
- B
- C
转换为列表如下:
['A', 'B', 'C']
实例2
-
- A
- B
- C
转为json如下:
[['A', 'B', 'C']]
实例3
companies:
-
id: 1
name: company1
price: 200W
-
id: 2
name: company2
price: 500W
转换json如下:
{"companies":[{"id":1,"name":"company1","price":"200W"},{"id":2,"name":"company2","price":"500W"}]}
数组也可以使用流式(flow)的方式表示:
companies: [{id: 1,name: company1,price: 200W},{id: 2,name: company2,price: 500W}]
yaml 复合结构
数组和对象可以构成复合结构,例:
languages:
- Ruby
- Perl
- Python
websites:
YAML: yaml.org
Ruby: ruby-lang.org
Python: python.org
Perl: use.perl.org
转为json如下:
{
"languages":[
"Ruby",
"Perl",
"Python"
],
"websites":{
"YAML":"yaml.org",
"Ruby":"ruby-lang.org",
"Python":"python.org",
"Perl":"use.perl.org"
}
}
纯量
纯量是最基本的、不可再分的值。以下数据类型都属于 JavaScript 的纯量。
字符串
布尔值
整数
浮点数
Null
时间
日期
实例:
boolean:- TRUE #true,True都可以- FALSE #false,False都可以float:- 3.14- 6.8523015e+5 #可以使用科学计数法int:- 123- 0b1010_0111_0100_1010_1110 #二进制表示null:nodeName: 'node'parent: ~ #使用~表示nullstring:- 哈哈- 'Hello world' #可以使用双引号或者单引号包裹特殊字符- newlinenewline2 #字符串可以拆成多行,每一行会被转化成一个空格date:- 2018-02-17 #日期必须使用ISO 8601格式,即yyyy-MM-dddatetime:- 2018-02-17T15:02:31+08:00 #时间使用ISO 8601格式,时间和日期之间使用T连接,最后使用+代表时区
转换为dict
{'boolean': [True, False], 'float': [3.14, 685230.15], 'int': [123, 685230], None: {'nodeName': 'node', 'parent': None}, 'string': ['哈哈', 'Hello world', 'newline newline2'], 'date': [datetime.date(2018, 2, 17)], 'datetime': [datetime.datetime(2018, 2, 17, 15, 2, 31, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800)))]}
yaml 文件锚点
项目引入yaml语言来写配置文件,最近发现利用其锚点&和引用*的功能,可以极大减少配置文件中的重复内容,将相同配置内容收敛到锚点处,修改时,只需要修改锚点处的内容,即可在所有引用处生效。
举例,在server对redis的访问配置中,针对不同的db可能会写成如下配置:
user:
host: 127.0.0.1
db: 8
book:
host: 127.0.0.1
db: 9
comment:
host: 127.0.0.1
db: 10
此处host其实配置都是一样的,只有db不一样,通过锚点和引用的功能,可以写成如下:
localhost: &localhost1
host: 127.0.0.1
user:
<<: *localhost1
db: 8
book:
<<: *localhost1
db: 9
comment:
<<: *localhost1
db: 10
其中&表示将localhost1作为localhost的别名,*标识取别名localhost1对应的value,<<表示将*localhost1代表的map合并入当前map数据。
针对远端服务多台机器的访问配置,针对不同情况可能存在不同的优先级访问顺序,可以写成如下形式:
server_order_0:
-
- 127.0.0.1
- 8050
-
- 10.0.1.1
- 8050
-
- 10.0.2.1
- 8050
server_order_1:
-
- 10.0.1.1
- 8050
-
- 127.0.0.1
- 8050
-
- 10.0.2.1
- 8050
server_order_2:
-
- 10.0.2.1
- 8050
-
- 10.0.1.1
- 8050
-
- 127.0.0.1
- 8050
利用锚点和引用,可以写为下面的配置:
server0: &server0- 127.0.0.1- 8050server1: &server1- 10.0.1.1- 8050server2: &server2- 10.0.2.1- 8050server_order_0:-*server0-*server1-*server2server_order_1:-*server1-*server0-*server2server_order_2:-*server2-*server1-*server0
python读取yaml文件
import yamlimport jsonwith open('test.yml',"r",encoding='utf-8') as f:cc = f.read()print(cc)file1 = yaml.safe_load(f)print(file1)print(type(file1))import jsonfile2 =json.dumps(file1)# print(file2)# file3 = json.loads(file2)# print(file3,type(file3))# cc = {"key": {"child-key": "value", "child-key2": "value2"}}print(type(cc))

