/ 
DMS-Parser-XS-0.5.3
/ README.md

DMS-Parser-XS

DMS website · Tier-1 spec · Format comparison · Dialects

XS (C-backed) parser and emitter for DMS — a config and data format with strong typing, insertion-ordered maps, multi-line heredocs, and optional front-matter metadata.

This distribution wraps the C reference parser via XS, delivering roughly ~20× speedup over the pure-Perl DMS-Parser on large documents. The C sources (including the utf8proc dependency) are vendored under vendor/dms-c/, so no external C library is required — only a C compiler at build time.

Install

cpanm DMS::Parser::XS

Or from source (requires a C compiler):

perl Makefile.PL && make && make test && make install

Synopsis

use DMS::Parser::XS;

# Decode DMS source → Perl value tree (same shape as DMS::Parser)
my $src = do { local $/; <STDIN> };
my $doc = DMS::Parser::XS::decode($src);   # hashref / arrayref / scalar

# Full Document (meta, comments, original_forms)
my $full = DMS::Parser::XS::decode_document($src);

# Lite mode — fastest path, no comment/form tracking
my $body = DMS::Parser::XS::decode_lite($src);

# Emit — delegates to the shared pure-Perl emitter
use DMS::Parser::Emitter;
print DMS::Parser::XS::encode($full);        # round-trip
print DMS::Parser::XS::encode_lite($full);   # canonical

API compatibility

DMS::Parser::XS mirrors the DMS::Parser API exactly — decode, decode_document, decode_lite, decode_lite_document, encode, encode_lite, decode_front_matter, decode_document_unordered.

Spec

License

Dual-licensed under the Apache License 2.0 and the MIT license, at your option. See vendor/dms-c/LICENSE-APACHE and vendor/dms-c/LICENSE-MIT.