How do I install Fuzi with Swift Package Manager?

In Xcode 11 or later, go to File > Swift Packages > Add Package Dependency and enter the repository URL 'https://github.com/cezheng/Fuzi'. Xcode will automatically resolve and integrate the library.

Fuzi vs Ono: which is better for Swift projects?

Fuzi is the modern Swift-native successor to Ono, offering a cleaner API with type safety and bug fixes. For new Swift projects, Fuzi is recommended; Ono is better suited for maintaining Objective-C codebases.

Can Fuzi handle malformed HTML for web scraping?

Yes, Fuzi uses libxml2's HTML parser which is tolerant of malformed HTML, similar to web browsers. This makes it effective for scraping real-world web pages with imperfect markup.

How to extract text from elements using CSS selectors in Fuzi?

Use the 'css' method to query elements, then access the 'stringValue' property to get the concatenated text content. For example, 'doc.css("p")[0].stringValue' extracts text from the first paragraph.

Is Fuzi thread-safe for concurrent parsing?

Fuzi relies on libxml2, which is not inherently thread-safe. For concurrent usage, parse documents on separate threads or use synchronization mechanisms to avoid issues.

Does Fuzi support XML namespaces in queries?

Yes, Fuzi provides intuitive namespace support with methods like 'definePrefix' and querying elements in specific namespaces, as shown in the XML parsing examples.

What error handling options does Fuzi offer?

Fuzi throws XMLError types for parsing failures, allowing detailed error handling with switch cases. For quick usage, you can use 'try?' or 'try!' for optional or forced unwrapping.

Open-Awesome

Fuzi

MITSwift3.1.3

A fast and lightweight XML/HTML parser for Swift with XPath and CSS query support.

GitHub

1.1k stars167 forks0 contributors

What is Fuzi?

Fuzi is a Swift library for parsing and querying XML and HTML documents. It provides a fast, lightweight solution for extracting and navigating data from markup using XPath and CSS selectors, addressing the need for efficient document processing in Swift-based apps.

Target Audience

iOS and macOS developers who need to parse, query, or manipulate XML/HTML data within their Swift applications, such as those working with web scraping, RSS feeds, or configuration files.

Value Proposition

Developers choose Fuzi for its Swift-native API that eliminates cumbersome type casting, its high performance from libxml2, and its dual support for XPath and CSS queries, offering a more modern alternative to Objective-C parsers like Ono.

Overview

A fast & lightweight XML & HTML parser in Swift with XPath & CSS support

Use Cases

Best For

Parsing RSS or Atom feeds in Swift applications
Scraping web content using CSS selectors in macOS/iOS tools
Processing XML configuration files in Swift projects
Extracting data from HTML documents with complex structures
Building Swift CLI tools that need XML/HTML parsing capabilities
Migrating from Objective-C parsers like Ono to a Swift-native solution

Not Ideal For

Projects targeting non-Apple platforms like Linux or Windows, as Fuzi is primarily designed for iOS and macOS with no explicit cross-platform support.
Applications requiring streaming XML/HTML parsing for memory efficiency with large files, since Fuzi loads entire documents into memory.
Teams preferring pure Swift libraries without C dependencies, due to Fuzi's reliance on libxml2 which adds setup complexity.
Projects needing advanced XML features like XSLT transformations or schema validation, which Fuzi does not provide.

Pros & Cons

Pros

High Performance Parsing

Leverages libxml2 for fast document processing, making it efficient for handling large XML/HTML files, as highlighted in the README's emphasis on performance.

Dual Query Support

Supports both XPath and CSS selectors, offering flexibility for querying documents, which is a key feature inherited from Ono and improved in Fuzi.

Swift-Native API

Provides a clean, type-safe interface that follows Swift conventions, reducing unnecessary type casting compared to Objective-C alternatives like Ono.

Comprehensive Node Access

Allows access to all node types including elements, text, and comments, enabling fine-grained document manipulation as demonstrated in the examples.

Cons

Incomplete CSS Selectors

The README admits support for more CSS selectors is 'yet to come', limiting its utility for complex CSS-based queries in current versions.

Platform Limitation

Primarily targeted at iOS and macOS, with no clear documentation for server-side Swift on Linux or other platforms, restricting its use in cross-platform projects.

Memory Intensive Design

Parses entire documents into memory without streaming options, which can be inefficient for very large files where incremental parsing is preferred.

Frequently Asked Questions

Related Projects

SwiftSoup

SwiftSoup: Pure Swift HTML Parser, with best of DOM, CSS, and jquery (Supports Linux, iOS, Mac, tvOS, watchOS)

Stars5,075

Forks383

Last commit1 month ago

Ono

A sensible way to deal with XML & HTML for iOS & macOS

Stars2,599

Forks195

Last commit6 years ago

Kanna

Kanna(鉋) is an XML/HTML parser for Swift.

Stars2,487

Forks221

Last commit2 months ago

SWXMLHash

Simple XML parsing in Swift

Stars1,464

Forks210

Last commit3 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub