OAuth2Requestable

Set to true to log all the things. false by default. Use "verbose": bool in settings or assign logger yourself.

The logger being used. Auto-assigned to a debug logger if you set verbose to true or false.

Base initializer.

Designated initializer.

The instance’s current session, creating one by the book if necessary. Defaults to using an ephemeral session, you can use sessionConfiguration and/or sessionDelegate to affect how the session is configured.

The configuration to use when creating session. Uses an +ephemeralSessionConfiguration() if nil.

URL session delegate that should be used for the NSURLSession the instance uses for requests.

The instance’s OAuth2RequestPerformer, defaults to using OAuth2DataTaskRequestPerformer which uses URLSession.dataTask().

Perform the supplied request and call the callback with the response JSON dict or an error. This method is intended for authorization calls, not for data calls outside of the OAuth2 dance.

This implementation uses the shared NSURLSession and executes a data task. If the server responds with an error, this will be converted into an error according to information supplied in the response JSON (if availale).

The callback returns a response object that is easy to use, like so:

perform(request: req) { response in
    do {
        let data = try response.responseData()
        // do what you must with `data` as Data and `response.response` as HTTPURLResponse
    }
    catch let error {
        // the request failed because of `error`
    }
}

Easy, right?

Can be called to immediately abort the currently running authorization request, if it was started by perform(request:callback:).

Parse string-only JSON from NSData.

Parse a query string into a dictionary of String: String pairs.

If you’re retrieving a query or fragment from NSURLComponents, use the percentEncoded## variant as the others automatically perform percent decoding, potentially messing with your query string.