Build Parsers with Confidence

# demo.parg
grammar Demo version "1.0.0" {
  skip = trivia
  trivia = 1*" "

  digit = %x30-39
  number = 1*digit
  publisher = %i"iso" / %i"ieee"

  origin = publisher as publisher
  serial = number as number

  iso_identifier = origin serial
}

bindings iso_identifier {
  publisher -> publisher (string)
  number -> number (integer)
}

entry identifier: iso_identifier

require "parsanol"

document = Parsanol::PARG::Parser.new(File.read("demo.parg")).parse
result   = Parsanol::PARG::Compiler.compile(document)
File.write("demo.artifact.json", JSON.generate(result.envelope))

artifact = Parsanol::PARG::Artifact.load("demo.artifact.json")
artifact.parse_and_bind("identifier", "iso 12345")
# => { publisher: "iso", number: 12345 }

use parsanol::PargArtifact;

// Checksum verified on load — a mismatch is a hard error
let artifact = PargArtifact::from_path("demo.artifact.json")?;
let grammar = artifact.grammar("identifier")?;

// parse `input` with PortableParser::new(&grammar, input, &mut arena)
let bound = artifact.apply_bindings("identifier", &shape)?;
// => { publisher: "iso", number: 12345 }

import init, { PargArtifactJs } from "@parsanol/wasm";

await init();

// Checksum verified on load
const parg = new PargArtifactJs(demoArtifactJson);
const bound = parg.parseAndBind("identifier", "iso 12345");
// => { publisher: "iso", number: 12345 }

parg.runTests(); // replay the artifact's embedded tests