This one is a big deal, since it reintroduces the sync client, and is essentially a 1.0 pre-release in terms of how the API looks.

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

🎉✨ TA-DA! ✨🎉

Release notes

0.11.0 (January 9th, 2019)

The 0.11 release reintroduces our sync support, so that httpx now supports both a standard thread-concurrency API, and an async API.

Existing async httpx users that are upgrading to 0.11 should ensure that:

• Async codebases should always use a client instance to make requests, instead of the top-level API.
• The async client is named as httpx.AsyncClient(), instead of httpx.Client().
• When instantiating proxy configurations use the httpx.Proxy() class, instead of the previous httpx.HTTPProxy(). This new configuration class works for configuring both sync and async clients.

We believe the API is now pretty much stable, and are aiming for a 1.0 release sometime on or before April 2020.

Changed

• Top level API such as httpx.get(url, ...), httpx.post(url, ...), httpx.request(method, url, ...) becomes synchronous.
• Added httpx.Client() for synchronous clients, with httpx.AsyncClient being used for async clients.
• Switched to proxies=httpx.Proxy(...) for proxy configuration.
• Network connection errors are wrapped in httpx.NetworkError, rather than exposing lower-level exception types directly.

Removed

• The request.url.origin property and httpx.Origin class are no longer available.
• The per-request cert, verify, and trust_env arguments are escalated from raising errors if used, to no longer being available. These arguments should be used on a per-client instance instead, or in the top-level API.
• The stream argument has escalated from raising an error when used, to no longer being available. Use the client.stream(...) or httpx.stream() streaming API instead.

Fixed

• Redirect loop detection matches against (method, url) rather than url. (Pull Fixed redirect loop #734)

What's next...

I'd expect that we'll likely end up waiting for a period of time after this release, and then end up releasing a 1.0 with either no API changes, or only very minimal API changes. (The only remaining area I can see us still wanting to refine/change, would be some review making sure we've got an exception heirarchy/naming that we're entirely happy to stick with for 1.0 onwards)

Checklist

• Reintroduce Client as a sync client. Reintroduce sync API. #735
• Reintroduce WSGIDispatch. Reintroduce sync API. #735
• Top-level API becomes sync, not async. Reintroduce sync API. #735
• Drop Origin from public API. Drop Origin from public API #688
• Use httpx.Proxy() for proxy configuration, not the httpx.HTTPProxy dispatch class. Prep for introducing SyncClient #713
• Consider switching client.params, client.headers, client.cookies so that they don't have a setter/getter mismatch. Refs Make client.cookies setter expect a Cookies instance #678 use properties to allow more easily changing cookies/headers after init #274
• Consider dropping UDS support. Consider pushing back on UDS support. #723
• Wrap IO Exceptions in httpx exceptions. Wrap network errors as HTTPX-specific exceptions #707
• Docs Proposed 0.11 docs #727
• httpx.Auth becomes public API. Public Auth API #732 Public API for auth flow. #731