NAME

Getopt::Pad::Config - grouped config file reader and writer

DESCRIPTION

The one owner of the grouped config file structure (group, then option name, then value): loads a file named by an explicit --config (falling back to the defaultPath), merges the autoload chain (later paths override earlier ones), validates group membership while flattening to option/value pairs, and writes the default config file for --create-default-config. It also owns the files themselves: every config file is read and written here as UTF-8, and the Format only translates between that text and the data structure. The default config file is created exclusively (O_EXCL), so an existing file or a symlink at the target is refused without a check-then-create gap, and a parse error is reported without the Perl source location the parser appended. Handed out by the config block via its io reader.

Part of the Getopt::Pad distribution; see its documentation for the user-facing API.

AUTHOR

davenonymous <perl@davenonymous.com>

COPYRIGHT AND LICENSE

Copyright 2026 davenonymous

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.