Note: This library is still in its early stages! I will experiment and change the API until I am satisfied with the result. I do not reccomend using this library in larger projects, although feedback will be highly appreciated
Installation
Swift Package Manager
Add to Package.swift:
.package(url: "https://github.com/witekbobrowski/EPUBKit.git", from: "0.4.0")
CocoaPods
Add the following to your Podfile:
pod 'EPUBKit'
Usage
Basic
Just import EPUBKit in your swift file.
import EPUBKit
Initialize document instance with URL of your EPUB document.
guard
let path = Bundle.main.url(forResource: "steve_jobs", withExtension: "epub"),
let document = EPUBDocument(url: path)
else { return }
If the document gets parsed correctly, you have access to full document metadata, contents, etc.
print(document.title)
> Steve Jobs
print(document.author)
> Walter Isaacson
Advanced
Lets say we are developing an app for iOS and have a view controller that handles epub documents in some way, for example displays a list.
In the first place you could add these two properties to the view controller (dont forget to import the library).
let parser: EPUBParser
let urls: [URL]
var documents: [EPUBDocument] = []
And feed the VC with the missing properties through the dependency injection in init.
init(parser: EPUBParser, urls: [URL]) {
self.parser = parser
self.urls = urls
super.init(nibName: nil, bundle: nil)
}
Now after the view loads we could set ourselfs as the delegate of the parser (after extending view controller with EPUBParserDelegate protocol, otherwise we get an error).
parser.delegate = self
And iterate over the array of url in hope of parsing every document correctly and append them to previously defined array.
urls.forEach { url in
guard let document = try? parser.parse(documentAt: url) else { return }
documents.append(document)
}
And that is basically it. Now for example, you could pass parsed documents to the table view.
What are the adventages of taking this approach? Firstly its reusing the parser object.
Using the previously mentioned EPUBDocument's init(url:) initializer we avoid instantiating it every time for each document.
Now we have also a lot more insight on the parsing process itself, we could either check on errors in the standard swift way using do-catch statement,
or using delegation and parser(:,didFailParsingDocumentAt:,with:) that passes an error if such occurs.
And finally we could improve user experience with something like starting to load cover before the process of parsing finishes.
As the library evolves and API gets richer and richer the possibilities of advanced usage of this library will come more and more handy.
Note: Documentation is not yet ready, but you should find it easy to explore the API by yourself