You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
techknowlogick 1c3278c2fa
update revive lint to latest commit (#12921)
3 vuotta sitten
..
.dockerignore Use vendored go-swagger (#8087) 4 vuotta sitten
.gitignore Use vendored go-swagger (#8087) 4 vuotta sitten
CONTRIBUTING.md Use vendored go-swagger (#8087) 4 vuotta sitten
Dockerfile [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
LICENSE Use vendored go-swagger (#8087) 4 vuotta sitten
Makefile [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
PULL_REQUEST_TEMPLATE.md Use vendored go-swagger (#8087) 4 vuotta sitten
README.md [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
azure-pipelines.yml update revive lint to latest commit (#12921) 3 vuotta sitten
benchmark.sh update revive lint to latest commit (#12921) 3 vuotta sitten
doc.go [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
example-crlf.toml [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
example.toml [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
fuzz.go Use vendored go-swagger (#8087) 4 vuotta sitten
fuzz.sh Use vendored go-swagger (#8087) 4 vuotta sitten
fuzzit.sh [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
go.mod update revive lint to latest commit (#12921) 3 vuotta sitten
go.sum [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
keysparsing.go [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
lexer.go update revive lint to latest commit (#12921) 3 vuotta sitten
localtime.go [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
marshal.go update revive lint to latest commit (#12921) 3 vuotta sitten
marshal_OrderPreserve_test.toml [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
marshal_test.toml [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
parser.go [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
position.go Use vendored go-swagger (#8087) 4 vuotta sitten
token.go [Vendor] update go-swagger v0.21.0 -> v0.25.0 (#12670) 3 vuotta sitten
toml.go update revive lint to latest commit (#12921) 3 vuotta sitten
tomltree_create.go update revive lint to latest commit (#12921) 3 vuotta sitten
tomltree_write.go update revive lint to latest commit (#12921) 3 vuotta sitten

README.md

go-toml

Go library for the TOML format.

This library supports TOML version v1.0.0-rc.1

GoDoc license Build Status codecov Go Report Card FOSSA Status

Features

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
  • Marshaling 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

import "github.com/pelletier/go-toml"

Usage example

Read a TOML document:

config, _ := toml.Load(`
[postgres]
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(`
[Postgres]
User = "pelletier"
Password = "mypassword"`)

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

Or use a query:

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

Documentation

The documentation and additional examples are available at godoc.org.

Tools

Go-toml provides two handy command line tools:

  • tomll: Reads TOML files and lints them.

    go install github.com/pelletier/go-toml/cmd/tomll
    tomll --help
    
  • tomljson: Reads a TOML file and outputs its JSON representation.

    go install github.com/pelletier/go-toml/cmd/tomljson
    tomljson --help
    
    • jsontoml: Reads a JSON file and outputs a TOML representation.
    go install github.com/pelletier/go-toml/cmd/jsontoml
    jsontoml --help
    

Docker image

Those tools are also availble as a Docker image from dockerhub. For example, to use tomljson:

docker run -v $PWD:/workdir pelletier/go-toml tomljson /workdir/example.toml

Only master (latest) and tagged versions are published to dockerhub. You can build your own image as usual:

docker build -t go-toml .

Contribute

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

go test ./...

Fuzzing

The script ./fuzz.sh is available to run go-fuzz on go-toml.

Versioning

Go-toml follows Semantic Versioning. The supported version of TOML is indicated at the beginning of this document. The last two major versions of Go are supported (see Go Release Policy).

License

The MIT License (MIT). Read LICENSE.