Question 1

How do I add authentication headers to image requests in Imaginary?

Accepted Answer

Use the ImageDownloader's modifyRequest closure in the Option to customize HTTP headers, as shown in the README example for adding Bearer tokens. This allows seamless integration with secured APIs without modifying core logic.

Question 2

Is Imaginary better than Kingfisher for iOS apps?

Accepted Answer

Imaginary offers a narrower, cache-focused API with flexibility via protocols, while Kingfisher provides more built-in features like GIF support and a larger ecosystem. Choose Imaginary for lightweight, customizable caching; prefer Kingfisher for out-of-the-box advanced capabilities.

Question 3

Can Imaginary handle image resizing before caching?

Accepted Answer

Yes, but you need to implement a custom ImageProcessor, as the built-in ResizeImageProcessor is marked incomplete in the README. This requires extra code compared to libraries with ready-to-use resize options.

Question 4

How to clear the image cache in Imaginary?

Accepted Answer

Access the storage via Configuration.imageStorage and use methods from the Cache library to remove or manage cached data. The README references Cache for storage details, but direct cache clearing isn't explicitly documented.

Question 5

Does Imaginary support prefetching for UITableView?

Accepted Answer

Yes, it includes MultipleImageFetcher for prefetching, ideal for UICollectionView as noted, but can be adapted for UITableView. However, setup requires manual integration compared to libraries with dedicated UITableView extensions.

Question 6

What's the best way to implement a custom image displayer in Imaginary?

Accepted Answer

Conform to the ImageDisplayer protocol and specify it in the Option, as detailed in the advanced section. This allows displaying images on any view, but requires additional Swift code for each custom view type.

Imaginary

What is Imaginary?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions