Skip to content

karupanerura/TOML-Parser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

97 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Build Status Coverage Status

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 [email protected]

CONTRIBUTOR

Olivier Mengué [email protected] yowcow [email protected] Syohei YOSHIDA [email protected]