https://github.com/go-ini/ini

Package ini provides INI file read and write functionality in Go
https://github.com/go-ini/ini

configuration go ini lsif-enabled parser

Last synced: 8 months ago
JSON representation

Package ini provides INI file read and write functionality in Go

• Host: GitHub
• URL: https://github.com/go-ini/ini
• Owner: go-ini
• License: apache-2.0
• Created: 2014-12-18T07:36:37.000Z (about 11 years ago)
• Default Branch: main
• Last Pushed: 2024-05-01T19:51:06.000Z (over 1 year ago)
• Last Synced: 2025-05-09T00:59:13.388Z (9 months ago)
• Topics: configuration, go, ini, lsif-enabled, parser
• Language: Go
• Homepage: https://ini.unknwon.io
• Size: 713 KB
• Stars: 3,503
• Watchers: 76
• Forks: 382
• Open Issues: 64
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/contributing.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-go - ini - Go package to read and write INI files. - :arrow_down:379 - :star:370 (Configuration / Advanced Console UIs)
• go-awesome - INI - `INI` 配置文件解析 (开源类库 / 配置)
• awesome-go - ini - Go package to read and write INI files. (Configuration / Advanced Console UIs)
• fucking-awesome-go - :octocat: ini - Go package for read and write INI files :star: 287 :fork_and_knife: 54 (Configuration / Advanced Console UIs)
• go-awesome-with-star-updatetime - ini - Go package to read and write INI files. (Configuration / Advanced Console UIs)
• fucking-awesome-go - ini - Go package to read and write INI files. (Configuration / Standard CLI)
• go-awesome - INI - Parsing of `INI` configuration file (Open source library / Construction)
• my-awesome - go-ini / ini - :white_check_mark: Package ini provides INI file read and write functionality in Go. (Library)
• awesome-go-cn - ini
• awesome-github-star - ini - ini | 3316 | (Go)
• awesome-go - ini - Go package to read and write INI files. (Configuration / Standard CLI)
• awesome-go-with-stars - ini - 01-10 | (Configuration / Standard CLI)
• awesome-go-cn - ini - ini/ini) (配置 / 标准CLI)
• awesome-go - ini - Package ini provides INI file read and write functionality in Go. - ★ 1170 (Configuration)
• awesome-go - ini - Go package to read and write INI files. (Configuration / Standard CLI)
• awesome-go - ini - Go package to read and write INI files. (Configuration / Standard CLI)
• awesome-go-cn - ini - ini/ini) (配置 / 标准CLI)
• awesome-Char - ini - Go package to read and write INI files. (Configuration / Advanced Console UIs)
• awesome-go - ini - Go package to read and write INI files. (Configuration / Standard CLI)
• awesome-go-plus - ini - Go package to read and write INI files.  (Configuration / Standard CLI)
• awesome-go-cn - ini
• awesome-go - ini
• awesome-go - ini - Go package to read and write INI files. Stars:`3.5K`. (Configuration / Standard CLI)
• awesome-go - ini - Go package to read and write INI files. (Configuration / Standard CLI)
• awesome-go-extra - ini - 12-18T07:36:37Z|2022-08-08T11:35:58Z| (Configuration / Advanced Console UIs)
• awesome-go - ini - Go package to read and write INI files. (Configuration / Advanced Console UIs)
• awesome-go - ini - 一个Go语言包用于读取和写入INI文件。 (<span id="组态-configuration">组态 Configuration</span> / <span id="高级控制台用户界面-advanced-console-uis">高级控制台用户界面 Advanced Console UIs</span>)
• awesome-go - ini - Go package to read and write INI files. (Configuration / Standard CLI)

README

          
# INI

[![GitHub Workflow Status](https://img.shields.io/github/checks-status/go-ini/ini/main?logo=github&style=for-the-badge)](https://github.com/go-ini/ini/actions?query=branch%3Amain)

[![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)

![](https://avatars0.githubusercontent.com/u/10216035?v=3&s=200)

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

## Features

- Load from multiple data sources(file, `[]byte`, `io.Reader` 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.13**.

```sh

$ go get gopkg.in/ini.v1

```

Please add `-u` flag to update in the future.

## Getting Help

- [Getting Started](https://ini.unknwon.io/docs/intro/getting_started)

- [API Documentation](https://gowalker.org/gopkg.in/ini.v1)

- 中国大陆镜像：https://ini.unknwon.cn

## License

This project is under Apache v2 License. See the [LICENSE](LICENSE) file for the full license text.