YAML 语言入门教程 转

YAML简介

另一种标记语言(Yet Another Markup Language) YAML(英语发音:/ˈjæməl/,尾音类似camel骆驼)是一个可读性高,用来表达资料序列的格式。YAML参考了其他多种语言,包括:C语言、Python、Perl,并从XML、电子邮件的数据格式(RFC 2822)中获得灵感。Clark Evans在2001年首次发表了这种语言[1],另外Ingy döt Net与Oren >Ben-Kiki也是这语言的共同设计者[2]。目前已经有数种编程语言或脚本语言支援(或者说解析)这种语言。 ——维基百科

YAML 仍然是一门标记性语言,但为了强调这门语言以数据为中心,而不是以标记语言为中心。采用反向缩略语重新命名。

基本语法规则:

  1.大小写敏感
  2.使用缩进表示层级关系
  3.不允许使用TAB键来缩进,只允许使用空格键来缩进
  4.缩进的空格数量不重要
  5.使用"#"来表示注释

支持的数据格式:

 1.对象:键值对的集合,又称映射(mapping) / 哈希(hashes)/ 字典(dictionary)
 2.数组: 一组按次序排列的值,又称序列(sequence) / 列表(list)
 3.纯量(scalars):单个的,不可再分的值

以下分别介绍这三种数据格式

对象

对象的一组键值对,是用冒号结构来表示

animal: pets

转为JavaScript

{ animal: 'pets' }

YAML也支持另一种写法,将所有的键值对写成一个行内对象

hash: { name: steve, foo: bar }

转为JavaScript

{ hash: { name: 'steve', foo: 'bar'}}

数组

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

- Cat
- Dog
- Goldfish

转为JavaScript

[ 'Cat', 'Dog', 'Goldfish' ]

数据的子结构也是一个数组,可以在该项下面缩进空格来表示层级关系

-
  - Cat
  - Dog
  - Goldfish

转为JavaScript

[ [ 'Cat', 'Dog', 'Goldfish'] ]

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

animal: [Cat, Dog]

转为JavaScript

{ animal: ['Cat', 'Dog']}

复合结构

对象和数组可以结合使用,形成复合结构

languages:
  - Ruby
  - Perl
  - Python
websites:
  YAML: yaml.org
  Ruby: ruby-lang.org
  Python: python.org
  Perl: user.perl.org

转为JavaScript

{
  languages: [ 'Ruby', 'Perl', 'Python'],
  websites:
  {
    YAML: 'yaml.org',
    Ruby: 'ruby-lang.org',
    Python: 'python.org',
    Perl: 'user.perl.org'
  }
}

纯量

纯量是最基本的、不可再分的值。 以下数据类型都是javaScript的纯量。

 - 字符串
 - 布尔值
 - 整数
 - 浮点数
 - null
 - 时间
 - 日期

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

number: 12.30

转为JavaScript

{ number: 12.30 }

布尔值以true 和false 来表示

isSet: true

转为JavaScript

{ isSet: true }

null用 ~ 表示

parent: ~

转为JavaScript

{ parent: null }

时间用 ISO8601 格式

iso8601: 2001-12-14t21:59:43.10-05:00

转为JavaScript

{ iso8601: new Date('2001-12-14t21:59:43.10-05:00') }

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

 date: 1976-12-20

转为JavaScript

{ date: new Date('1976-12-20') }

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

 e: !!str 123
 f: !!str true

转为JavaScript

{ e: '123', f: 'true'}

字符串

字符串是最常见,也是最复杂的一种数据类型。 字符串默认不适用引号表示。

str : 这是一行字符串

转为JavaScript

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

如果字符串之间存在空格或其他特殊字符,需放在单引号之中。

str: '内容: 字符串'

转为JavaScript

{ str: '内容: 字符串'}

单引号和双引号都可以使用,双引号不会对特殊字符进行转义。

s1: '内容\n字符串'
s2: "内容\n字符串"

转为JavaScript

{ s1: '内容\\n字符串', s2: '内容\n字符串'}

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

str: 'labor''s day'

转为JavaScript

{ str: 'labor\'s day'}

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

str: 这是一段
  多行
  字符串

转为JavaScript

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

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

this: |
  Foo
  Bar
that: >
  Foo
  Bar

转为JavaScript

{ this: 'Foo\nBar\n', that:'Foo Bar\n' }

“ + ” 表示保留文字块末尾的换行,-表示删除字符串末尾的换行。

s1: |
      Foo

s2: |+
    Foo



s3: |-
    Foo

转为JavaScript

{ s1: 'Foo\n', s2: 'Foo\n\n\n', s3:'Foo' }

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

message: |

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

转为JavaScript

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

引用

锚点 & 和别名 * , 可以用来引用

defaults: &defaults
    adapter: postgres
    host: localhost

development:
   database: myapp_development,
   <<: *defaults

test:
    database: myapp_test,
    <<: *defaults

相当于

defaults: 
    adapter: postgres
    host: localhost

development:
   database: myapp_development,
   adapter: postgres
    host: localhost

test:
    database: myapp_test,
    adapter: postgres
    host: localhost

&用来建立锚点(defaults),<<表示合并到当前数据,*用来引用锚点。

下面另外一个例子

- &showell Steve 
- Clark 
- Brian 
- Oren 
- *showell

转为JavaScript

[ 'Steve', 'Clark', 'Brian', 'Oren', 'Steve' ]

函数和正则表达式的转换

这是js-yaml库特有的功能,可以把函数和正则表达式转为字符串

#exmaple.yml
fn: function() { return 1 }
reg: /test/

解析上面的yml文件代码如下:

var yaml = require('js-yaml');
var fs = require('fs');
try{
   var doc = yaml.load(
       fs.readFileSync('./example.yml', 'utf8')
   );
} catch(e){
      console.warn(e);
}

从javaScript对象还原到yaml代码如下:

 var yaml = require('js-yaml');
 var fs = require('fs');
 var obj = {
    fn: function() { return 1 },
    reg: /test/
 }

 try{
     fs.writeFileSync('./exmaple.js', yama.dump(obj), 'utf8')
 } catch(e) {
    console.log(e);
 }

参考链接

本文转载自:http://frontenddev.org/article/yaml-language-introductory-tutorial.html

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏Golang语言社区

Go 语言简介(上)— 语法

Hello World package main //声明本文件的package名 import "fmt" //import语言的fmt库——用于输出 f...

4048
来自专栏阮一峰的网络日志

YAML 语言教程

编程免不了要写配置文件,怎么写配置也是一门学问。 YAML 是专门用来写配置文件的语言,非常简洁和强大,远比 JSON 格式方便。 本文介绍 YAML 的语法,...

3406
来自专栏极客慕白的成长之路

JS实用技巧手记之八

除特别注明外,本站所有文章均为慕白博客原创,转载请注明出处来自https://geekmubai.com/programming/157.html

1543
来自专栏我的小碗汤

go语言正则表达式

我们前两节课爬取珍爱网的时候,用到了很多正则表达式去匹配城市列表、城市、用户信息,其实除了正则表达式去匹配,还可以利用goquery和xpath第三方库匹配有用...

1284
来自专栏landv

Golang 新手可能会踩的 50 个坑【转】

译文:https://github.com/wuYin/blog/blob/master/50-shades-of-golang-traps-gotchas-m...

3132
来自专栏Python爬虫实战

Google Python风格规范(上)

好的代码风格,给人舒服的感觉,今天介绍一下谷歌的Python风格规范,由于规范比较多,将分为两次介绍。

1112
来自专栏C/C++基础

web前端开发初学者十问集锦(4)

利用JS来控制页面控件的显示和隐藏有两种方法,两种方法分别利用HTML的style中的两个属性,两种方法的不同之处在于控件隐藏后是否还在页面上占空位。

1742
来自专栏专注 Java 基础分享

struts2标签库----控制标签详解

     前面几篇文章我们介绍了有关struts2的基本内容,简单理解了整个框架的运作流程。从本篇开始我们逐渐了解和使用struts2为我们提供的标签库技术,使...

19810
来自专栏Golang语言社区

【Go 语言社区】Golang源码解读之map

golang的map实现并不是像c++一样使用红黑树,而是使用了hashmap,用数组来实现。 详细的实现后续补充,这里先做个备忘。 在iterate整个map...

3053
来自专栏Python爬虫实战

Python数据类型之字符串

字符串就是一系列的字符。Python中,用配对的引号括起来的都是字符串,其中引号可以是单引号也可以是双引号:

882

扫码关注云+社区

领取腾讯云代金券