TOML::Parser3pm

Usage

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

Overview

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.

Contributor

Olivier Mengue <[email protected]> yowcow <[email protected]> Syohei YOSHIDA <[email protected]>