Swift parser for JSON Feed — a new format similar to RSS and Atom but in JSON. For more information about this new feed format visit: https://jsonfeed.org
- Implement framework so its usable
- Proper in-line documentation
- Clear documentation in README (you are looking at it now)
- Add CococaPods support
- Add Carthage support
- Add SPM support
- Add CHANGELOG to repository
- Add much more elaborate tests
- Add
Equtablefor objects it makes sense - Consider adding byte and date formatter for
JSONFeedAttachment
Thanks for checking-out JSONFeed!
Parsing a feed is super easy; just pass data from a response when creating a feed object and that's it! Parsing happens upon initialization using JSONSerialization and if all goes well you'll be able to access feed properties. In case initialization parameters are invalid, JSONFeed will throw JSONFeedError.
let feed = try? JSONFeed(data: responseData)Alternatively you can create objects from a JSON string or JSON dictionary:
let dictionary: [String: Any] = ["title": "..."]
let feed = try? JSONFeed(json: dictionary)let utf8String: String = "{'title':'..."
let feed = try? JSONFeed(jsonString: utf8String)Best way to learn about this library is to browse source files and inline documentation.
Below is quick description of objects and their responsibilities:
JSONFeed mirrors JSON Feed v1 spec defined keys almost one-to-one. Key names are "Swiftyfied" and strongly typed: all dates will be Date type, URLs — URL and so on. All fields defined by optional in spec are also Swift optionals in all objects.
feed.items is an array of JSONFeedItem objects that wrap your items (posts, episodes for podcasts, etc.). It can not be nil, but can contain 0 elements.
According to specs both are optional and both can be present in item at the same time. However if none of them is set by publisher, post will be discarded and not included in items array.
If id for the item is not set by publisher, item will be discarded and not included in items. This happens silently and no error will be thrown. Any other posts with set id will be peresent in array (unless both, contextText and contentHTML are missing). Reason for that in clearly elaborated in Suggestions for Feed Readers of JSON Feed v1 spec:
[...] there is one thing we insist on: any item without an id must be discarded. We come to this from years of experience dealing with feeds in other formats where unique identifiers are optional. Without unique identifiers, it’s impossible to reliably refer to a given item and its changes over time, and this is terrible for user experience and becomes a source of bug reports to you.
Items can have attachments, they are wrapped in JSONFeedAttachment object. Attachment can be podcast episode, additional images, or any other media.
You can lear about attachment type using mimeType property. All attachments have url pointing to attached media. Those two are always present in all attachments.
Additionally JSONFeedAttachment have optional size (in bytes) and duration (in seconds) for relevant media files.
Inert JSONFeedAuthor struct with name, avatar URL and web URL. Can be present both in JSONFeedItem and/or in JSONFeed.
You can use CocoaPods to install JSONFeed by adding it to your Podfile:
platform :ios, '10.0'
use_frameworks!
pod 'JSONFeed'Import JSONFeed wherever you plan to parse feed and follow instructions from above.
Create a Cartfile that lists the framework and run carthage update. Follow the instructions to add $(SRCROOT)/Carthage/Build/iOS/JSONFeed.framework to an iOS project.
github "totocaster/JSONFeed"
Download and drop all files from Classes folder into in your project.
JSONFeed is released under the MIT license. See LICENSE for details.