2017-02-17 16:49:51 +00:00
INI [](https://travis-ci.org/go-ini/ini) [](https://sourcegraph.com/github.com/go-ini/ini?badge)
2016-10-31 15:50:02 +00:00
===

Package ini provides INI file read and write functionality in Go.
2018-05-02 17:09:45 +01:00
## Features
2016-10-31 15:50:02 +00:00
2018-05-02 17:09:45 +01:00
- Load from multiple data sources(`[]byte` , file and `io.ReadCloser` ) with overwrites.
2016-10-31 15:50:02 +00:00
- 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
To use a tagged revision:
2018-05-02 17:09:45 +01:00
```sh
$ go get gopkg.in/ini.v1
2016-10-31 15:50:02 +00:00
```
2018-05-02 17:09:45 +01:00
To use with latest changes:
2016-10-31 15:50:02 +00:00
2018-05-02 17:09:45 +01:00
```sh
$ go get github.com/go-ini/ini
2016-10-31 15:50:02 +00:00
```
2018-05-02 17:09:45 +01:00
Please add `-u` flag to update in the future.
2016-10-31 15:50:02 +00:00
## Getting Help
2018-05-02 17:09:45 +01:00
- [Getting Started ](https://ini.unknwon.io/docs/intro/getting_started )
2016-10-31 15:50:02 +00:00
- [API Documentation ](https://gowalker.org/gopkg.in/ini.v1 )
## License
This project is under Apache v2 License. See the [LICENSE ](LICENSE ) file for the full license text.