tree: cde82a9956f46cd73a711172a4097cc8f30c3594 [path history] [tgz]
  1. .gitignore
  2. .travis.yml
  3. benchmark.json
  5. benchmark.toml
  6. benchmark.yml
  7. doc.go
  8. example-crlf.toml
  9. example.toml
  10. keysparsing.go
  11. lexer.go
  13. marshal.go
  14. marshal_test.toml
  15. parser.go
  16. position.go
  19. token.go
  20. toml.go
  21. tomltree_create.go
  22. tomltree_write.go


Go library for the TOML format.

This library supports TOML version v0.4.0

GoDoc license Build Status Coverage Status Go Report Card


Go-toml provides the following features for using data parsed from TOML documents:

  • Load TOML documents from files and string data
  • Easily navigate TOML structure using Tree
  • Mashaling and unmarshaling to and from data structures
  • Line & column position data for all parsed elements
  • Query support similar to JSON-Path
  • Syntax errors contain line and column numbers


import ""

Usage example

Read a TOML document:

config, _ := toml.LoadString(`
user = "pelletier"
password = "mypassword"`)
// retrieve data directly
user := config.Get("postgres.user").(string)

// or using an intermediate object
postgresConfig := config.Get("postgres").(*toml.Tree)
password = postgresConfig.Get("password").(string)

Or use Unmarshal:

type Postgres struct {
    User     string
    Password string
type Config struct {
    Postgres Postgres

doc := []byte(`
user = "pelletier"
password = "mypassword"`)

config := Config{}
Unmarshal(doc, &config)
fmt.Println("user=", config.Postgres.User)

Or use a query:

// use a query to gather elements without walking the tree
results, _ := config.Query("$..[user,password]")
for ii, item := range results.Values() {
    fmt.Println("Query result %d: %v", ii, item)


The documentation and additional examples are available at


Go-toml provides two handy command line tools:

  • tomll: Reads TOML files and lint them.

    go install
    tomll --help
  • tomljson: Reads a TOML file and outputs its JSON representation.

    go install
    tomljson --help


Feel free to report bugs and patches using GitHub's pull requests system on pelletier/go-toml. Any feedback would be much appreciated!

Run tests

You have to make sure two kind of tests run:

  1. The Go unit tests
  2. The TOML examples base

You can run both of them using ./


The MIT License (MIT). Read LICENSE.