wip async implementation

[nick-potts]

• Added automated tests
• Documented for all relevant versions
• Updated the changelog

resolves #32

Changes

Added an executeAsync that returns a PromiseInterface. The interface is an extension of the guzzle interface - it's a good standard but this does mean that every client needs to have an adapter. The upside is that the generated code just has a sailor provided interface, not guzzle.

The alternative is that you could specify an async interface you want to use when generating - this would make it easier to use both when making your own client, as well as using the responses. in the current implementation, you'll need to unwrap the promise using your own library's async.

I've also provided a default async guzzle and guzzle adapter.

I didn't update the tests that compare the output generation.

Breaking changes

N/A

[nick-potts]

turns out the adapter wasn't working as intended, and getting it typesafe was tricky. I think having an option in the config that allows you to set the async client response type would make the most sense.

[nick-potts]

After some thought, it actually makes more sense to just do the async inside of the client, requiring no modification to the library itself.

        $json = ['query' => $query];
        if (!is_null($variables)) {
            $json['variables'] = $variables;
        }

        $browser = new Browser();
        $promise = $browser->post($url, [
            'Content-Type' => 'application/json',
        ],
            json_encode($json)
        );
        $response = await($promise);
        return Response::fromResponseInterface($response);

[spawnia]

I am glad you figured something out, thanks for documenting your solution here.