Question 1

How to mock API responses dynamically in Swift using Kakapo?

Accepted Answer

Use Kakapo's Router to register endpoints and the Store to manage entity states. For example, create a Router with a base URL, define GET/POST handlers, and use Store methods like create or find to return Serializable objects that simulate CRUD operations.

Question 2

Kakapo vs OHHTTPStubs for iOS unit testing?

Accepted Answer

Kakapo excels at dynamic, state-aware mocking with Swift-native serialization and JSONAPI support, while OHHTTPStubs is better for simple, static response stubbing from files. Choose Kakapo for complex backend behavior simulation and OHHTTPStubs for lightweight, file-based mocking.

Question 3

Can I use Kakapo with Alamofire in my project?

Accepted Answer

Yes, but you need to configure URLSessionConfiguration to set protocolClasses to [Server.self]. This allows Alamofire to intercept requests through Kakapo's Router, though it requires additional setup compared to native URLSession usage.

Question 4

How to serialize a Swift struct to JSON with custom keys in Kakapo?

Accepted Answer

Conform your struct to Serializable and use a SerializationTransformer like SnakecaseTransformer. For more control, implement CustomSerializable to define custom serialization logic, as shown in the README with key transformations.

Question 5

Does Kakapo support mocking APIs with authentication headers?

Accepted Answer

Yes, use ResponseFieldsProvider, such as the Response struct, to wrap Serializable objects with custom status codes and header fields. This allows including headers like access tokens in mocked responses, as demonstrated with headerFields.

Question 6

What are the limitations of Kakapo for JSONAPI mocking?

Accepted Answer

While it offers JSONAPISerializer, the roadmap notes incomplete features like reverse and recursive relationships. It's suitable for basic JSONAPI compliance but may lack advanced functionality needed for complex API structures.

Kakapo

What is Kakapo?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions