tinyini

README

tinyini

tinyini is a minimalistic library for parsing INI-like configuration files.

example configuration file

globalkey = globalvalue

[section]
key = first-value
key = second-value
empty=
anotherkey = "  has whitespace   "

[änöther-section] ; this is a comment and ignored
key = different value

Documentation

Overview

package tinyini provides an extremely bare-bones library for parsing INI-like configuration files. For details, see the documentation for function Parse.

Index

• func Parse(r io.Reader) (result map[string]Section, errs []error)
• type IniError
  • func (i *IniError) Error() string
  • func (i *IniError) Unwrap() error
• type Pair
• type Section

Functions

func Parse

func Parse(r io.Reader) (result map[string]Section, errs []error)

Parse will produce a map of Section from an io.Reader. The caller should note that Parse returns a slice of errors in the order of occurrence, so the condition for success is len(errs) == 0.

Parse will parse as much as possible even when encountering errors, so result may contain something useful even if len(errs) > 0.

The global section is given with the empty section name "". Otherwise the section names will be whatever valid UTF-8 is found between the brackets '[' and ']'.

Parse ignores whitespace around section headers, keys, and non-quoted values. If the value should contain whitespace in its beginning or end, enclose the whole value in quotes (" value with whitespaces ").

Quotes may be contained in quoted values by escaping them with the backslash like \". Escaped quotes will be unquoted when parsing, but all other seemingly "escaped" values like \n are ignored and left verbatim.

All keys may contain multiple values. Their additional values are appended to their respective section in the order of appearance.

Types

type IniError

type IniError struct {
	Line int
	// contains filtered or unexported fields
}

IniError describes a parsing error and provides its line number.

func (*IniError) Error

func (i *IniError) Error() string

func (*IniError) Unwrap

func (i *IniError) Unwrap() error

type Pair

type Pair struct {
	Value  string
	Lineno int
}

type Section

type Section map[string][]Pair

Section contains all configuration key-values of a single bracketed section ("[example-section]"). All key-values may contain multiple values. The values are given in the order of occurrence.