search

chzhiyi / -KnowledgeShare

6 stars 1 forks source link

20190527 - YAML文件格式 - baijing #76

Open KeepInLove1006 opened 5 years ago

KeepInLove1006 commented 5 years ago

YAML语言

YAML 语言的设计目标，就是方便人类读写，它实质上是一种通用的数据串行化格式。

它的基本语法规则如下：

1、大小写敏感

2、使用缩进表示层级关系

3、缩进时不允许使用tab键，只允许空格

4、缩进的空格数目不重要，只要相同层级的元素左侧对齐即可

# 表示注释，从这个字符一直到行尾，都会被解释器忽略

YAML支持的格式有三种

对象：键值对的集合，又称为映射（mapping）/ 哈希（hashes） / 字典（dictionary）

数组：一组按次序排列的值，又称为序列（sequence） / 列表（list）

纯量（scalars）：单个的、不可再分的值

一、对象

对象的一组键值对，使用冒号结构表示

name:baijing

{'name': 'baijing'}

Yaml 也允许另一种写法，将所有键值对写成一个行内对象

hash: { name: baijing, age: 24 }

{'hash': {'name': 'baijing', 'age': 24}}

二、数组

一组连词线开头的行，构成一个数组

- baijing
- bailian
- jingchu
['baijing', 'bailian', 'jingchu']

数据结构的子成员是一个数组，则可以在该项下面缩进一个空格

-
 - baijing
 - bailian
 - jingchu
[['baijing', 'bailian', 'jingchu']]

数组也可以采用行内表示法

name: [baijing, jingchu, bailian]
{'name': ['baijing', 'jingchu', 'bailian']}

三、纯量

数值直接以字面量的形式表示

age: 24
age1: 12.30
{'age': 24, 'age1': 12.3}

布尔值用true和false表示

isSet: true
isSet: false
{'isSet': True, 'isSet1': False}

null用~表示

parent: ~ 
{'parent': None}

时间采用 ISO8601 格式

iso8601: 2001-12-14t21:59:43.10-05:00
{'iso8601': datetime.datetime(2001, 12, 15, 2, 59, 43, 100000)}

日期采用复合 iso8601 格式的年、月、日表示

date: 1976-07-31
{'date': datetime.date(1976, 7, 31)}

YAML 允许使用两个感叹号，强制转换数据类型

e: !!str 123
f: !!str true
{'e': '123', 'f': 'true'}
字符串

字符串是最常见，也是最复杂的一种数据类型。

字符串默认不使用引号表示

str1: 这是一行字符串
{'str1': '这是一行字符串'}

如果字符串之中包含空格或特殊字符，需要放在引号之中

st2r: '姓名： 白鲸'
{'st2': '姓名： 白鲸'}

单引号和双引号都可以使用，双引号不会对特殊字符转义

s1: '姓名\n白莲'
s2: "姓名\n乔松"
{'s1': '姓名\\n白莲', 's2': '姓名\n乔松'}

单引号之中如果还有单引号，必须连续使用两个单引号转义

str: '白鲸''乔松' 
{'str4': "白鲸'乔松"}

字符串可以写成多行，从第二行开始，必须有一个单空格缩进。换行符会被转为空格

str: 这是一段
  多行
  字符串
{'str3': '这是一段 多行 字符串'}

多行字符串可以使用|保留换行符，也可以使用>折叠换行

    club: |
      name:baijing
      age:25
    that: >
      name:bailian
      age:25

{'club': 'name:baijing\nage:25\n', 'that': 'name:bailian age:25\n'}

+表示保留文字块末尾的换行，-表示删除字符串末尾的换行

s1: |
  Foo

s2: |+
  Foo

s3: |-
  Foo

{'s0': 'Foo\n', 's4': 'Foo\n\n', 's3': 'Foo'}

字符串之中可以插入 HTML 标记

message: |

  <p style="color: red">
    段落
  </p>

{'message': '\n<p style="color: red">\n  段落\n</p>\n'}