README.md

NMAImageFetch

NMAImageFetch is library for downloading and caching images efficiently using UIKit or SwiftUI.

Prerequisites

• iOS 12.0+

Installation

Swift Package Manager

• File > Swift Packages > Add Package Dependency
• Add https://github.com/nomasystems/nimagefetch-ios.git
• Select "Up to next major" with "2.0.0"

Usage

Loading an image using a NImageFetchView(subclass of UIImageView)

let imageView: NImageFetchView = .init(frame: .zero)

imageView.setImage(from: URLRequest(url: url))

Loading an image using an UIImageView

let imageView: UIImageView = .init(frame: .zero)

let imageFetchRequest = ImageFetchRequest(urlRequest: URLRequest(url: url))
_ = ImageFetch.shared.requestImage(imageFetchRequest) { result in
    switch result {
        case let .success(uiImage, _):
            self.imageView.image = uiImage
        case .failure(let error):
            switch error {
                case .cancelled:
                    break
                case let .networkError(err):
                    print(err?.localizedDescription ?? "unknown network error")
            }
    }
}

Cancel loading

let imageView: UIImageView = .init(frame: .zero)

let imageFetchRequest = ImageFetchRequest(urlRequest: URLRequest(url: url))
let task = ImageFetch.shared.requestImage(fetchRequest) { _ in }
if let task = task {
    ImageFetch.shared.cancel(task)
}

Clear caches

Using async/await

await ImageFetch.shared.purgeCaches()

Using completion closures

await ImageFetch.shared.purgeCaches() {
    // Called when purge finishes
}

SwiftUI

Load image from URL

ImageFetchView(url: url, animated: .always, fallbackImage: nil)

Load image from URLRequest

ImageFetchView(urlRequest: URLRequest(url: url), animated: .ifAsync, fallbackImage: UIImage(named: "..."))

Load image from ImageFetchRequest

ImageFetchView(imageFetchRequest: ImageFetchRequest(urlRequest: URLRequest(url: url)), animated: .never, fallbackImage: nil)

Support

Any doubt or suggestion? Please check out our issue tracker.