|
Packit |
63bb0d |
# YAML support for the Go language
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
Introduction
|
|
Packit |
63bb0d |
------------
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
The yaml package enables Go programs to comfortably encode and decode YAML
|
|
Packit |
63bb0d |
values. It was developed within [Canonical](https://www.canonical.com) as
|
|
Packit |
63bb0d |
part of the [juju](https://juju.ubuntu.com) project, and is based on a
|
|
Packit |
63bb0d |
pure Go port of the well-known [libyaml](http://pyyaml.org/wiki/LibYAML)
|
|
Packit |
63bb0d |
C library to parse and generate YAML data quickly and reliably.
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
Compatibility
|
|
Packit |
63bb0d |
-------------
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
The yaml package supports most of YAML 1.1 and 1.2, including support for
|
|
Packit |
63bb0d |
anchors, tags, map merging, etc. Multi-document unmarshalling is not yet
|
|
Packit |
63bb0d |
implemented, and base-60 floats from YAML 1.1 are purposefully not
|
|
Packit |
63bb0d |
supported since they're a poor design and are gone in YAML 1.2.
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
Installation and usage
|
|
Packit |
63bb0d |
----------------------
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
The import path for the package is *gopkg.in/yaml.v2*.
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
To install it, run:
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
go get gopkg.in/yaml.v2
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
API documentation
|
|
Packit |
63bb0d |
-----------------
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
If opened in a browser, the import path itself leads to the API documentation:
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
* [https://gopkg.in/yaml.v2](https://gopkg.in/yaml.v2)
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
API stability
|
|
Packit |
63bb0d |
-------------
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
The package API for yaml v2 will remain stable as described in [gopkg.in](https://gopkg.in).
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
License
|
|
Packit |
63bb0d |
-------
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
The yaml package is licensed under the Apache License 2.0. Please see the LICENSE file for details.
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
Example
|
|
Packit |
63bb0d |
-------
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
```Go
|
|
Packit |
63bb0d |
package main
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
import (
|
|
Packit |
63bb0d |
"fmt"
|
|
Packit |
63bb0d |
"log"
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
"gopkg.in/yaml.v2"
|
|
Packit |
63bb0d |
)
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
var data = `
|
|
Packit |
63bb0d |
a: Easy!
|
|
Packit |
63bb0d |
b:
|
|
Packit |
63bb0d |
c: 2
|
|
Packit |
63bb0d |
d: [3, 4]
|
|
Packit |
63bb0d |
`
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
// Note: struct fields must be public in order for unmarshal to
|
|
Packit |
63bb0d |
// correctly populate the data.
|
|
Packit |
63bb0d |
type T struct {
|
|
Packit |
63bb0d |
A string
|
|
Packit |
63bb0d |
B struct {
|
|
Packit |
63bb0d |
RenamedC int `yaml:"c"`
|
|
Packit |
63bb0d |
D []int `yaml:",flow"`
|
|
Packit |
63bb0d |
}
|
|
Packit |
63bb0d |
}
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
func main() {
|
|
Packit |
63bb0d |
t := T{}
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
err := yaml.Unmarshal([]byte(data), &t)
|
|
Packit |
63bb0d |
if err != nil {
|
|
Packit |
63bb0d |
log.Fatalf("error: %v", err)
|
|
Packit |
63bb0d |
}
|
|
Packit |
63bb0d |
fmt.Printf("--- t:\n%v\n\n", t)
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
d, err := yaml.Marshal(&t)
|
|
Packit |
63bb0d |
if err != nil {
|
|
Packit |
63bb0d |
log.Fatalf("error: %v", err)
|
|
Packit |
63bb0d |
}
|
|
Packit |
63bb0d |
fmt.Printf("--- t dump:\n%s\n\n", string(d))
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
m := make(map[interface{}]interface{})
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
err = yaml.Unmarshal([]byte(data), &m)
|
|
Packit |
63bb0d |
if err != nil {
|
|
Packit |
63bb0d |
log.Fatalf("error: %v", err)
|
|
Packit |
63bb0d |
}
|
|
Packit |
63bb0d |
fmt.Printf("--- m:\n%v\n\n", m)
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
d, err = yaml.Marshal(&m)
|
|
Packit |
63bb0d |
if err != nil {
|
|
Packit |
63bb0d |
log.Fatalf("error: %v", err)
|
|
Packit |
63bb0d |
}
|
|
Packit |
63bb0d |
fmt.Printf("--- m dump:\n%s\n\n", string(d))
|
|
Packit |
63bb0d |
}
|
|
Packit |
63bb0d |
```
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
This example will generate the following output:
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
```
|
|
Packit |
63bb0d |
--- t:
|
|
Packit |
63bb0d |
{Easy! {2 [3 4]}}
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
--- t dump:
|
|
Packit |
63bb0d |
a: Easy!
|
|
Packit |
63bb0d |
b:
|
|
Packit |
63bb0d |
c: 2
|
|
Packit |
63bb0d |
d: [3, 4]
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
--- m:
|
|
Packit |
63bb0d |
map[a:Easy! b:map[c:2 d:[3 4]]]
|
|
Packit |
63bb0d |
|
|
Packit |
63bb0d |
--- m dump:
|
|
Packit |
63bb0d |
a: Easy!
|
|
Packit |
63bb0d |
b:
|
|
Packit |
63bb0d |
c: 2
|
|
Packit |
63bb0d |
d:
|
|
Packit |
63bb0d |
- 3
|
|
Packit |
63bb0d |
- 4
|
|
Packit |
63bb0d |
```
|
|
Packit |
63bb0d |
|