How to Work with YAML in Go Using `go-yaml`

YAML is a human-friendly data serialization standard that is widely used for configuration files and data exchange between programming languages. In Go, the gopkg.in/yaml.v3 package, commonly referred to as `go-yaml`, is a popular library used to encode and decode YAML data structures.

Installing the `go-yaml` Package

To start working with YAML in Go, you first need to install the `go-yaml` package. You can do this using the Go package manager. Run the following command in your terminal:

go get gopkg.in/yaml.v3

Reading YAML Data

Let's suppose you have the following YAML content that you want to parse into a Go struct:

name: John Doe
age: 30
email: [email protected]

First, define a Go struct that mirrors the structure of your YAML file:

type Person struct {
    Name  string `yaml:"name"`
    Age   int    `yaml:"age"`
    Email string `yaml:"email"`
}

Now, decode the YAML content into this struct:

package main

import (
    "fmt"
    "gopkg.in/yaml.v3"
)

func main() {
    yamlData := []byte(`name: John Doe
age: 30
email: [email protected]`)

    var person Person

    err := yaml.Unmarshal(yamlData, &person)
    if err != nil {
        fmt.Printf("error: %v", err)
        return
    }
    fmt.Printf("Parsed Struct: %+v
", person)
}

Writing YAML Data

Suppose you want to write a Go struct back to YAML. Below is an example of how to encode a Go struct into YAML:

package main

import (
    "fmt"
    "gopkg.in/yaml.v3"
)

type Person struct {
    Name  string `yaml:"name"`
    Age   int    `yaml:"age"`
    Email string `yaml:"email"`
}

func main() {
    person := Person{Name: "Jane Doe", Age: 25, Email: "[email protected]"}

    yamlData, err := yaml.Marshal(&person)
    if err != nil {
        fmt.Printf("error: %v", err)
        return
    }
    fmt.Println(string(yamlData))
}