SYNOPSIS use Config::IOD; my $iod = Config::IOD->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, ); Read IOD document from a file or string, return Config::IOD::Document object: my $doc = $iod->read_file("/path/to/some.iod"); my $doc = $iod->read_string("..."); See Config::IOD::Document for methods available for $doc. EXPRESSION # INSERT_BLOCK: Config::IOD::Base expression ATTRIBUTES # INSERT_BLOCK: Config::IOD::Base attributes METHODS SEE ALSO IOD - specification Config::IOD::Reader - if you just need to read a configuration file, you should probably use this module instead. It's lighter, faster, and has a simpler interface. IOD::Examples - sample documents