Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 373 Commits
.github		.github
Configurations		Configurations
Documentation		Documentation
Kanna.xcodeproj		Kanna.xcodeproj
Modules		Modules
Sources/Kanna		Sources/Kanna
Tests		Tests
script		script
.gitignore		.gitignore
.swiftlint.yml		.swiftlint.yml
Kanna.podspec		Kanna.podspec
LICENSE		LICENSE
Package.swift		Package.swift
README.md		README.md

Repository files navigation

Kanna(鉋)

Kanna(鉋) is an XML/HTML parser for cross-platform(macOS, iOS, tvOS, watchOS and Linux!).

It was inspired byNokogiri(鋸).

ℹ️Documentation

Features

XPath 1.0 support for document searching
CSS3 selector support for document searching
Support for namespaces
Comprehensive test suite

Installation

ℹ️ If you are using Swift 6, please use Kanna 6.0.0 or later.
ℹ️ The same applies if you setStrict Concurrency Check toTargeted or higher.

CocoaPods

Add the following to yourPodfile:

use_frameworks!pod'Kanna','~> 5.2.2'

Carthage

Add the following to yourCartfile:

github "tid-kijyun/Kanna" ~> 5.2.2

For xcode 11.3 and earlier, the following settings are required.

In the project settings add$(SDKROOT)/usr/include/libxml2 to the "header search paths" field

Swift Package Manager

Installing libxml2 to your computer:

// macOS: For xcode 11.3 and earlier, the following settings are required.$ brew install libxml2$ brew link --force libxml2// Linux(Ubuntu):$ sudo apt-get install libxml2-dev

Add the following to yourPackage.swift:

// swift-tools-version:5.0import PackageDescriptionletpackage=Package(    name:"YourProject",    dependencies:[.package(url:"https://github.com/tid-kijyun/Kanna.git", from:"5.2.2"),],    targets:[.target(            name:"YourTarget",            dependencies:["Kanna"]),])

$ swift build

Note: When a build error occurs, please try run the following command:

// Linux(Ubuntu)$ 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/libxml2 to theSearch Paths > Header Search Paths field
In the target settings add$(SRCROOT)/Modules to theSwift Compiler - Search Paths > Import Paths field

Installation for swift 4

Installation for swift 3

Synopsis

import Kannalethtml="<html>...</html>"iflet doc=try?HTML(html: html, encoding:.utf8){print(doc.title)        // Search for nodes by CSSforlinkin doc.css("a, link"){print(link.text)print(link["href"])}        // Search for nodes by XPathforlinkin doc.xpath("//a | //link"){print(link.text)print(link["href"])}}

letxml="..."iflet doc=try?Kanna.XML(xml: xml, encoding:.utf8){letnamespaces=["o":"urn:schemas-microsoft-com:office:office","ss":"urn:schemas-microsoft-com:office:spreadsheet"]iflet author= doc.at_xpath("//o:Author", namespaces: namespaces){print(author.text)}}