---
name: "TOML::Parser"
section: "3pm"
platform: "linux"
package: "libtoml-parser-perl"
version: "0.91-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/TOML::Parser"
---

# TOML::Parser(3pm)

simple toml parser

## NAME

TOML::Parser - simple toml parser

## 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.

## SEE ALSO

TOML

## LICENSE

Copyright (C) karupanerura.

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

## AUTHOR

karupanerura \<karupa@cpan.org\>

## CONTRIBUTOR

Olivier Mengue \<dolmen@cpan.org\> yowcow \<yowcow@cpan.org\> Syohei YOSHIDA \<syohex@gmail.com\>