README
¶
asciigoat's INI parser
asciigoat.org/ini is a simple Go library that very loosly parses
INI-style documents allowing the implementation
of stricter parsers of similar form.
asciigoat is MIT licensed.
Parser
parser.Parser uses
asciigoat's lexer to process an INI-style document
emiting tokens and errors via callbacks.
Basic Parser
basic.Decode() provies a one-shot decoder
that returns a structured document for you to post-process.
To allow for correct handling of repetition of section and field names downstream, it uses arrays instead of maps, and makes almost no judgment about what section or field names are acceptable.
Other Implementations
Other implementations exist, and they are mature and feature-rich, but they are highly opinionated about what's a valid file. Built around maps they don't allow repeating names and constraint what characters can be used.
These are great when you can adapt, or already agree, to their conditions but that's not always the case when you are parsing configuration files from other applications and that's what asciigoat.org/ini attempts to solve.
See also
- asciigoat.org/core
- oss.jpi.io
- INI file (wikipedia)
- TOML
Documentation
Source Files
Directories