2020-01-05 09:27:25 -05:00
|
|
|
|
# INI
|
|
|
|
|
|
2020-08-17 23:23:45 -05:00
|
|
|
|
[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/go-ini/ini/Go?logo=github&style=for-the-badge)](https://github.com/go-ini/ini/actions?query=workflow%3AGo)
|
|
|
|
|
[![codecov](https://img.shields.io/codecov/c/github/go-ini/ini/master?logo=codecov&style=for-the-badge)](https://codecov.io/gh/go-ini/ini)
|
|
|
|
|
[![GoDoc](https://img.shields.io/badge/GoDoc-Reference-blue?style=for-the-badge&logo=go)](https://pkg.go.dev/github.com/go-ini/ini?tab=doc)
|
|
|
|
|
[![Sourcegraph](https://img.shields.io/badge/view%20on-Sourcegraph-brightgreen.svg?style=for-the-badge&logo=sourcegraph)](https://sourcegraph.com/github.com/go-ini/ini)
|
2019-03-27 06:15:23 -05:00
|
|
|
|
|
|
|
|
|
![](https://avatars0.githubusercontent.com/u/10216035?v=3&s=200)
|
|
|
|
|
|
|
|
|
|
Package ini provides INI file read and write functionality in Go.
|
|
|
|
|
|
2019-05-13 10:38:53 -05:00
|
|
|
|
## Features
|
2019-03-27 06:15:23 -05:00
|
|
|
|
|
2020-08-17 23:23:45 -05:00
|
|
|
|
- Load from multiple data sources(file, `[]byte`, `io.Reader` and `io.ReadCloser`) with overwrites.
|
2019-03-27 06:15:23 -05: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
|
|
|
|
|
|
2019-05-13 10:38:53 -05:00
|
|
|
|
The minimum requirement of Go is **1.6**.
|
2019-03-27 06:15:23 -05:00
|
|
|
|
|
2019-05-13 10:38:53 -05:00
|
|
|
|
```sh
|
|
|
|
|
$ go get gopkg.in/ini.v1
|
2019-03-27 06:15:23 -05:00
|
|
|
|
```
|
|
|
|
|
|
2019-08-23 11:40:30 -05:00
|
|
|
|
Please add `-u` flag to update in the future.
|
|
|
|
|
|
2019-03-27 06:15:23 -05:00
|
|
|
|
## Getting Help
|
|
|
|
|
|
2019-05-13 10:38:53 -05:00
|
|
|
|
- [Getting Started](https://ini.unknwon.io/docs/intro/getting_started)
|
2019-03-27 06:15:23 -05:00
|
|
|
|
- [API Documentation](https://gowalker.org/gopkg.in/ini.v1)
|
2020-08-17 23:23:45 -05:00
|
|
|
|
- 中国大陆镜像:https://ini.unknwon.cn
|
2019-03-27 06:15:23 -05:00
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
This project is under Apache v2 License. See the [LICENSE](LICENSE) file for the full license text.
|