一:yaml语法
1、基本规则
大小写敏感
使用缩进表示层级关系
缩进时不允许使用Tab,只允许使用空格
缩进的空格数目不重要,只要相同层级的元素左对齐即可
#表示注释,从它开始到行尾都被忽略
2、yaml转字典
yaml中支持映射或字典的表示,如下:
name:灰蓝 age:0 job:Tester
转换成字段输出:
{'name':'灰蓝', 'age':0, 'job':'Tester'}
3、yaml转列表
-灰蓝 -0 -Tester
转换成列表输出
['灰蓝', 0, 'Tester']
4、复合结构:
字典和列表可以复合起来使用:
-name:灰蓝 age:0 job:Tester -name:James age:30
转换输出
[{'name':'灰蓝', 'age':0, 'job': 'Tester'},{'name':'James', 'age': 30}]
5、基本类型:
yaml中有以下基本类型:
字符串、整型、浮点型、布尔型、null、时间、日期
str:"Hello World" int:110 float:3.141 boolean:true None:null time:2016-09-22t11:43:30.20+08:00 date:2015-09-22
转换后输出
{'str': 'Hello World!', 'int': 110, 'float': 3.141, 'boolean': True, 'None': None, 'time': datetime.datetime(2016, 9, 22, 11, 43, 30, 200000, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800))), 'date': datetime.date(2016, 9, 22)}
如果字符串没有空格或者特殊字符,不需要加引号,否则需要加引号
str: 灰蓝 str1: "Hello World" str2: "Hello World"
转换后输出
{'str': '灰蓝', 'str1': 'Hello World', 'str2': 'Hello World'}
双引号和单引号的区别,单引号中的特殊字符转成python会被转义(原样输出),双引号不会被python转义,最后输出特殊符号
str1: 'Hello World' str2: "Hello World"
转换后输出
{'str1': 'Hello\nWorld', 'str2': 'Hello World'}
6、引用
&和*用于引用
name: &name 无敌
tester: *name
转换后输出
{'name': '无敌', 'tester': '无敌'}
7、强制转换
yaml可以进行强制转换,用!!实现
str: !!str 3.14 int: !!int "123"
转换后输出
{'str': '3.14', 'int': 123}
“123”被强制转换成int,3.14被强制转换成str
8、分段
在同一个yaml文件中,可以用“-”来分段,这样可以将多个文档卸载一个文件中
import yaml f = ''' --- name: James age: 20 --- name: Lily age: 19 ''' y = yaml.load_all(f) for data in y: print(data)
load_all解析全部文档,返回一个迭代对象
打印输出:
{'name': 'James', 'age': 20} {'name': 'Lily', 'age': 19}
二、构造器、表示器、解析器
1、yaml.YAMLObject
用元类来注册一个构造器,把yaml节点转为Python对象实例,用表示器把Python对象转为yaml节点
import yaml class Person(yaml.YAMLObject): yaml_tag='!person' def __init__(self, name, age): self.name= name self.age = age def __repr(self): return '%s(name=%s, age=%d)' % (self.__class__.__name__, self.name, self.age) james = Person('james', 20) print(yaml.dump(james)) #python对象实例转为yaml lily = yaml.load('!person {name:Lily, age:19}') print(lily) #yaml转为python对象实例
输出
!person age: 20 name: james <__main__.Person object at 0x107ad5860>
2、yaml.add_constructor 和 yaml.add_representer
你可能在使用过程中并不想通过上面这类元类的方式,而是想定义正常的类,那么,可以使用这两种方法
import yaml class Person(object): def __init__(self, name, age): self.name = name self.age = age def __repr__(self): return 'Person(%s, %s)' % (self.name, self.age) james = Person('James', 20) print (yaml.dump(james)) # 没加表示器之前 def person_repr(dumper, data): return dumper.represent_mapping(u'!person', {"name": data.name, "age": data.age}) # mapping表示器,用于dict yaml.add_representer(Person, person_repr) # 用add_representer方法为对象添加表示器 print (yaml.dump(james)) # 加了表示器之后 def person_cons(loader, node): value = loader.construct_mapping(node) # mapping构造器,用于dict name = value['name'] age = value['age'] return Person(name, age) yaml.add_constructor(u'!person', person_cons) # 用add_constructor方法为指定yaml标签添加构造器 lily = yaml.load('!person {name: Lily, age: 19}') print (lily)
输出:
!!python/object:__main__.Person age: 20 name: James !person age: 20 name: James Person(Lily, 19)
第一行是没加表示器之前,中间那行是加了表示器之后,变成了规范的格式,最后添加了构造器,能够把 !person 标签转化为Person对象。