ini

package module
v0.2.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 4, 2023 License: MIT Imports: 0 Imported by: 0

README

asciigoat's INI parser

Go Reference Go Report Card

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

Documentation

Overview

Package ini implements a general purpose dosini-like parser

Directories

Path Synopsis
Package basic provides a basic representation of dosini-style documents
Package basic provides a basic representation of dosini-style documents
Package parser parses ini-style files
Package parser parses ini-style files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL