1.9 KiB
1.9 KiB
INI 
Package ini provides INI file read and write functionality in Go.
Features
- Load from multiple data sources(
[]byte, file andio.ReadCloser) with overwrites. - Read with recursion values.
- Read with parent-child sections.
- Read with auto-increment key names.
- Read with multiple-line values.
- Read with tons of helper methods.
- Read and convert values to Go types.
- Read and WRITE comments of sections and keys.
- Manipulate sections, keys and comments with ease.
- Keep sections and keys in order as you parse and save.
Installation
The minimum requirement of Go is 1.6.
$ go get gopkg.in/ini.v1
Please add -u flag to update in the future.
Go Modules
For historical reason, people use two different import paths for this package: github.com/go-ini/ini and gopkg.in/ini.v1. If you get error similar to the following one:
go: finding github.com/go-ini/ini v0.0.0-00010101000000-000000000000
go: github.com/go-ini/ini@v0.0.0-00010101000000-000000000000: unknown revision 000000000000
go: error loading module requirements
It is because one of your dependencies is using deprecated import path github.com/go-ini/ini, you can make a quick fix by adding the following line to your go.mod file (v.1.44.0 was the latest version tagged on master branch):
replace github.com/go-ini/ini => gopkg.in/ini.v1 v1.44.0
Getting Help
License
This project is under Apache v2 License. See the LICENSE file for the full license text.