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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
/*
This source file is part of the Swift.org open source project
Copyright (c) 2021 Apple Inc. and the Swift project authors
Licensed under Apache License v2.0 with Runtime Library Exception
See https://swift.org/LICENSE.txt for license information
See https://swift.org/CONTRIBUTORS.txt for Swift project authors
*/
import Foundation
/// A markup element representing the top level of a whole document.
///
/// - note: Although this could be considered a block element that can contain block elements, a `Document` itself can't be the child of any other markup, so it is not considered a block element.
public struct Document: Markup, BasicBlockContainer {
public var _data: _MarkupData
init(_ raw: RawMarkup) throws {
guard case .document = raw.data else {
throw RawMarkup.Error.concreteConversionError(from: raw, to: Document.self)
}
let absoluteRaw = AbsoluteRawMarkup(markup: raw, metadata: MarkupMetadata(id: .newRoot(), indexInParent: 0))
self.init(_MarkupData(absoluteRaw))
}
init(_ data: _MarkupData) {
self._data = data
}
}
// MARK: - Public API
public extension Document {
// MARK: Primitive
/// Parse a string into a `Document`.
///
/// - parameter string: the input Markdown text to parse.
/// - parameter options: options for parsing Markdown text.
/// - parameter source: an explicit source URL from which the input `string` came for marking source locations.
/// This need not be a file URL.
init(parsing string: String, source: URL? = nil, options: ParseOptions = []) {
if options.contains(.parseBlockDirectives) {
self = BlockDirectiveParser.parse(string, source: source,
options: options)
} else {
self = MarkupParser.parseString(string, source: source, options: options)
}
}
/// Parse a file's contents into a `Document`.
///
/// - parameter file: a file URL from which to load Markdown text to parse.
/// - parameter options: options for parsing Markdown text.
init(parsing file: URL, options: ParseOptions = []) throws {
let string = try String(contentsOf: file)
if options.contains(.parseBlockDirectives) {
self = BlockDirectiveParser.parse(string, source: file,
options: options)
} else {
self = MarkupParser.parseString(string, source: file, options: options)
}
}
/// Create a document from a sequence of block markup elements.
init<Children: Sequence>(_ children: Children) where Children.Element == BlockMarkup {
try! self.init(.document(parsedRange: nil, children.map { $0.raw.markup }))
}
// MARK: Visitation
func accept<V: MarkupVisitor>(_ visitor: inout V) -> V.Result {
return visitor.visitDocument(self)
}
}
|
