TOML::Parser - simple toml parser

NAME SYNOPSIS DESCRIPTION METHODS SEE ALSO LICENSE AUTHOR CONTRIBUTOR

SYNOPSIS

use TOML::Parser;
my $parser = TOML::Parser−>new;
my $data = $parser−>parse($toml);

DESCRIPTION

TOML::Parser is a simple toml parser.

This data structure complies with the tests provided at <https://github.com/toml−lang/toml/tree/v0.4.0/tests>.

The v0.4.0 specification is supported.

METHODS

my $parser = TOML::Parser−>new(\%args)

Creates a new TOML::Parser instance.

use TOML::Parser;
# create new parser
my $parser = TOML::Parser−>new();

Arguments can be:

•

"inflate_datetime"

If use it, You can replace inflate "datetime" process. The subroutine of default is "identity". "e.g.) sub { $_[0] }"

use TOML::Parser;
use DateTime;
use DateTime::Format::ISO8601;
# create new parser
my $parser = TOML::Parser−>new(
inflate_datetime => sub {
my $dt = shift;
return DateTime::Format::ISO8601−>parse_datetime($dt);
},
);

•

"inflate_boolean"

If use it, You can replace inflate boolean process. The return value of default subroutine is "Types::Serialiser::true" or "Types::Serialiser::false".

use TOML::Parser;
# create new parser
my $parser = TOML::Parser−>new(
inflate_boolean => sub {
my $boolean = shift;
return $boolean eq 'true' ? 1 : 0;
},
);

•

"strict_mode"

TOML::Parser is using a more flexible rule for compatibility with old TOML of default. If make this option true value, You can parse a toml with strict rule.

use TOML::Parser;
# create new parser
my $parser = TOML::Parser−>new(
strict_mode => 1
);

my $data = $parser−>parse_file($path)
my $data = $parser−>parse_fh($fh)
my $data = $parser−>parse($src)

Transforms a string containing toml to a perl data structure or vice versa.