Popularity
5.5
Growing
Activity
6.6
-
453
15
73

Code Quality Rank: L5
Programming language: Swift
License: MIT License
Tags: XML / HTML / CSV    
Latest version: v5.3.0

SwiftyXMLParer alternatives and similar libraries

Based on the "XML / HTML / CSV" category.
Alternatively, view SwiftyXMLParer alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of SwiftyXMLParer or a related project?

Add another 'XML / HTML / CSV' Library

README

swiftyxmlparserlogo

Swift 5.0 Carthage compatible Version License Platform

Simple XML Parser implemented in Swift

What's this?

This is a XML parser inspired by SwiftyJSON and SWXMLHash.

NSXMLParser in Foundation framework is a kind of "SAX" parser. It has enough performance but is a little inconvenient. So we have implemented "DOM" parser wrapping it.

Feature

  • [x] access XML Document with "subscript".
  • [x] access XML Document as Sequence.
  • [x] easy debugging XML pathes.

Requirement

  • iOS 9.0+
  • tvOS 9.0+
  • macOS 10.10+
  • Swift 5.0

Installation

Carthage

1. create Cartfile

github "https://github.com/yahoojapan/SwiftyXMLParser"

2. install

> carthage update

CocoaPods

1. create Podfile

platform :ios, '9.0'
use_frameworks!

pod "SwiftyXMLParser", :git => 'https://github.com/yahoojapan/SwiftyXMLParser.git'

2. install

> pod install

Example

import SwiftyXMLParser

let str = """
<ResultSet>
    <Result>
        <Hit index=\"1\">
            <Name>Item1</Name>
        </Hit>
        <Hit index=\"2\">
            <Name>Item2</Name>
        </Hit>
    </Result>
</ResultSet>
"""

// parse xml document
let xml = try! XML.parse(str)

// access xml element
let accessor = xml["ResultSet"]

// access XML Text

if let text = xml["ResultSet", "Result", "Hit", 0, "Name"].text {
    print(text)
}

if let text = xml.ResultSet.Result.Hit[0].Name.text {
    print(text)
}

// access XML Attribute
if let index = xml["ResultSet", "Result", "Hit", 0].attributes["index"] {
    print(index)
}

// enumerate child Elements in the parent Element
for hit in xml["ResultSet", "Result", "Hit"] {
    print(hit)
}

// check if the XML path is wrong
if case .failure(let error) =  xml["ResultSet", "Result", "TypoKey"] {
    print(error)
}

Usage

1. Parse XML

  • from String ```swift let str = """ Item1 Item2 """

xml = try! XML.parse(str) // -> XML.Accessor

+ from NSData
```swift
let str = """
<ResultSet>
    <Result>
        <Hit index=\"1\">
            <Name>Item1</Name>
        </Hit>
        <Hit index=\"2\">
            <Name>Item2</Name>
        </Hit>
    </Result>
</ResultSet>
"""

let string = String(decoding: data, as: UTF8.self)

xml = XML.parse(data) // -> XML.Accessor
  • with invalid character
let srt = "<xmlopening>@ß123\u{1c}</xmlopening>"

let xml = XML.parse(str.data(using: .utf8))

if case .failure(XMLError.interruptedParseError) = xml {
  print("invalid character")
}

For more, see https://developer.apple.com/documentation/foundation/xmlparser/errorcode

2. Access child Elements

let element = xml.ResultSet // -> XML.Accessor

3. Access grandchild Elements

  • with String swift let element = xml["ResultSet"]["Result"] // -> <Result><Hit index=\"1\"><Name>Item1</Name></Hit><Hit index=\"2\"><Name>Item2</Name></Hit></Result>
  • with Array swift let path = ["ResultSet", "Result"] let element = xml[path] // -> <Result><Hit index=\"1\"><Name>Item1</Name></Hit><Hit index=\"2\"><Name>Item2</Name></Hit></Result>
  • with Variadic swift let element = xml["ResultSet", "Result"] // -> <Result><Hit index=\"1\"><Name>Item1</Name></Hit><Hit index=\"2\"><Name>Item2</Name></Hit></Result>
  • with @dynamicMemberLookup swift let element = xml.ResultSet.Result // -> <Result><Hit index=\"1\"><Name>Item1</Name></Hit><Hit index=\"2\"><Name>Item2</Name></Hit></Result> ### 4. Access specific grandchild Element swift let element = xml.ResultSet.Result.Hit[1] // -> <Hit index=\"2\"><Name>Item2</Name></Hit> ### 5. Access attribute in Element swift if let attributeValue = xml.ResultSet.Result.Hit[1].attributes?["index"] { print(attributeValue) // -> 2 } ### 6. Access text in Element
  • with optional binding swift if let text = xml.ResultSet.Result.Hit[1].Name.text { print(text) // -> Item2 }
  • with custom operation swift struct Entity { var name = "" } let entity = Entity() entity.name ?= xml.ResultSet.Result.Hit[1].Name.text // assign if it has text
  • convert Int and assign swift struct Entity { var name: Int = 0 } let entity = Entity() entity.name ?= xml.ResultSet.Result.Hit[1].Name.int // assign if it has Int and there are other syntax sugers, bool, url and double.
  • assign text into Array swift struct Entity { var names = [String]() } let entity = Entity() entity.names ?<< xml.ResultSet.Result.Hit[1].Name.text // assign if it has text ### 7. Count child Elements swift let numberOfHits = xml.ResultSet.Result.Hit.all?.count ### 8. Check error swift print(xml.ResultSet.Result.TypoKey) // -> "TypoKey not found."

9. Access as SequenceType

  • for-in swift for element in xml.ResultSet.Result.Hit { print(element.text) }
  • map swift xml.ResultSet.Result.Hit.map { $0.Name.text }

9. Generate XML document

print(Converter(xml.ResultSet).makeDocument())

Work with Alamofire

SwiftyXMLParser goes well with Alamofire. You can parse the response easily.

import Alamofire
import SwiftyXMLParser

Alamofire.request(.GET, "https://itunes.apple.com/us/rss/topgrossingapplications/limit=10/xml")
         .responseData { response in
            if let data = response.data {
                let xml = XML.parse(data)
                print(xml.feed.entry[0].title.text) // outputs the top title of iTunes app raning.
            }
        }

In addition, there is the extension of Alamofire to combine with SwiftyXMLParser.

Migration Guide

Current master branch is supporting Xcode10. If you wanna use this library with legacy swift version, read release notes and install the last compatible version.

License

This software is released under the MIT License, see LICENSE.


*Note that all licence references and agreements mentioned in the SwiftyXMLParer README section above are relevant to that project's source code only.