README.adoc

// SPDX-License-Identifier: MPL-2.0 // (PMPL-1.0-or-later preferred; MPL-2.0 required for Hex.pm ecosystem)

= a2ml_gleam :toc: preamble :icons: font

image:https://api.securityscorecards.dev/projects/github.com/hyperpolymath/a2ml_gleam/badge[OpenSSF Scorecard,link="https://securityscorecards.dev/viewer/?uri=github.com/hyperpolymath/a2ml_gleam"]

A2ML (AI Attestation Markup Language) parser and renderer for Gleam.

== Overview

A pure Gleam library for parsing, manipulating, and rendering A2ML documents. A2ML is a lightweight markup language for expressing AI attestations, trust levels, and verification metadata.

== Features

• Full A2ML parser with error reporting
• Renderer for A2ML document output
• Trust level handling (Unverified, Automated, Reviewed, Verified)
• Attestation and directive support
• Manifest extraction
• Roundtrip fidelity (parse then render preserves structure)

== Installation

[source,sh]

gleam add a2ml_gleam

== Usage

[source,gleam]

import a2ml_gleam/parser import a2ml_gleam/renderer

let assert Ok(doc) = parser.parse("# My Document\n\n@version 1.0") let output = renderer.render(doc)

== Testing

[source,sh]

gleam test

Wondering how this works? See link:EXPLAINME.adoc[].

== License

SPDX-License-Identifier: MPL-2.0 + (PMPL-1.0-or-later preferred; MPL-2.0 required for Hex.pm ecosystem) + See link:LICENSE[LICENSE].