Mihaela Mihaljevic
708390242c
Root Swift package mirroring PureYAML's structure, rules, and verification gates. Includes the XML node model (Node, Element, Attribute, QualifiedName), a working emitter (Serializer) with escaping and pretty/compact options, and structural validation. The parser surface is stable; parse() raises notImplemented until the scanner lands, pinned by a test. - dependency-free, namespaced under PureXML - portability and style gates carried over (style, namespacing, forbidden patterns, swiftformat, swiftlint, linux, wasm, windows CI) - 11 tests passing
38 lines
1.1 KiB
Markdown
38 lines
1.1 KiB
Markdown
# Package Architecture
|
|
|
|
PureXML starts as one root Swift package with one library target:
|
|
|
|
- product: `PureXML`
|
|
- target: `PureXML`
|
|
- tests: `PureXMLTests`
|
|
|
|
## Rules
|
|
|
|
- Keep dependencies explicit and minimal.
|
|
- Keep external dependencies at zero unless the maintainer explicitly changes the
|
|
project contract.
|
|
- Add a new target only when a responsibility needs independent compilation,
|
|
testing, or platform boundaries.
|
|
- Keep dependencies unidirectional if new targets are added.
|
|
|
|
## Current Layers
|
|
|
|
```text
|
|
PureXML
|
|
├── Model ordered YAML value tree
|
|
├── Parsing parser implementation
|
|
└── Emitting dumper implementation
|
|
```
|
|
|
|
The public namespace tree mirrors this layout.
|
|
|
|
## When to Split a Target
|
|
|
|
Do not split for aesthetics. Split when one of these becomes true:
|
|
|
|
- the parser and emitter need independent platform gates
|
|
- a reusable scanner/lexer becomes large enough to test independently
|
|
- a compatibility layer for Yams-style decoding needs isolation from the core
|
|
model
|
|
- a CLI or research tool appears and should not ship as library code
|