An RSS, Atom and JSON Feed parser written in Swift

It seems that ESPN's RSS feed (https://www.espn.com/espn/rss/news) cannot be used to instantiate a FeedParser. I've validated that this feed url is correct and works well with other readers. Any idea as to what could cause this?

Changes the method parseAsync to default to the global queue, but also bring back the result to the main thread.

The reason for this change, is that the method parse() is essentially the same as parseAsync() (when not providing any queue) because they both run on the main thread. The problem then is, that you can specify another queue to run this on, but even still, you have to parse the data asynchronously, then bring that data back to the main thread and continue. This is essentially the same as just using parse() in your own async closure and then bringing it back to the main thread, eliminating the need of parseAsync().

I think this is much more user friendly and intuitive, as the intention of parseAsync seems ambiguous.

I get this error when trying to run the Conversion to Swift 4.2 and I am using pod install to install.

:0: error: module map file 'build/Release-iphoneos/FeedKit/FeedKit.modulemap' not found :0: error: module map file 'build/Release-iphoneos/FeedKit/FeedKit.modulemap' not found :0: error: missing required module 'SwiftShims'

Currently, media attributes are parsed only as part of an RSSFeedItem.

I may be wrong, but perhaps it should be possible for something like this:

<media:thumbnail width="40" height="40" url="https://secure.gravatar.com/avatar/1234"/>

to be contained inside an AtomFeedEntry.

I have specific tags in a feed adn I want to exted "RSSPath" enum and "RSSFeed + Attributes Mapper" according to my requirements. My tags aren't confirm to RSS 2.0 specifications. How I can do it easily without modifying source files? Is there any other ways?

Why does FeedParser.parse(_:) take a closure when it could simply return a value?

The gist of what it does is this:

func parse(_ result: @escaping (Result) -> Void) {
    self.result = result
    self.parse()
    ...
    self.result?(someResult)
}

So... why not just do this and not confuse the user?

func parse() -> Result {
    self.parse()
    ...
    return someResult
}

Better yet, dispatch your work to a background queue and make use of the interface you defined:

func parse(_ result: @escaping (Result) -> Void) {
    self.result = result
    DispatchQueue.global().async {
        self.parse()
        ...
        self.result?(someResult)
    }
}

Hi,

I'm using FeedKit in a server side vapor 4 app and I'm getting a weird error when using FeedKit and I was curious if you could shed any light on what this might be caused by and if there is anything I can do to resolve it.

For reference I'm using a Swift 5.2.1.

Thanks, J

Fatal error: You must link or load module FoundationNetworking to load non-file: URL content using String(contentsOf:…), Data(contentsOf:…), etc.: file /home/buildnode/jenkins/workspace/oss-swift-5.2-package-linux-ubuntu-18_04/swift-corelibs-foundation/Foundation/NSSwiftRuntime.swift, line 397

Full stack trace:

api_1  | Fatal error: You must link or load module FoundationNetworking to load non-file: URL content using String(contentsOf:…), Data(contentsOf:…), etc.: file /home/buildnode/jenkins/workspace/oss-swift-5.2-package-linux-ubuntu-18_04/swift-corelibs-foundation/Foundation/NSSwiftRuntime.swift, line 397
api_1  | 0x7fb0bb0eb88f
api_1  | 0x7fb0bbc6f625
api_1  | 0x7fb0bb75b4af
api_1  | 0x7fb0bb6ab2d0
api_1  | 0x7fb0bb6ab3c8
api_1  | 0x7fb0bb6a5ea1
api_1  | 0x556dd17549b2, Foundation.NSData.__allocating_init(contentsOf: Foundation.URL, options: Foundation.NSData.ReadingOptions) throws -> Foundation.NSData at /build/<compiler-generated>:0
api_1  | 0x556dd17549b2, Foundation.Data.init(contentsOf: __shared Foundation.URL, options: Foundation.NSData.ReadingOptions) throws -> Foundation.Data at /build/<compiler-generated>:0
api_1  | 0x556dd17549b2, FeedKit.FeedParser.parse() -> Swift.Result<FeedKit.Feed, FeedKit.ParserError> at /build/.build/checkouts/FeedKit/Sources/FeedKit/Parser/FeedParser.swift:74
api_1  | 0x556dd13f45eb, function signature specialization <Arg[0] = Dead> of static App.RSSManager.checkForLatestRSSActivty() -> Swift.Result<FeedKit.Feed, FeedKit.ParserError> at /build/Sources/App/System Managers/RSSManager.swift:20
api_1  | 0x556dd13f4b42, static App.RSSManager.checkForLatestRSSActivty() -> Swift.Result<FeedKit.Feed, FeedKit.ParserError> at /build/<compiler-generated>:0
api_1  | 0x556dd13f4b42, static App.RSSManager.getLatestAlpineFeedItems() -> Swift.Result<Swift.Array<FeedKit.RSSFeedItem>, FeedKit.ParserError> at /build/Sources/App/System Managers/RSSManager.swift:24
api_1  | 0x556dd13f4b42, function signature specialization <Arg[0] = Dead> of static App.RSSManager.getLatestAlpineFeedUrls() -> Swift.Result<Swift.Array<Foundation.URL>, FeedKit.ParserError> at /build/Sources/App/System Managers/RSSManager.swift:37
api_1  | 0x556dd13eca8b, static App.RSSManager.getLatestAlpineFeedUrls() -> Swift.Result<Swift.Array<Foundation.URL>, FeedKit.ParserError> at /build/<compiler-generated>:0
api_1  | 0x556dd13eca8b, static App.FISUpdateManager.checkForNewAlpinePointsListsForDownload(on: FluentKit.Database) -> NIO.EventLoopFuture<Swift.Array<Foundation.URL>> at /build/Sources/App/System Managers/FISUpdateManager.swift:74
api_1  | 0x556dd13eb8e0, static App.FISUpdateManager.downloadNewAlpinePointsLists(on: FluentKit.Database) -> NIO.EventLoopFuture<Swift.Array<()>> at /build/Sources/App/System Managers/FISUpdateManager.swift:33
api_1  | 0x556dd13eb6f8, static App.FISUpdateManager.downloadAndImportNewAlpinePointsLists(on: FluentKit.Database) -> NIO.EventLoopFuture<Swift.Array<()>> at /build/Sources/App/System Managers/FISUpdateManager.swift:20
api_1  | 0x556dd140a6bb, closure #1 (NIO.RepeatedTask) -> NIO.EventLoopFuture<()> in App.configure(Vapor.Application) throws -> () at /build/Sources/App/configure.swift:42
api_1  | 0x556dd1878744, closure #1 () -> NIO.EventLoopFuture<()> in NIO.RepeatedTask.(begin0 in _D5D78C61B22284700B9BD1ACFBC25157)(in: NIO.TimeAmount) -> () at /build/.build/checkouts/swift-nio/Sources/NIO/EventLoop.swift:88
api_1  | 0x556dd1878744, partial apply forwarder for closure #1 () -> NIO.EventLoopFuture<()> in NIO.RepeatedTask.(begin0 in _D5D78C61B22284700B9BD1ACFBC25157)(in: NIO.TimeAmount) -> () at /build/<compiler-generated>:0
api_1  | 0x556dd1878763, reabstraction thunk helper from @escaping @callee_guaranteed () -> (@owned NIO.EventLoopFuture<()>, @error @owned Swift.Error) to @escaping @callee_guaranteed () -> (@out NIO.EventLoopFuture<()>, @error @owned Swift.Error) at /build/<compiler-generated>:0
api_1  | 0x556dd1878763, partial apply forwarder for reabstraction thunk helper from @escaping @callee_guaranteed () -> (@owned NIO.EventLoopFuture<()>, @error @owned Swift.Error) to @escaping @callee_guaranteed () -> (@out NIO.EventLoopFuture<()>, @error @owned Swift.Error) at /build/<compiler-generated>:0
api_1  | 0x556dd187a128
api_1  | 0x556dd18bea0b, closure #1 () -> () in NIO.SelectableEventLoop.scheduleTask<A>(deadline: NIO.NIODeadline, _: () throws -> A) -> NIO.Scheduled<A> at /build/.build/checkouts/swift-nio/Sources/NIO/SelectableEventLoop.swift:215
api_1  | 0x556dd18c1430, reabstraction thunk helper from @escaping @callee_guaranteed () -> () to @escaping @callee_guaranteed () -> (@out ()) at /build/<compiler-generated>:0
api_1  | 0x556dd18c1430, partial apply forwarder for reabstraction thunk helper from @escaping @callee_guaranteed () -> () to @escaping @callee_guaranteed () -> (@out ()) at /build/<compiler-generated>:0
api_1  | 0x556dd18bdd61, reabstraction thunk helper from @escaping @callee_guaranteed () -> (@out ()) to @escaping @callee_guaranteed () -> () at /build/.build/checkouts/swift-nio/Sources/NIO/SelectableEventLoop.swift:0
api_1  | 0x556dd18bdd61, closure #3 () -> () in NIO.SelectableEventLoop.run() throws -> () at /build/.build/checkouts/swift-nio/Sources/NIO/SelectableEventLoop.swift:430
api_1  | 0x556dd18bdd61, reabstraction thunk helper from @callee_guaranteed () -> (@error @owned Swift.Error) to @escaping @callee_guaranteed () -> (@out (), @error @owned Swift.Error) at /build/<compiler-generated>:0
api_1  | 0x556dd18bdd61, generic specialization <()> of NIO.withAutoReleasePool<A>(() throws -> A) throws -> A at /build/.build/checkouts/swift-nio/Sources/NIO/SelectableEventLoop.swift:26
api_1  | 0x556dd18bdd61, NIO.SelectableEventLoop.run() throws -> () at /build/.build/checkouts/swift-nio/Sources/NIO/SelectableEventLoop.swift:429
api_1  | 0x556dd18753ea, closure #1 (NIO.NIOThread) -> () in static NIO.MultiThreadedEventLoopGroup.(setupThreadAndEventLoop in _D5D78C61B22284700B9BD1ACFBC25157)(name: Swift.String, selectorFactory: () throws -> NIO.Selector<NIO.NIORegistration>, initializer: (NIO.NIOThread) -> ()) -> NIO.SelectableEventLoop at /build/.build/checkouts/swift-nio/Sources/NIO/EventLoop.swift:753
api_1  | 0x556dd1879e22, partial apply forwarder for closure #1 (NIO.NIOThread) -> () in static NIO.MultiThreadedEventLoopGroup.(setupThreadAndEventLoop in _D5D78C61B22284700B9BD1ACFBC25157)(name: Swift.String, selectorFactory: () throws -> NIO.Selector<NIO.NIORegistration>, initializer: (NIO.NIOThread) -> ()) -> NIO.SelectableEventLoop at /build/<compiler-generated>:0
api_1  | 0x556dd18d6eee, reabstraction thunk helper from @escaping @callee_guaranteed (@guaranteed NIO.NIOThread) -> () to @escaping @callee_guaranteed (@in_guaranteed NIO.NIOThread) -> (@out ()) at /build/<compiler-generated>:0
api_1  | 0x556dd1879e40, partial apply forwarder for reabstraction thunk helper from @escaping @callee_guaranteed (@guaranteed NIO.NIOThread) -> () to @escaping @callee_guaranteed (@in_guaranteed NIO.NIOThread) -> (@out ()) at /build/<compiler-generated>:0
api_1  | 0x556dd18d8009, closure #1 (Swift.Optional<Swift.UnsafeMutableRawPointer>) -> Swift.Optional<Swift.UnsafeMutableRawPointer> in static NIO.ThreadOpsPosix.run(handle: inout Swift.Optional<Swift.UInt>, args: NIO.Box<(body: (NIO.NIOThread) -> (), name: Swift.Optional<Swift.String>)>, detachThread: Swift.Bool) -> () at /build/.build/checkouts/swift-nio/Sources/NIO/ThreadPosix.swift:97
api_1  | 0x7fb0bb0e06da
api_1  | 0x7fb0b906c88e
api_1  | 0xffffffffffffffff
psvaporv4_api_1 exited with code 132

I apologize if this question is easily solvable,

In my XML document I have a custom attribute dc:creator (which specifies the author) that is also encoded in CDATA. I was wondering how I would use FeedKit with custom attributes and when they're encoded in CDATA.

Hi,

I really like your pod, it's working great except for one issue.

I'm having problems with parsing a Danish RSS feed. The strings are not coming back with correct encoding and therefore weird characters are showing up in the app.

Help would be appreciated :)

As far as I can tell, FeedKit only fetches the last 10 RSS items in a feed.

Is it possible/would you consider adding an index to access, for example, posts 11-20? I think an index would be the best way to solve this because having just a number of items to load option would make the first load slower. I’d rather load more items as needed.

OK I am using pod 6

sometimes this url: http://www.newsbtc.com/feed/

will return HTML and quickly crash 👍

        FeedParser(URL: feedURL)!.parseAsync { (result) in

Normall it returns an RSS feed but through my testing it will block too many transactions and return HTML saying you need to talk to support.

While literally speaking it made sense to close issue #141, this repo is still missing its documentation.

@nmdias, do you have the old files published on the now defunct CocoaDocs handy?

As a see it, there are at least two actions that need to be taken:

1. Adopt GitHub Wikis: https://docs.github.com/en/communities/documenting-your-project-with-wikis/adding-or-editing-wiki-pages
2. Remove the old docs link from the README file.

I'm willing to help adapting the old docs into the wiki if time is a concern.

Hi! Thanks for a nice library!

I would like to access atom links in RSS feeds. Is it possible? I can't find a way to do it.

For instance look here: https://feeds.megaphone.fm/VMP9331026707

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:googleplay="http://www.google.com/schemas/play-podcasts/1.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
    <channel>
        <atom:link href="https://feeds.megaphone.fm/VMP9331026707" rel="self" type="application/rss+xml"/>
        ...

Undefined symbol: nominal type descriptor for FeedKit.RSSFeedItem

Undefined symbol: protocol conformance descriptor for FeedKit.ParserError : Swift.Error in FeedKit

Undefined symbol: FeedKit.FeedParser.__allocating_init(URL: Foundation.URL) -> FeedKit.FeedParser

Undefined symbol: type metadata accessor for FeedKit.RSSFeedItem

Undefined symbol: type metadata accessor for FeedKit.FeedParser

Undefined symbol: type metadata for FeedKit.ParserError

I have an aging website whose backing store is a whole pile of Atom Entry Documents, and I'd like to replace the Python script that processes them with a Swift program. But it doesn't look like FeedKit supports these documents; I get a feedNotFound error when I try to parse one.