ParserCombinators provides a set of elementary building blocks for deriving structured information from unstructured string data.
Overview
Parsers are represented by a function of the form (Substring) throws -> (Value, Substring)?. A substring is taken as input and a parsed result as well as the unparsed remainder of the input are returned. An error may be thrown if some kind of invalid state is encountered during parsing and nil is returned if the parser isn't able to parse the desired result from the given input.
The package defines a number of primitive parsers capable of matching user-defined sequences of characters (e.g. character and substring) as well as various modifiers which can either change a parser's behavior (e.g. map and filter) or combine multiple parsers into a single, more sophisticated parser (e.g. join, fallback, and chain).
Example
Constructing a parser to match a bracketed comma-separated list of words might look something like this:
extension Parser {
static var listExpression: Parser<Array<String>> {
.character("[").trailingPadding()
.joinRight(to:
.substring(\.isLetter)
.chain(with: .whitespace)
.map(String.init)
.collection(separatedBy: .character(",").padding(), allowingTrailingSeparator: true)
)
.joinLeft(to: .character("]").leadingPadding())
}
}
Applying the parser is straightforward and produces the desired result:
let cities = " [ London, New York , San Francisco ,] "
let parser: Parser<Array<String>> = .listExpression.padding().terminate()
if let (cities, _) = try? parser.parse(cities) {
print(cities) // ["London", "New York", "San Francisco"]
}
More examples can be found here.
219 Nov 6, 2022
0 Dec 27, 2021
23 Dec 16, 2022
4 Aug 25, 2022
421 Jan 5, 2023
11 Aug 25, 2021
0 Dec 6, 2021
1.2k Dec 23, 2022
17 Dec 21, 2019
1 Feb 18, 2022
16 Nov 8, 2022
127 Dec 14, 2022
471 Dec 27, 2022
1k Dec 23, 2022
34 Oct 4, 2022
152 Dec 27, 2022
1.2k Nov 8, 2022
32 Oct 4, 2022
50 Mar 21, 2022
3 Sep 23, 2021
0 Oct 16, 2021
0 Dec 29, 2021
0 Jan 2, 2022
1 Jul 13, 2022
5 Jun 10, 2022
8 Nov 25, 2022
51 Dec 1, 2022
273 Sep 9, 2022
4 Nov 28, 2022