Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated setImage to setImageUrl for Improved API and cancelling logic #17

Merged
merged 4 commits into from
Oct 21, 2020
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Example/Example/ViewController.swift
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ final class ViewController: UIViewController {
override func viewDidAppear(_ animated: Bool) {
super.viewDidAppear(animated)

imageView.ok.setImage(with: URL(string: "https://www.gstatic.com/webp/gallery/4.webp")!)
imageView.ok.setImageUrl(with: URL(string: "https://www.gstatic.com/webp/gallery/4.webp")!)
gugges marked this conversation as resolved.
Show resolved Hide resolved
}
}

22 changes: 18 additions & 4 deletions Sources/Extensions/UIButton+ImageDownloader.swift
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,25 @@
import UIKit

public extension ObjectWrapper where T: UIButton {
gugges marked this conversation as resolved.
Show resolved Hide resolved

var imageUrl: URL? {
get {
imageDownloaderReceipt?.url
}
set {
setImageUrl(with: newValue)
}
}

func setImage(with url: URL,
for state: UIControl.State = .normal,
imageDownloader: ImageDownloading = ImageDownloader.shared,
completionHandler: ImageDownloader.CompletionHandler? = nil) {
func setImageUrl(with url: URL?,
for state: UIControl.State = .normal,
imageDownloader: ImageDownloading = ImageDownloader.shared,
completionHandler: ImageDownloader.CompletionHandler? = nil) {
guard let url = url else {
cancelImageDownload(imageDownloader: imageDownloader)
return
}

if imageDownloaderReceipt != nil {
assertionFailure("Active Download In Progress, Cancel Before Starting a New Request")
}
Expand Down
20 changes: 17 additions & 3 deletions Sources/Extensions/UIImageView+ImageDownloader.swift
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,24 @@
import UIKit

public extension ObjectWrapper where T: UIImageView {

var imageUrl: URL? {
get {
imageDownloaderReceipt?.url
}
set {
setImageUrl(with: newValue)
}
}

func setImage(with url: URL,
imageDownloader: ImageDownloading = ImageDownloader.shared,
completionHandler: ImageDownloader.CompletionHandler? = nil) {
func setImageUrl(with url: URL?,
imageDownloader: ImageDownloading = ImageDownloader.shared,
completionHandler: ImageDownloader.CompletionHandler? = nil) {
guard let url = url else {
cancelImageDownload(imageDownloader: imageDownloader)
return
}

if imageDownloaderReceipt != nil {
assertionFailure("Active Download In Progress, Cancel Before Starting a New Request")
}
Expand Down
67 changes: 52 additions & 15 deletions Tests/UIButtonImageDownloaderTests.swift
Original file line number Diff line number Diff line change
Expand Up @@ -30,20 +30,20 @@ final class UIButtonImageDownloaderTests: XCTestCase {
button = UIButton(type: .custom)
}

func test_setImage_itSetsTheImageDownloadReceipt() {
func test_setImageUrl_itSetsTheImageDownloadReceipt() {
MockUrlProtocol.requestHandler = { request in
XCTAssertEqual(request.url, self.url)
return (HTTPURLResponse(), self.expectedImageData)
}

XCTAssertNil(button.ok.imageDownloaderReceipt)

button.ok.setImage(with: url, imageDownloader: imageDownloader, completionHandler: nil)
button.ok.setImageUrl(with: url, imageDownloader: imageDownloader, completionHandler: nil)

XCTAssertNotNil(button.ok.imageDownloaderReceipt)
}

func test_setImage_whenSuccess_itNilsTheImageDownloadReceipt() {
func test_setImageUrl_whenSuccess_itNilsTheImageDownloadReceipt() {
MockUrlProtocol.requestHandler = { request in
XCTAssertEqual(request.url, self.url)
return (HTTPURLResponse(), self.expectedImageData)
Expand All @@ -53,7 +53,7 @@ final class UIButtonImageDownloaderTests: XCTestCase {

let expectation = self.expectation(description: "Nil Receipt on Completion")

button.ok.setImage(with: url, for: .normal, imageDownloader: imageDownloader) { (result, receipt) in
button.ok.setImageUrl(with: url, for: .normal, imageDownloader: imageDownloader) { (result, receipt) in
switch result {
case .success:
break
Expand All @@ -71,7 +71,7 @@ final class UIButtonImageDownloaderTests: XCTestCase {
wait(for: [expectation], timeout: 5)
}

func test_setImage_whenFailure_itNilsTheImageDownloadReceipt() {
func test_setImageUrl_whenFailure_itNilsTheImageDownloadReceipt() {
MockUrlProtocol.requestHandler = { request in
XCTAssertEqual(request.url, self.url)
return (HTTPURLResponse(), Data())
Expand All @@ -81,7 +81,7 @@ final class UIButtonImageDownloaderTests: XCTestCase {

let expectation = self.expectation(description: "Nil Receipt on Completion")

button.ok.setImage(with: url, for: .normal, imageDownloader: imageDownloader) { (result, receipt) in
button.ok.setImageUrl(with: url, for: .normal, imageDownloader: imageDownloader) { (result, receipt) in
switch result {
case .success:
XCTFail()
Expand All @@ -107,7 +107,7 @@ final class UIButtonImageDownloaderTests: XCTestCase {

XCTAssertNil(button.ok.imageDownloaderReceipt)

button.ok.setImage(with: url, imageDownloader: imageDownloader, completionHandler: nil)
button.ok.setImageUrl(with: url, imageDownloader: imageDownloader, completionHandler: nil)

XCTAssertNotNil(button.ok.imageDownloaderReceipt)

Expand All @@ -116,7 +116,7 @@ final class UIButtonImageDownloaderTests: XCTestCase {
XCTAssertNil(button.ok.imageDownloaderReceipt)
}

func test_setImage_whenSuccessAndCompletionHandler_itForwardsCompletionHandler() {
func test_setImageUrl_whenSuccessAndCompletionHandler_itForwardsCompletionHandler() {
MockUrlProtocol.requestHandler = { request in
XCTAssertEqual(request.url, self.url)
return (HTTPURLResponse(), self.expectedImageData)
Expand All @@ -136,12 +136,12 @@ final class UIButtonImageDownloaderTests: XCTestCase {
expectation.fulfill()
}

button.ok.setImage(with: url, imageDownloader: imageDownloader, completionHandler: completionHandler)
button.ok.setImageUrl(with: url, imageDownloader: imageDownloader, completionHandler: completionHandler)

wait(for: [expectation], timeout: 20)
}

func test_setImage_whenFailureAndCompletionHandler_itForwardsCompletionHandler() {
func test_setImageUrl_whenFailureAndCompletionHandler_itForwardsCompletionHandler() {
MockUrlProtocol.requestHandler = { request in
XCTAssertEqual(request.url, self.url)
return (HTTPURLResponse(), Data())
Expand All @@ -161,20 +161,20 @@ final class UIButtonImageDownloaderTests: XCTestCase {
expectation.fulfill()
}

button.ok.setImage(with: url, imageDownloader: imageDownloader, completionHandler: completionHandler)
button.ok.setImageUrl(with: url, imageDownloader: imageDownloader, completionHandler: completionHandler)

wait(for: [expectation], timeout: 20)
}

func test_setImage_whenSuccessAndNoCompletionHandler_itSetsTheImageForState() {
func test_setImageUrl_whenSuccessAndNoCompletionHandler_itSetsTheImageForState() {
MockUrlProtocol.requestHandler = { request in
XCTAssertEqual(request.url, self.url)
return (HTTPURLResponse(), self.expectedImageData)
}

XCTAssertNil(button.imageView?.image)

button.ok.setImage(with: url, for: .highlighted, imageDownloader: imageDownloader, completionHandler: nil)
button.ok.setImageUrl(with: url, for: .highlighted, imageDownloader: imageDownloader, completionHandler: nil)

let expectation = XCTestExpectation(description: "Image Downloader UIButton Success Response")

Expand All @@ -187,15 +187,15 @@ final class UIButtonImageDownloaderTests: XCTestCase {
wait(for: [expectation], timeout: 20)
}

func test_setImage_whenFailureAndNoCompletionHandler_itDoesNotSetTheImage() {
func test_setImageUrl_whenFailureAndNoCompletionHandler_itDoesNotSetTheImage() {
MockUrlProtocol.requestHandler = { request in
XCTAssertEqual(request.url, self.url)
return (HTTPURLResponse(), Data())
}

let expectation = XCTestExpectation(description: "Image Downloader UIImageView Failure Response")

button.ok.setImage(with: url, imageDownloader: imageDownloader, completionHandler: nil)
button.ok.setImageUrl(with: url, imageDownloader: imageDownloader, completionHandler: nil)

DispatchQueue.main.asyncAfter(deadline: .now() + MockAsyncUrlProtocol.deadline + 0.1) {
XCTAssertNil(self.button.imageView?.image)
Expand All @@ -204,4 +204,41 @@ final class UIButtonImageDownloaderTests: XCTestCase {

wait(for: [expectation], timeout: 20)
}

func test_setImageUrl_whenNil_itCancelsTheImageDownloadButLeavesTheImage() {
MockUrlProtocol.requestHandler = { request in
XCTAssertEqual(request.url, self.url)
return (HTTPURLResponse(), self.expectedImageData)
}

XCTAssertNil(button.ok.imageDownloaderReceipt)

let mockImageDownloader: MockImageDownloader = .init()

button.ok.setImageUrl(with: url, imageDownloader: mockImageDownloader, completionHandler: nil)

button.imageView?.image = expectedImage

XCTAssertNotNil(button.ok.imageDownloaderReceipt)
XCTAssertEqual(mockImageDownloader.cancelCallCount, 0)

button.ok.setImageUrl(with: nil, imageDownloader: mockImageDownloader)

XCTAssertNil(button.ok.imageDownloaderReceipt)
XCTAssertEqual(mockImageDownloader.cancelCallCount, 1)
XCTAssertNotNil(button.imageView?.image)
}

func test_imageUrl_whenNilUrl_itCancelsTheDownload() {
XCTAssertNil(button.ok.imageDownloaderReceipt)

button.ok.imageUrl = url

XCTAssertNotNil(button.ok.imageDownloaderReceipt)
XCTAssertEqual(button.ok.imageUrl, url)

button.ok.imageUrl = nil

XCTAssertNil(button.ok.imageDownloaderReceipt)
}
}
Loading