PureXML/Sources/Catalog/CatalogParser.swift
Mihaela Mihaljevic 634270d529 feat(catalog): OASIS XML Catalog resolution
Add the PureXML.Catalog namespace: parse an OASIS XML catalog (public,
system, uri, rewriteSystem, rewriteURI, group/catalog by local name) into a
Resolver mapping public/system identifiers and URI names to URIs, with
longest-prefix rewriting and system-over-public precedence. entityResolver
(loadingURI:) builds a Parsing.EntityResolver that resolves an external
identifier through the catalog and loads the URI via an injected closure, so
a catalog plus loader wires entities and DTDs in while the default keeps XXE
closed.

Closes #57
Closes #58
Closes #27
2026-06-08 06:03:02 +02:00

85 lines
3.0 KiB
Swift

/// Accumulates catalog entries as the tree is walked. File-scope and private: an
/// internal detail of ``PureXML/Catalog/CatalogParser``.
private struct CatalogBuilder {
typealias RewriteRule = PureXML.Catalog.RewriteRule
var systemMap: [String: String] = [:]
var publicMap: [String: String] = [:]
var uriMap: [String: String] = [:]
var rewriteSystem: [RewriteRule] = []
var rewriteURI: [RewriteRule] = []
mutating func add(_ node: PureXML.Model.TreeNode) {
switch node.name?.localName {
case "system":
insert(node, key: "systemId", value: "uri", into: &systemMap)
case "public":
insert(node, key: "publicId", value: "uri", into: &publicMap)
case "uri":
insert(node, key: "name", value: "uri", into: &uriMap)
case "rewriteSystem":
appendRewrite(node, start: "systemIdStartString", into: &rewriteSystem)
case "rewriteURI":
appendRewrite(node, start: "uriStartString", into: &rewriteURI)
default:
break
}
}
private func insert(
_ node: PureXML.Model.TreeNode,
key: String,
value: String,
into map: inout [String: String],
) {
guard let identifier = attribute(node, key), let uri = attribute(node, value) else { return }
map[identifier] = uri
}
private func appendRewrite(
_ node: PureXML.Model.TreeNode,
start: String,
into rules: inout [RewriteRule],
) {
guard let startString = attribute(node, start), let rewrite = attribute(node, "rewritePrefix") else { return }
rules.append(RewriteRule(startString: startString, rewritePrefix: rewrite))
}
private func attribute(_ node: PureXML.Model.TreeNode, _ name: String) -> String? {
node.attributes.first { $0.name.localName == name || $0.name.description == name }?.value
}
func resolver() -> PureXML.Catalog.Resolver {
PureXML.Catalog.Resolver(
systemMap: systemMap,
publicMap: publicMap,
uriMap: uriMap,
rewriteSystem: rewriteSystem,
rewriteURI: rewriteURI,
)
}
}
extension PureXML.Catalog {
/// Parses an OASIS XML catalog document into a ``Resolver``. Entries are
/// matched by local name, so the catalog namespace is not required; `group`
/// and `catalog` elements are recursed into.
enum CatalogParser {
static func parse(_ xml: String) throws -> Resolver {
let root = try PureXML.parseTree(xml)
var builder = CatalogBuilder()
collect(root, into: &builder)
return builder.resolver()
}
private static func collect(_ node: PureXML.Model.TreeNode, into builder: inout CatalogBuilder) {
for child in node.children where child.kind == .element {
builder.add(child)
if child.name?.localName == "group" || child.name?.localName == "catalog" {
collect(child, into: &builder)
}
}
}
}
}