Skip to content
Perl parser for Tom's Obvious, Minimal Language
Branch: master
Clone or download
Pull request Compare This branch is 22 commits ahead of dlc:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib
t
.gitignore
.mailmap
.travis.yml
Build.PL
Changes
LICENSE
META.json
README.md
cpanfile
minil.toml

README.md

Build Status

NAME

TOML - Parser for Tom's Obvious, Minimal Language.

SYNOPSIS

use TOML qw(from_toml to_toml);

# Parsing toml
my $toml = slurp("~/.foo.toml");
my $data = from_toml($toml);

# With error checking
my ($data, $err) = from_toml($toml);
unless ($data) {
    die "Error parsing toml: $err";
}

# Creating toml
my $toml = to_toml($data); 

DESCRIPTION

TOML implements a parser for Tom's Obvious, Minimal Language, as defined at https://github.com/mojombo/toml. TOML exports two subroutines, from_toml and to_toml,

FAQ

  • How change how to de-serialize?

    You can change $TOML::PARSER for change how to de-serialize.

    example:

      use TOML;
      use TOML::Parser;
    
      local $TOML::PARSER = TOML::Parser->new(
          inflate_boolean => sub { $_[0] eq 'true' ? \1 : \0 },
      );
    
      my $data = TOML::from_toml('foo = true');
    

FUNCTIONS

  • from_toml

    from_toml transforms a string containing toml to a perl data structure or vice versa. This data structure complies with the tests provided at https://github.com/mojombo/toml/tree/master/tests.

    If called in list context, from_toml produces a (hash, error_string) tuple, where error_string is undef on non-errors. If there is an error, then hash will be undefined and error_string will contains (scant) details about said error.

  • to_toml

    to_toml transforms a perl data structure into toml-formatted string.

SEE ALSO

TOML::Parser

LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA

AUTHOR

Darren Chamberlain <darren@cpan.org>

CONTRIBUTORS

You can’t perform that action at this time.