uci

type ErrConfigAlreadyLoaded struct {
	Name string
}

type ErrSectionNotFound struct {
	Section string
}

type ErrSectionTypeMismatch struct {
	Config, Section string // name
	ExistingType    string
	NewType         string
}

type ErrUnknownOptionType struct {
	Type string
}

type OptionType int

type ParseError struct {
	// contains filtered or unexported fields
}

type SectionOption struct {
	Name string     `json:"name,omitempty"` // Option name/key
	Type OptionType `json:"type,omitempty"` // Expected data type
}

type Tree interface {
	// LoadConfig reads a config file into memory and returns nil. If the
	// config is already loaded, and forceReload is false, an error of type
	// ErrConfigAlreadyLoaded is returned. Errors reading the config file
	// are returned verbatim.
	//
	// You don't need to explicitly call LoadConfig(): Accessing configs
	// (and their sections) via Get, Set, Add, Delete, DeleteAll will
	// load missing files automatically.
	LoadConfig(name string, forceReload bool) error

	// Commit writes all changes back to the system.
	//
	// Note: this is not transaction safe. If, for whatever reason, the
	// writing of any file fails, the succeeding files are left untouched
	// while the preceding files are not reverted.
	Commit() error

	// Revert undoes changes to the config files given as arguments. If
	// no argument is given, all changes are reverted. This clears the
	// internal memory and does not access the file system.
	Revert(configs ...string)

	// GetSections returns the names of all sections of a certain type
	// in a config, and an error indicating whether the operation was
	// successful.
	GetSections(config, secType string) ([]string, error)

	// GetSectionOptions returns metadata for all configuration options
	// available in the specified section.
	//
	// The returned slice contains option names and their expected types,
	// but not current values.
	//
	// Returns an error if:
	//   - the config was not loaded into the tree;
	//   - the section doesn't exist.
	GetSectionOptions(config string, section string) ([]SectionOption, error)

	// Get retrieves (all) values for a fully qualified option, and a
	// boolean indicating whether the config file and the config section
	// within exists.
	Get(config, section, option string) ([]string, bool)

	// GetLoaded works like Get but operates strictly on the in-memory configuration state.
	// It does not attempt to load the config file from disk if the config or option is
	// missing. This is useful for verifying changes (like deletions) before they are committed.
	GetLoaded(config, section, option string) ([]string, bool)

	// GetLast retrieves the last value that was defined for a fully
	// qualified option, and a boolean indicating whether the config file,
	// config section and the option exists.
	GetLast(config, section, option string) (string, bool)

	// GetBool works the same way as GetLast does but interprets the last
	// specified value as a boolean.  If the found value can't be
	// interpreted as either true or false, it will return nil and false.
	GetBool(config, section, option string) (bool, bool)

	// SetType replaces the fully qualified option with the given values.
	// It returns whether the config file and section exists. For new
	// files and sections, you first need to initialize them with
	// AddSection().
	SetType(config, section, option string, typ OptionType, values ...string) error

	// Del removes a fully qualified option.
	Del(config, section, option string) error

	// AddSection adds a new config section. If the section already exists,
	// and the types match (existing type and given type), nothing happens.
	// Otherwise an ErrSectionTypeMismatch is returned.
	AddSection(config, section, typ string) error

	// DelSection remove a config section and its options.
	DelSection(config, section string) error
}