NAME
    YAML::Pegex - YAML Parser using Pegex

SYNOPSIS
          my $data = YAML::Pegex->new->parse($input);

DESCRIPTION
    YAML::Pegex is a YAML parser written in Pegex.

    This module is not intended to be used in the real world. The *code* of
    YAML::Pegex is intended to replace the Pure Perl YAML modules: "YAML.pm"
    and "YAML::Tiny".

    Let me explain.

    Pegex is a parsing framework with the following benefits:

    *   Clean, crisp, and working grammars define languages.

        See
        <https://github.com/ingydotnet/yaml-pegex-pm/blob/master/share/yaml.
        pgx> for the current YAML::Pegex grammar. This means that almost
        anyone can identify and fix bugs in the language.

    *   Pegex is fast.

        For pure Perl parsing, Pegex has been tuned to be very fast. Only
        benchmarks can speak accurately to speed, but trust me it's crazy
        fast so far, and can be made faster with a "libpegex". Pegex
        preoptimizes its grammars before a parse. Many of these
        optimizations are done before the grammar goes to CPAN, so no
        "require" penalties for those optimizations. I'm confident that
        YAML::Pegex will out perform YAML::Tiny.

    *   Pegex is multi language.

        The same grammar can be used for JavaScript, Python, Ruby, PHP, Java
        and so on. This is the key to making YAML (a fairly complex
        serialization language) be truly cross-language as it was intended.

    The idea for YAML::Pegex is to build it up test by test. Once it passes
    all the YAML::* tests it can replace the pure Perl YAML modules.

    This is only the parser, but that's the hardest part by far. YAML::Tiny
    and YAML.pm can still be different. YAML.pm will build a full stack
    which can do many amazing operations that have not been done with YAML
    in Perl yet. (Python and other languages have these things.) YAML::Tiny
    will just load yaml straight to Perl as quickly as possible.

    After that we can possibly replace YAML::XS by writing "libpegex". I
    have no idea how they would compare speedwise, but the other benefits
    would apply.

AUTHOR
    Ingy döt Net <ingy@cpan.org>

COPYRIGHT AND LICENSE
    Copyright (c) 2014. Ingy döt Net.

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

    See <http://www.perl.com/perl/misc/Artistic.html>

