goyaml

Differences between revisions 9 and 11 (spanning 2 versions)
Revision 9 as of 2011-10-07 14:21:05
Size: 3075
Editor: niemeyer
Comment:
Revision 11 as of 2012-09-20 09:51:36
Size: 3052
Editor: niemeyer
Comment:
Deletions are marked like this. Additions are marked like this.
Line 18: Line 18:
There are still a few missing bits, such as document merging, base-60 floats (WTF), There are still a few missing bits, such as document merging, base-60 floats (WTF?),
Line 26: Line 26:
    http://goneat.org/pkg/launchpad.net/goyaml     http://goneat.org/lp/goyaml
Line 125: Line 125:
$ goinstall launchpad.net/goyaml $ go get launchpad.net/goyaml
Line 132: Line 132:
$ goinstall launchpad.net/gocheck $ go get launchpad.net/gocheck
Line 138: Line 138:
$ gotest $ go test
Line 149: Line 149:
To get in touch, send a message to the Ensemble mailing list at: <ensemble@lists.ubuntu.com> To get in touch, send a message to the Juju mailing list at: <juju-dev@lists.ubuntu.com>

What is it?

The goyaml package enables Go programs to very comfortably encode and decode YAML values.

It was developed within Canonical as part of an experiment related to using the Go language with the juju project.

goyaml internally uses the C libyaml library to parse and generate YAML data fast and reliably. It ships with all the necessary files, though, and has no external dependencies besides Go itself.

Compatibility

goyaml is almost compatible with YAML 1.1, including support for anchors, tags, etc. There are still a few missing bits, such as document merging, base-60 floats (WTF?), and multi-document unmarshalling. These features are not hard to add, and will be introduced as necessary.

API documentation

The API documentation is currently available at:

Example

Here is a simple example which connects to ZooKeeper, waits for the session to be established, and attempts to create a node:

package main

import (
    "launchpad.net/goyaml"
    "fmt"
)

var data = `
a: Easy!
b:
  c: 2
  d: [3, 4]
`

type T struct {
    A string
    B struct{C int; D []int ",flow"}
}

func main() {
    t := T{}

    err := goyaml.Unmarshal([]byte(data), &t)
    if err != nil {
        panic(err)
    }
    fmt.Printf("--- t:\n%v\n\n", t)

    d, err := goyaml.Marshal(&t)
    if err != nil {
        panic(err)
    }
    fmt.Printf("--- t dump:\n%s\n\n", string(d))

    m := make(map[interface{}]interface{})

    err = goyaml.Unmarshal([]byte(data), &m)
    if err != nil {
        panic(err)
    }
    fmt.Printf("--- m:\n%v\n\n", m)

    d, err = goyaml.Marshal(&m)
    if err != nil {
        panic(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

Source code

To obtain the source code, use Bazaar to download it from Launchpad:

$ bzr branch lp:goyaml

Reporting bugs

Please report bugs at:

How to build and install goyaml

To make use of goyaml, just run the following command:

$ go get launchpad.net/goyaml

Running tests

To run tests, first install gocheck with:

$ go get launchpad.net/gocheck

Then run gotest as usual:

$ go test

License

goyaml is licensed under the LGPL.

Contact

This project is being developed under the Ensemble project at Canonical.

To get in touch, send a message to the Juju mailing list at: <juju-dev@lists.ubuntu.com>

goyaml (last edited 2014-12-09 23:25:57 by foka)