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

..03-May-2022-

.github/ISSUE_TEMPLATE/H17-May-2020-4128

cmd/H17-May-2020-625516

query/H17-May-2020-2,7512,188

.dockerignoreH A D17-May-202038 32

.gitignoreH A D17-May-2020102 65

CONTRIBUTING.mdH A D17-May-20204.9 KiB13399

DockerfileH A D17-May-2020319 1210

LICENSEH A D17-May-20201.1 KiB2217

MakefileH A D17-May-2020631 3022

PULL_REQUEST_TEMPLATE.mdH A D17-May-2020203 63

README.mdH A D17-May-20204.2 KiB152109

azure-pipelines.ymlH A D17-May-20205.9 KiB231224

benchmark.jsonH A D17-May-20203.6 KiB165164

benchmark.shH A D17-May-2020829 3223

benchmark.tomlH A D17-May-20205.1 KiB245159

benchmark.ymlH A D17-May-20201.9 KiB122121

benchmark_test.goH A D17-May-20203 KiB193183

doc.goH A D17-May-2020789 241

doc_test.goH A D17-May-20203.5 KiB171113

example-crlf.tomlH A D17-May-2020730 3023

example.tomlH A D17-May-2020701 3023

fuzz.goH A D17-May-2020472 3225

fuzz.shH A D17-May-2020291 1610

fuzzit.shH A D17-May-2020990 279

go.modH A D17-May-2020153 107

go.sumH A D17-May-20201.5 KiB2019

keysparsing.goH A D17-May-20202.4 KiB11397

keysparsing_test.goH A D17-May-20202.1 KiB8064

lexer.goH A D17-May-202015.7 KiB802663

lexer_test.goH A D17-May-202029.5 KiB979886

localtime.goH A D17-May-20209.7 KiB282139

localtime_test.goH A D17-May-202012.4 KiB447409

marshal.goH A D17-May-202034.4 KiB1,241982

marshal_OrderPreserve_test.tomlH A D17-May-2020622 4030

marshal_test.goH A D17-May-202089.1 KiB3,8513,359

marshal_test.tomlH A D17-May-2020622 4030

parser.goH A D17-May-202011.8 KiB494429

parser_test.goH A D17-May-202027.9 KiB1,1391,004

position.goH A D17-May-2020744 3014

position_test.goH A D17-May-2020454 3023

token.goH A D17-May-20201.9 KiB135115

token_test.goH A D17-May-20201.6 KiB6963

toml.goH A D17-May-202010.2 KiB400304

toml_test.goH A D17-May-20203.7 KiB181151

toml_testgen_support_test.goH A D17-May-20203 KiB120103

toml_testgen_test.goH A D17-May-202021.6 KiB929835

tomltree_create.goH A D17-May-20204 KiB143119

tomltree_create_test.goH A D17-May-20203.3 KiB127111

tomltree_write.goH A D17-May-202012.6 KiB518438

tomltree_write_test.goH A D17-May-20209.7 KiB402347

README.md

1# go-toml
2
3Go library for the [TOML](https://github.com/mojombo/toml) format.
4
5This library supports TOML version
6[v1.0.0-rc.1](https://github.com/toml-lang/toml/blob/master/versions/en/toml-v1.0.0-rc.1.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://dev.azure.com/pelletierthomas/go-toml-ci/_apis/build/status/pelletier.go-toml?branchName=master)](https://dev.azure.com/pelletierthomas/go-toml-ci/_build/latest?definitionId=1&branchName=master)
11[![codecov](https://codecov.io/gh/pelletier/go-toml/branch/master/graph/badge.svg)](https://codecov.io/gh/pelletier/go-toml)
12[![Go Report Card](https://goreportcard.com/badge/github.com/pelletier/go-toml)](https://goreportcard.com/report/github.com/pelletier/go-toml)
13[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fpelletier%2Fgo-toml.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fpelletier%2Fgo-toml?ref=badge_shield)
14
15## Features
16
17Go-toml provides the following features for using data parsed from TOML documents:
18
19* Load TOML documents from files and string data
20* Easily navigate TOML structure using Tree
21* Marshaling and unmarshaling to and from data structures
22* Line & column position data for all parsed elements
23* [Query support similar to JSON-Path](query/)
24* Syntax errors contain line and column numbers
25
26## Import
27
28```go
29import "github.com/pelletier/go-toml"
30```
31
32## Usage example
33
34Read a TOML document:
35
36```go
37config, _ := toml.Load(`
38[postgres]
39user = "pelletier"
40password = "mypassword"`)
41// retrieve data directly
42user := config.Get("postgres.user").(string)
43
44// or using an intermediate object
45postgresConfig := config.Get("postgres").(*toml.Tree)
46password := postgresConfig.Get("password").(string)
47```
48
49Or use Unmarshal:
50
51```go
52type Postgres struct {
53    User     string
54    Password string
55}
56type Config struct {
57    Postgres Postgres
58}
59
60doc := []byte(`
61[Postgres]
62User = "pelletier"
63Password = "mypassword"`)
64
65config := Config{}
66toml.Unmarshal(doc, &config)
67fmt.Println("user=", config.Postgres.User)
68```
69
70Or use a query:
71
72```go
73// use a query to gather elements without walking the tree
74q, _ := query.Compile("$..[user,password]")
75results := q.Execute(config)
76for ii, item := range results.Values() {
77    fmt.Printf("Query result %d: %v\n", ii, item)
78}
79```
80
81## Documentation
82
83The documentation and additional examples are available at
84[godoc.org](http://godoc.org/github.com/pelletier/go-toml).
85
86## Tools
87
88Go-toml provides two handy command line tools:
89
90* `tomll`: Reads TOML files and lints them.
91
92    ```
93    go install github.com/pelletier/go-toml/cmd/tomll
94    tomll --help
95    ```
96* `tomljson`: Reads a TOML file and outputs its JSON representation.
97
98    ```
99    go install github.com/pelletier/go-toml/cmd/tomljson
100    tomljson --help
101    ```
102
103 * `jsontoml`: Reads a JSON file and outputs a TOML representation.
104
105    ```
106    go install github.com/pelletier/go-toml/cmd/jsontoml
107    jsontoml --help
108    ```
109
110### Docker image
111
112Those tools are also availble as a Docker image from
113[dockerhub](https://hub.docker.com/r/pelletier/go-toml). For example, to
114use `tomljson`:
115
116```
117docker run -v $PWD:/workdir pelletier/go-toml tomljson /workdir/example.toml
118```
119
120Only master (`latest`) and tagged versions are published to dockerhub. You
121can build your own image as usual:
122
123```
124docker build -t go-toml .
125```
126
127## Contribute
128
129Feel free to report bugs and patches using GitHub's pull requests system on
130[pelletier/go-toml](https://github.com/pelletier/go-toml). Any feedback would be
131much appreciated!
132
133### Run tests
134
135`go test ./...`
136
137### Fuzzing
138
139The script `./fuzz.sh` is available to
140run [go-fuzz](https://github.com/dvyukov/go-fuzz) on go-toml.
141
142## Versioning
143
144Go-toml follows [Semantic Versioning](http://semver.org/). The supported version
145of [TOML](https://github.com/toml-lang/toml) is indicated at the beginning of
146this document. The last two major versions of Go are supported
147(see [Go Release Policy](https://golang.org/doc/devel/release.html#policy)).
148
149## License
150
151The MIT License (MIT). Read [LICENSE](LICENSE).
152