swift-css-parser

0.1.2

A lightweight CSS parser for parsing and creating CSS stylesheets
stackotter/swift-css-parser

What's New

v0.1.2

2022-04-09T06:56:36Z

This release adds support for Linux (by adding some missing includes to CCSSParser.cpp)

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

Description

  • Swift Tools 5.2.0
View More Packages from this Author

Dependencies

  • None
Last updated: Sun Mar 17 2024 03:46:53 GMT-0900 (Hawaii-Aleutian Daylight Time)