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
31
32
33
34
35
36
37
38
39
40
41
//! Source-aware parsing, modeling, generation, compatibility evaluation, and rendering of Podman
//! Quadlet files.
//!
//! `QuadletLens` keeps physical source syntax separate from typed native meaning and target-version
//! evidence. Parsing and generation are in-memory operations: the crate never invokes Podman,
//! operates systemd, discovers neighboring files, or mutates a host.
//!
//! # Parse a document
//!
//! ```
//! use quadlet_lens::{
//! model::{QuadletDocument, QuadletUnitType},
//! source::SourceId,
//! };
//!
//! let source = "[Container]\nImage=example.invalid/web:1\n";
//! let parsed = QuadletDocument::parse(
//! QuadletUnitType::Container,
//! SourceId::new(1),
//! source,
//! )
//! .expect("valid Quadlet input");
//!
//! assert!(parsed.is_valid());
//! ```
//!
//! # Modules
//!
//! - [`syntax`] retains ordered physical syntax and renders preserved or canonical text.
//! - [`model`] exposes typed native documents and multi-file relationships.
//! - [`render`] constructs and validates new documents.
//! - [`capability`] evaluates evidence over explicit Podman and systemd targets.
//! - [`diagnostic`], [`source`], and [`path`] provide reporting and conservative source metadata.