Implement Sync (Default) and Async For All Functions/Classes

[davidvonthenen]

Depends on #199

This implements Sync (Default) and Async For All Functions/Classes. I was originally going to deprecate the Async to reduce the amount of code to maintain, but I convinced myself to support both. There is some utility to having the Async functions as they are good for things like:

• quick development and prototyping
• demos when speed isn't important

All examples were updated to use the sync functions/classes, and provided a couple of examples for async.

This follows the pattern a lot of other IO/CPU intensive libraries have set where sync/threading is the default and async is an option. Some good examples to reference are libraries that we consume in this SDK. For example:

• WebSockets
  • threading is the default - https://github.com/python-websockets/websockets/blob/main/src/websockets/client.py
  • async is legacy - https://github.com/python-websockets/websockets/blob/main/src/websockets/legacy/client.py
• httpx
  • threading/sync is default:

    >>> import httpx
    >>> r = httpx.get('https://www.example.org/')
    >>> r
    <Response [200 OK]>
    

  • async requires an additional property for access:

    >>> async with httpx.AsyncClient() as client:
    ...     r = await client.get('https://www.example.com/')
    ...
    >>> r
    <Response [200 OK]>
    

[davidvonthenen]

rebased changes after merging #199