read INI-style configuration files into Go structs; supports user-defined types and subsections
gcfg.ReadFileInto now skips a single leading UTF8 BOM sequence if it exists. gcfg now requires at least Go 1.2 to build.
allow escaped double-quotes in unquoted string values
This release adds location information to parsing erros, as requested in #11 .
This release adds support for warnings (non-fatal errors). Now it is possible to ignore errors from extra data that cannot be stored into the configuration struct, as requested (among others) in #2. See Error handling and gcfg.FatalOnly for details. This feature has been enabled by the new warnings.v0 package.
This release adds support for subsection defaults. Default values can be provided for subsection if there is a corresponding section default-<sectionname>
. The values can either be set programmatically by pre-setting the fields in struct Default_<sectionname>
, or from the configuration data in the section default-<sectionname>
. As usual, configuration file values override pre-set field values. Default values are only applied to newly defined subsections (those for which a map value did not exist prior to reading the configuration data). The struct Default_<sectionname>
must be gob-encodeable (gob-encoding/decoding is used for deep-copying of the struct values).
initial release