mirrors
/
forgejo
mirror of
1
Fork 0
Code Issues Releases Activity
forgejo/vendor/gopkg.in/ini.v1/README.md

1.9 KiB
Raw Blame History

INI Build Status Sourcegraph

Package ini provides INI file read and write functionality in Go.

Features

  • Load from multiple data sources([]byte, file and io.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.