From dbed732f1e7269d996384fc8742acb1f228600aa Mon Sep 17 00:00:00 2001 From: Alejandro Mery Date: Thu, 31 Aug 2023 17:11:00 +0000 Subject: [PATCH] README: add initial description of the package Signed-off-by: Alejandro Mery --- README.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/README.md b/README.md index e69de29..7a27335 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,39 @@ +# asciigoat's INI parser + +[![Go Reference][godoc-badge]][godoc] +[![Go Report Card][goreport-badge]][goreport] + +`asciigoat.org/ini` is a simple Go library that very loosly parses +[`INI`-style][wikipedia-dosini] documents allowing the implementation +of stricter parsers of similar form. + +**asciigoat** is [MIT](https://opensource.org/license/mit/) licensed. + +[godoc]: https://pkg.go.dev/asciigoat.org/ini +[godoc-badge]: https://pkg.go.dev/badge/asciigoat.org/ini.svg +[goreport]: https://goreportcard.com/report/asciigoat.org/ini +[goreport-badge]: https://goreportcard.com/badge/asciigoat.org/ini + +[godoc-lexer]: https://pkg.go.dev/asciigoat.org/core/lexer +[godoc-parser-parser]: https://pkg.go.dev/asciigoat.org/ini/parser#Parser + +[wikipedia-dosini]: https://en.wikipedia.org/wiki/INI_file + +## Parser + +[`parser.Parser`][godoc-parser-parser] uses +[`asciigoat`'s lexer][godoc-lexer] to process an `INI`-style document +emiting tokens and errors via callbacks. + +## Other Implementations + +* [gcfg](https://pkg.go.dev/gopkg.in/gcfg.v1) +* [unknwon's go-ini](https://github.com/go-ini/ini) +* [wlevene's GoINI](https://github.com/wlevene/ini) + +## See also + +* [asciigoat.org/core](https://asciigoat.org/core) +* [oss.jpi.io](https://oss.jpi.io) +* [INI file][wikipedia-dosini] (_wikipedia_) +* [TOML](https://www.kelche.co/blog/go/toml/)