SYNOPSIS

     use Config::IOD::Reader;
     my $reader = Config::IOD::Reader->new(
         # list of known attributes, with their default values
         # default_section     => 'GLOBAL',
         # enable_encoding     => 1,
         # enable_quoting      => 1,
         # enable_backet       => 1,
         # enable_brace        => 1,
         # allow_encodings     => undef, # or ['base64','json',...]
         # disallow_encodings  => undef, # or ['base64','json',...]
         # allow_directives    => undef, # or ['include','merge',...]
         # disallow_directives => undef, # or ['include','merge',...]
         # allow_bang_only     => 1,
         # enable_expr         => 0,
     );
     my $config_hash = $reader->read_file('config.iod');

DESCRIPTION

    This module reads IOD configuration files (IOD is an INI-like format
    with more precise specification, some extra features, and 99%
    compatible with typical INI format). It is a minimalist alternative to
    the more fully-featured Config::IOD. It cannot write IOD files and is
    optimized for low startup overhead.

EXPRESSION

    # INSERT_BLOCK: lib/Config/IOD/Base.pm expression

ATTRIBUTES

    # INSERT_BLOCK: lib/Config/IOD/Base.pm attributes

METHODS

 new(%attrs) => obj

 $reader->read_file($filename) => hash

    Read IOD configuration from a file. Die on errors.

 $reader->read_string($str) => hash

    Read IOD configuration from a string. Die on errors.

SEE ALSO

    IOD - specification

    Config::IOD - round-trip parser for reading as well as writing IOD
    documents

    IOD::Examples - sample documents

