fig 1.0.0

Parse, edit, and convert config files while preserving comments. Supports JSON, YAML, TOML, and more.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

//! The native "fig" format: a total, 1:1 text encoding of the AST.
//!
//! It is the AST's own canonical serialization — a bijection with `ast.zig`'s
//! `Node.Kind` plus the YAML reference layer — so any document round-trips
//! through it unchanged. Two roles:
//!   * default/debug representation (`Printer.print`), available without any
//!     format-specific codec;
//!   * comparison oracle: serialize two documents to native text and compare.
//!
//! Unlike JSON, it can represent every AST variant (int/float distinction,
//! extended scalars, non-string keys, anchors/tags/aliases), so test fixtures
//! that previously borrowed the JSON parser as an AST-literal syntax can use
//! `Parser.parseAbstract` instead — letting JSON *reading* become optional.

pub const Printer = @import("printer.zig");
pub const Parser = @import("parser.zig");

/// Parse native text into an owned AST (free with `ast.deinit()`).
pub const parseAbstract = Parser.parseAbstract;
/// Parse native text into a Document (free with `doc.deinit(allocator)`).
pub const parse = Parser.parse;
/// Print an AST as native text (trailing newline, flushes).
pub const print = Printer.print;
/// Print a subtree (no trailing newline, no flush).
pub const printNode = Printer.printNode;

test {
    _ = Printer;
    _ = Parser;
}