- Xcode 8.0+
- Swift 3.0+
- Alamofire 4.0+
If you need to support an earlier version of Swift, please either download the zip or point your Podfile at the coresponding tag:
- Swift 2.2: tag "Swift 2.2 Final"
- Swift 2.3: tag "Swift 2.3 Final"
The respective readme's in those tags have more explicit instructions for using tags in CocoaPods.
AlamofireRSSParser is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "AlamofireRSSParser"
Then
import AlamofireRSSParser
wherever you're using it.
Alternately you can add the contents of AlamofireRSSParser/Pod/Classes/ to your project and import the classes as appropriate.
Note: To run the example project, clone the repo, and run pod install
from the Example directory first.
You use AlamofireRSSParser just like any other response handler in Alamofire:
let url = "http://rss.cnn.com/rss/cnn_topstories.rss"
Alamofire.request(url).responseRSS() { (response) -> Void in
if let feed: RSSFeed = response.result.value {
//do something with your new RSSFeed object!
for item in feed.items {
print(item)
}
}
}
AlamofireRSSParser returns an RSSFeed object that contains an array of RSSItem objects.
##What It Does and Doesn't Do
I think we can all admit that RSS implementations are a bit all over the place. This project is meant to parse all of the common, high level bits of the RSS 2.0 spec that people actually use/care about. It is not meant to comprehensively parse all RSS.
RSS 2.0 spec elements that it currently parses:
- title
- link
- itemDescription
- guid
- author
- comments
- source
- pubDate
In addition, since this is a Swift port of what was originally the backbone of Heavy Headlines it also parses portions of the Media RSS Specification 1.5.1.
Current elements:
- media:content
- media: thumbnail
- content: encoded
It also yanks all of the images that may be linked in the itemDescription
(if it's HTML) and creates a nice array named imagesFromDescription
that you can use for more image content.
If you need more elements parsed please file an issue or even better, please contribute! That's why this is on GitHub.
Don Angelillo, [email protected]
Inspired by Thibaut LE LEVIER's awesome orginal Block RSSParser AFNetworking Plugin.
AlamofireRSSParser is available under the MIT license. See the LICENSE file for more info.