mirror of
https://github.com/taigrr/wtf
synced 2025-01-18 04:03:14 -08:00
d2a3e504cf
Output from 'dep status': PROJECT CONSTRAINT VERSION REVISION LATEST PKGS USED cloud.google.com/go v0.23.0 v0.23.0 0fd7230 v0.23.0 1 github.com/briandowns/openweathermap ^0.11.0 0.11 1b87579 0.11 1 github.com/gdamore/encoding branch master branch master b23993c b23993c 1 github.com/gdamore/tcell ^1.0.0 v1.0.0 061d51a v1.0.0 2 github.com/go-test/deep ^1.0.1 v1.0.1 6592d9c v1.0.1 1 github.com/golang/protobuf v1.1.0 v1.1.0 b4deda0 v1.1.0 1 github.com/google/go-github branch master branch master 2ae5df7 2ae5df7 1 github.com/google/go-querystring branch master branch master 53e6ce1 53e6ce1 1 github.com/jessevdk/go-flags ^1.4.0 v1.4.0 c6ca198 v1.4.0 1 github.com/lucasb-eyer/go-colorful v1.0 v1.0 345fbb3 v1.0 1 github.com/mattn/go-runewidth v0.0.2 v0.0.2 9e777a8 v0.0.2 1 github.com/olebedev/config branch master branch master 9a10d05 9a10d05 1 github.com/radovskyb/watcher ^1.0.2 v1.0.2 6145e14 v1.0.2 1 github.com/rivo/tview branch master branch master 71ecf1f 71ecf1f 1 github.com/yfronto/newrelic branch master branch master f7fa0c6 f7fa0c6 1 golang.org/x/net branch master branch master 1e49130 1e49130 2 golang.org/x/oauth2 branch master branch master 1e0a3fa 1e0a3fa 5 golang.org/x/text v0.3.0 v0.3.0 f21a4df v0.3.0 5 google.golang.org/api branch master branch master 00e3bb8 00e3bb8 4 google.golang.org/appengine v1.0.0 v1.0.0 150dc57 v1.0.0 10 gopkg.in/yaml.v2 ^2.2.1 v2.2.1 5420a8b v2.2.1 1 See https://golang.github.io/dep/docs/daily-dep.html
134 lines
2.6 KiB
Markdown
134 lines
2.6 KiB
Markdown
# YAML support for the Go language
|
|
|
|
Introduction
|
|
------------
|
|
|
|
The yaml package enables Go programs to comfortably encode and decode YAML
|
|
values. It was developed within [Canonical](https://www.canonical.com) as
|
|
part of the [juju](https://juju.ubuntu.com) project, and is based on a
|
|
pure Go port of the well-known [libyaml](http://pyyaml.org/wiki/LibYAML)
|
|
C library to parse and generate YAML data quickly and reliably.
|
|
|
|
Compatibility
|
|
-------------
|
|
|
|
The yaml package supports most of YAML 1.1 and 1.2, including support for
|
|
anchors, tags, map merging, etc. Multi-document unmarshalling is not yet
|
|
implemented, and base-60 floats from YAML 1.1 are purposefully not
|
|
supported since they're a poor design and are gone in YAML 1.2.
|
|
|
|
Installation and usage
|
|
----------------------
|
|
|
|
The import path for the package is *gopkg.in/yaml.v2*.
|
|
|
|
To install it, run:
|
|
|
|
go get gopkg.in/yaml.v2
|
|
|
|
API documentation
|
|
-----------------
|
|
|
|
If opened in a browser, the import path itself leads to the API documentation:
|
|
|
|
* [https://gopkg.in/yaml.v2](https://gopkg.in/yaml.v2)
|
|
|
|
API stability
|
|
-------------
|
|
|
|
The package API for yaml v2 will remain stable as described in [gopkg.in](https://gopkg.in).
|
|
|
|
|
|
License
|
|
-------
|
|
|
|
The yaml package is licensed under the Apache License 2.0. Please see the LICENSE file for details.
|
|
|
|
|
|
Example
|
|
-------
|
|
|
|
```Go
|
|
package main
|
|
|
|
import (
|
|
"fmt"
|
|
"log"
|
|
|
|
"gopkg.in/yaml.v2"
|
|
)
|
|
|
|
var data = `
|
|
a: Easy!
|
|
b:
|
|
c: 2
|
|
d: [3, 4]
|
|
`
|
|
|
|
// Note: struct fields must be public in order for unmarshal to
|
|
// correctly populate the data.
|
|
type T struct {
|
|
A string
|
|
B struct {
|
|
RenamedC int `yaml:"c"`
|
|
D []int `yaml:",flow"`
|
|
}
|
|
}
|
|
|
|
func main() {
|
|
t := T{}
|
|
|
|
err := yaml.Unmarshal([]byte(data), &t)
|
|
if err != nil {
|
|
log.Fatalf("error: %v", err)
|
|
}
|
|
fmt.Printf("--- t:\n%v\n\n", t)
|
|
|
|
d, err := yaml.Marshal(&t)
|
|
if err != nil {
|
|
log.Fatalf("error: %v", err)
|
|
}
|
|
fmt.Printf("--- t dump:\n%s\n\n", string(d))
|
|
|
|
m := make(map[interface{}]interface{})
|
|
|
|
err = yaml.Unmarshal([]byte(data), &m)
|
|
if err != nil {
|
|
log.Fatalf("error: %v", err)
|
|
}
|
|
fmt.Printf("--- m:\n%v\n\n", m)
|
|
|
|
d, err = yaml.Marshal(&m)
|
|
if err != nil {
|
|
log.Fatalf("error: %v", err)
|
|
}
|
|
fmt.Printf("--- m dump:\n%s\n\n", string(d))
|
|
}
|
|
```
|
|
|
|
This example will generate the following output:
|
|
|
|
```
|
|
--- t:
|
|
{Easy! {2 [3 4]}}
|
|
|
|
--- t dump:
|
|
a: Easy!
|
|
b:
|
|
c: 2
|
|
d: [3, 4]
|
|
|
|
|
|
--- m:
|
|
map[a:Easy! b:map[c:2 d:[3 4]]]
|
|
|
|
--- m dump:
|
|
a: Easy!
|
|
b:
|
|
c: 2
|
|
d:
|
|
- 3
|
|
- 4
|
|
```
|
|
|