Kanna(鉋)
Kanna(鉋) is an XML/HTML parser for cross-platform(macOS, iOS, tvOS, watchOS and Linux!).
It was inspired by Nokogiri(鋸).
:information_source: Documentation
Features:
- XPath 1.0 support for document searching
- CSS3 selector support for document searching
- Support for namespaces
- Comprehensive test suite
Installation:
Swift 5
CocoaPods
Adding it to your Podfile:
use_frameworks!
pod 'Kanna', '~> 5.0.0'
Carthage
Adding it to your Cartfile:
github "tid-kijyun/Kanna" ~> 5.0.0
- In the project settings add
$(SDKROOT)/usr/include/libxml2to the "header search paths" field
Others(Swift PM and manual Installation)
Please refer to the case of Swift 4.
Swift 4
CocoaPods
:warning: CocoaPods (1.1.0 or later) is required.
Adding it to your Podfile:
use_frameworks!
pod 'Kanna', '~> 4.0.0'
Carthage
Adding it to your Cartfile:
github "tid-kijyun/Kanna" ~> 4.0.0
- In the project settings add
$(SDKROOT)/usr/include/libxml2to the "header search paths" field
Swift Package Manager
Installing libxml2 to your computer:
// macOS
$ brew install libxml2
$ brew link --force libxml2
// Linux(Ubuntu)
$ sudo apt-get install libxml2-dev
Adding it to your Package.swift:
// swift-tools-version:4.0
import PackageDescription
let package = Package(
name: "YourProject",
dependencies: [
.package(url: "https://github.com/tid-kijyun/Kanna.git", from: "4.0.0")
],
targets: [
.target(
name: "YourTarget",
dependencies: ["Kanna"]),
]
)
$ swift build
Note: When a build error occurs, please try run the following command:
$ sudo apt-get install pkg-config
Manual Installation
- Add these files to your project:
Kanna.swift
CSS.swift
libxmlHTMLDocument.swift
libxmlHTMLNode.swift
libxmlParserOption.swift
Modules - In the target settings add
$(SDKROOT)/usr/include/libxml2to theSearch Paths > Header Search Pathsfield - In the target settings add
$(SRCROOT)/Modulesto theSwift Compiler - Search Paths > Import Pathsfield
Swift 3.0
For now, please use the feature/v3.0.0 branch.
CocoaPods
:warning: CocoaPods (1.1.0 or later) is required.
Adding it to your Podfile:
use_frameworks!
pod 'Kanna', :git => 'https://github.com/tid-kijyun/Kanna', :branch => 'feature/v3.0.0'
Carthage
Adding it to your Cartfile:
github "tid-kijyun/Kanna" "feature/v3.0.0"
- In the project settings add
$(SDKROOT)/usr/include/libxml2to the "header search paths" field
Swift Package Manager
Installing libxml2 to your computer:
// macOS
$ brew install libxml2
$ brew link --force libxml2
// Linux(Ubuntu)
$ sudo apt-get install libxml2-dev
Adding it to your Package.swift:
import PackageDescription
let package = Package(
name: "YourProject",
dependencies: [
.Package(url: "https://github.com/tid-kijyun/Kanna.git", majorVersion: 2)
]
)
$ swift build
Note: When a build error occurs, please try run the following command:
$ sudo apt-get install pkg-config
Manual Installation
- Add these files to your project:
Kanna.swift
CSS.swift
libxmlHTMLDocument.swift
libxmlHTMLNode.swift
libxmlParserOption.swift
Modules - In the target settings add
$(SDKROOT)/usr/include/libxml2to theSearch Paths > Header Search Pathsfield - In the target settings add
$(SRCROOT)/Modulesto theSwift Compiler - Search Paths > Import Pathsfield
Synopsis:
import Kanna
let html = "<html>...</html>"
if let doc = try? HTML(html: html, encoding: .utf8) {
print(doc.title)
// Search for nodes by CSS
for link in doc.css("a, link") {
print(link.text)
print(link["href"])
}
// Search for nodes by XPath
for link in doc.xpath("//a, //link") {
print(link.text)
print(link["href"])
}
}
let xml = "..."
if let doc = try? Kanna.XML(xml: xml, encoding: .utf8) {
let namespaces = [
"o": "urn:schemas-microsoft-com:office:office",
"ss": "urn:schemas-microsoft-com:office:spreadsheet"
]
if let author = doc.at_xpath("//o:Author", namespaces: namespaces) {
print(author.text)
}
}
License:
The MIT License. See the LICENSE file for more information.