SwiftCSSParser
A lightweight CSS parser for Swift that uses cssparser (cpp) under the hood.
Basic usage
Here's a simple code snippet to get you started.
// An example stylesheet (with horrible formatting)
let css = """
div { color: blue
}
"""
// Parse the stylesheet
let stylesheet = try Stylesheet.parse(css)
print(stylesheet.minified())
// div{color:blue}
print(stylesheet.prettyPrinted(with: .spaces(2))
// div {
// color: blue;
// }
print(stylesheet)
// Stylesheet([
// .ruleSet(RuleSet(
// selector: "div",
// declarations: [
// Declaration(property: "color", value: "blue")
// ]
// ))
// ])
Statements
The main CSS parsing API is built on the concept of CSS statements. It is the easiest to use and most type-safe API that SwiftCSSParser offers for parsing and creating CSS documents. However, the main limitation of the statements API is that it does not handle comments, it also may just ignore tokens that it deems to be invalid. If you find any cases where the statements generated from a document incorrectly ignore a valid token, open an issue.
To parse a document into statements, use the Stylesheet.parseStatements(from:) method. This is equivalent to Stylesheet.parse(from: css).statements.
Tokens
The tokens based API is a lower level and more simplistic version of the statements API. It is a direct Swift translation of the parsing aspect of the cssparser API.
To parse a document into tokens, use the Stylesheet.parseTokens(from:) method. The resulting token stream includes comments.
Contributing
# 1. Fork swift-css-parser
# 2. Clone your fork
git clone https://github.com/yourusername/swift-css-parser
# 3. Finish cloning the repository
cd swift-css-parser
git submodule update --init --recursive
43 Dec 15, 2022
9 Aug 22, 2022
117 Sep 9, 2022
27 Aug 19, 2020
14 Aug 13, 2018
448 Nov 8, 2022
8 Nov 22, 2022
964 Dec 14, 2022
8.5k Jan 3, 2023
4 Nov 21, 2022
1 Nov 25, 2021
930 Jan 4, 2023
3.8k Jan 5, 2023
31 Nov 22, 2021
132 Dec 5, 2021
1.1k Jan 1, 2023
1.6k Nov 24, 2022
22 Dec 15, 2022
43 Dec 15, 2022