• Home
  • History
  • Annotate
Name Date Size #Lines LOC

..03-May-2022-

cmd/H05-Jun-2018-313260

query/H05-Jun-2018-2,3331,858

.gitignoreH A D05-Jun-201836 32

.travis.ymlH A D05-Jun-2018612 2423

LICENSEH A D05-Jun-20181.1 KiB2217

README.mdH A D05-Jun-20183.5 KiB13294

benchmark.jsonH A D05-Jun-20183.6 KiB165164

benchmark.shH A D05-Jun-2018874 3224

benchmark.tomlH A D05-Jun-20185.1 KiB245159

benchmark.ymlH A D05-Jun-20181.9 KiB122121

benchmark_test.goH A D05-Jun-20183 KiB193183

doc.goH A D05-Jun-2018789 241

doc_test.goH A D05-Jun-20182.2 KiB10674

example-crlf.tomlH A D05-Jun-2018645 3022

example.tomlH A D05-Jun-2018616 3022

fuzz.goH A D05-Jun-2018472 3225

fuzz.shH A D05-Jun-2018291 1610

keysparsing.goH A D05-Jun-20181.7 KiB8676

keysparsing_test.goH A D05-Jun-20181.7 KiB6452

lexer.goH A D05-Jun-201814.1 KiB751640

lexer_test.goH A D05-Jun-201822 KiB751676

marshal.goH A D05-Jun-201816.9 KiB610465

marshal_test.goH A D05-Jun-201820.9 KiB807706

marshal_test.tomlH A D05-Jun-2018593 3929

parser.goH A D05-Jun-201810.2 KiB431378

parser_test.goH A D05-Jun-201822.3 KiB900791

position.goH A D05-Jun-2018744 3014

position_test.goH A D05-Jun-2018454 3023

test.shH A D05-Jun-20182.5 KiB8962

token.goH A D05-Jun-20182 KiB145124

token_test.goH A D05-Jun-20181.6 KiB6862

toml.goH A D05-Jun-20189.2 KiB368281

toml_test.goH A D05-Jun-20182.1 KiB10786

tomltree_create.goH A D05-Jun-20184 KiB143119

tomltree_create_test.goH A D05-Jun-20183.3 KiB127111

tomltree_write.goH A D05-Jun-20188.3 KiB334280

tomltree_write_test.goH A D05-Jun-20189.3 KiB377326

README.md

1# go-toml
2
3Go library for the [TOML](https://github.com/mojombo/toml) format.
4
5This library supports TOML version
6[v0.4.0](https://github.com/toml-lang/toml/blob/master/versions/en/toml-v0.4.0.md)
7
8[![GoDoc](https://godoc.org/github.com/pelletier/go-toml?status.svg)](http://godoc.org/github.com/pelletier/go-toml)
9[![license](https://img.shields.io/github/license/pelletier/go-toml.svg)](https://github.com/pelletier/go-toml/blob/master/LICENSE)
10[![Build Status](https://travis-ci.org/pelletier/go-toml.svg?branch=master)](https://travis-ci.org/pelletier/go-toml)
11[![Coverage Status](https://coveralls.io/repos/github/pelletier/go-toml/badge.svg?branch=master)](https://coveralls.io/github/pelletier/go-toml?branch=master)
12[![Go Report Card](https://goreportcard.com/badge/github.com/pelletier/go-toml)](https://goreportcard.com/report/github.com/pelletier/go-toml)
13
14## Features
15
16Go-toml provides the following features for using data parsed from TOML documents:
17
18* Load TOML documents from files and string data
19* Easily navigate TOML structure using Tree
20* Mashaling and unmarshaling to and from data structures
21* Line & column position data for all parsed elements
22* [Query support similar to JSON-Path](query/)
23* Syntax errors contain line and column numbers
24
25## Import
26
27```go
28import "github.com/pelletier/go-toml"
29```
30
31## Usage example
32
33Read a TOML document:
34
35```go
36config, _ := toml.Load(`
37[postgres]
38user = "pelletier"
39password = "mypassword"`)
40// retrieve data directly
41user := config.Get("postgres.user").(string)
42
43// or using an intermediate object
44postgresConfig := config.Get("postgres").(*toml.Tree)
45password := postgresConfig.Get("password").(string)
46```
47
48Or use Unmarshal:
49
50```go
51type Postgres struct {
52    User     string
53    Password string
54}
55type Config struct {
56    Postgres Postgres
57}
58
59doc := []byte(`
60[Postgres]
61User = "pelletier"
62Password = "mypassword"`)
63
64config := Config{}
65toml.Unmarshal(doc, &config)
66fmt.Println("user=", config.Postgres.User)
67```
68
69Or use a query:
70
71```go
72// use a query to gather elements without walking the tree
73q, _ := query.Compile("$..[user,password]")
74results := q.Execute(config)
75for ii, item := range results.Values() {
76    fmt.Println("Query result %d: %v", ii, item)
77}
78```
79
80## Documentation
81
82The documentation and additional examples are available at
83[godoc.org](http://godoc.org/github.com/pelletier/go-toml).
84
85## Tools
86
87Go-toml provides two handy command line tools:
88
89* `tomll`: Reads TOML files and lint them.
90
91    ```
92    go install github.com/pelletier/go-toml/cmd/tomll
93    tomll --help
94    ```
95* `tomljson`: Reads a TOML file and outputs its JSON representation.
96
97    ```
98    go install github.com/pelletier/go-toml/cmd/tomljson
99    tomljson --help
100    ```
101
102## Contribute
103
104Feel free to report bugs and patches using GitHub's pull requests system on
105[pelletier/go-toml](https://github.com/pelletier/go-toml). Any feedback would be
106much appreciated!
107
108### Run tests
109
110You have to make sure two kind of tests run:
111
1121. The Go unit tests
1132. The TOML examples base
114
115You can run both of them using `./test.sh`.
116
117### Fuzzing
118
119The script `./fuzz.sh` is available to
120run [go-fuzz](https://github.com/dvyukov/go-fuzz) on go-toml.
121
122## Versioning
123
124Go-toml follows [Semantic Versioning](http://semver.org/). The supported version
125of [TOML](https://github.com/toml-lang/toml) is indicated at the beginning of
126this document. The last two major versions of Go are supported
127(see [Go Release Policy](https://golang.org/doc/devel/release.html#policy)).
128
129## License
130
131The MIT License (MIT). Read [LICENSE](LICENSE).
132