I thought the best way to show the ReactiveAPI potential is to make a demo app with it from scratch, with the bare minimum to show something to the user. I used swapi.co open APIs and only ReactiveAPI as dependency. Updated Readme as well with some examples taken from the demo.

• ReactiveAPIDemo adopts SPM & xcodegen
• Referenced SPM package --> url: https://github.com/sky-uk/ReactiveAPI.git branch: spm ReactiveAPIDemo is not visible in Xcode navigator of ReactiveAPI project

• Reactive API can be imported using SPM & Carthage
• No demo example (A fresh new demo&/prj can be added once this branch is merged)
• TODO: tests refactoring with SkyTestFoundation

inject existing token when failed requests don't have a token or hav a token different from the current one. This reduces requests made to the backend. Updated HTTPStubs implementation.

Current TokenAuthenticationDemo token renew was broken when trying to do multiple symultaneous requests, which resulted in multiple token renew requests when each one of the original requests got 401 from server.

To solve this and to help library users write simple token-based authenticators, the new ReactiveAPITokenAuthenticator has been introduced.

To ease debugging, an optional ReactiveAPITokenAuthenticatorLogger can be provided.

It often happens to pass complex data types as query string (e.g. Date) and to have the need of doing custom string representation of the objects. This adds that possibility.

When declaring an API with the following signature

func myAPI() -> Single<[MyDataType]>

Xcode won't compile complaining about "ambiguous reference". This is because:

    func request<D: Decodable>(_ method: ReactiveAPIHTTPMethod = .get,
                               url: URL,
                               headers: [String: Any?]? = nil,
                               queryParams: [String: Any?]? = nil,
                               bodyParams: [String: Any?]? = nil) -> Single<[D]>

conflicts with

    func request<D: Decodable>(_ method: ReactiveAPIHTTPMethod = .get,
                               url: URL,
                               headers: [String: Any?]? = nil,
                               queryParams: [String: Any?]? = nil,
                               bodyParams: [String: Any?]? = nil) -> Single<D>

because[D] is the same as D when D: Decodable

Fixed by removing the redundant functions!

Yesterday Apple unveiled Combine, an Rx Like framework for iOS 13+ and macOS 10.15+.

https://developer.apple.com/documentation/combine/publisher

This is a game changer and can be a huge benefit for ReactiveAPI looking forward.

Up to this point if we set baseUrl = https://www.server.com/api and we have an API which needs to call the baseURL, we need to write a func like this:

func getRoot() -> Single<Root> {
    return request(url: absoluteURL(""))
}

absoluteURL("") is really ugly, we should find a more elegant way