httpx

The 0.9 releases brings some major new features, including:

• A new streaming API.
• Autodetection of either asyncio or trio.
• Nicer timeout configuration.
• HTTP/2 support off by default, but can be enabled.

We've also removed all private types from the top-level package export.

In order to ensure you are only ever working with public API you should make sure to only import the top-level package eg. import httpx, rather than importing modules within the package.

Added

• Added concurrency backend autodetection. (Pull #585)
• Added Client(backend='trio') and Client(backend='asyncio') API. (Pull #585)
• Added response.stream_lines() API. (Pull #575)
• Added response.is_error API. (Pull #574)
• Added support for timeout=Timeout(5.0, connect_timeout=60.0) styles. (Pull #593)

Fixed

• Requests or Clients with timeout=None now correctly always disable timeouts. (Pull #592)
• Request 'Authorization' headers now have priority over .netrc authentication info. (Commit 095b691)
• Files without a filename no longer set a Content-Type in multipart data. (Commit ed94950)

Changed

• Added httpx.stream() API. Using stream=True now results in a warning. (Pull #600, #610)
• HTTP/2 support is switched to "off by default", but can be enabled explicitly. (Pull #584)
• Switched to Client(http2=True) API from Client(http_versions=["HTTP/1.1", "HTTP/2"]). (Pull #586)
• Removed all private types from the top-level package export. (Pull #608)
• The SSL configuration settings of verify, cert, and trust_env now raise warnings if used per-request when using a Client instance. They should always be set on the Client instance itself. (Pull #597)
• Use plain strings "TUNNEL_ONLY" or "FORWARD_ONLY" on the HTTPProxy proxy_mode argument. The HTTPProxyMode enum still exists, but its usage will raise warnings. (#610)
• Pool timeouts are now on the timeout configuration, not the pool limits configuration. (Pull #563)
• The timeout configuration is now named httpx.Timeout(...), not httpx.TimeoutConfig(...). The old version currently remains as a synonym for backwards compatibility. (Pull #591)

---

Removed

• The synchronous API has been removed, in order to allow us to fundamentally change how we approach supporting both sync and async variants. (See #588 for more details.)

---

Added

• Add support for proxy tunnels for Python 3.6 + asyncio. (Pull #521)

Fixed

• Resolve an issue with cookies behavior on redirect requests. (Pull #529)

Added

• Add request/response DEBUG logs. (Pull #502)
• Use TRACE log level for low level info. (Pull #500)

Removed

• Drop proxies parameter from the high-level API. (Pull #485)

Fixed

• Tweak multipart files: omit null filenames, add support for str file contents. (Pull #482)
• Cache NETRC authentication per-client. (Pull #400)
• Rely on getproxies for all proxy environment variables. (Pull #470)
• Wait for the asyncio stream to close when closing a connection. (Pull #494)

Added

• Allow lists of values to be passed to params. (Pull #386)
• ASGIDispatch, WSGIDispatch are now available in the httpx.dispatch namespace. (Pull #407)
• HTTPError is now available in the httpx namespace. (Pull #421)
• Add support for start_tls() to the Trio concurrency backend. (Pull #467)

Fixed

• Username and password are no longer included in the Host header when basic authentication credentials are supplied via the URL. (Pull #417)

Removed

• The .delete() function no longer has json, data, or files parameters to match the expected semantics of the DELETE method. (Pull #408)
• Removed the trio extra. Trio support is detected automatically. (Pull #390)

Added

• Add Trio concurrency backend. (Pull #276)
• Add params parameter to Client for setting default query parameters. (Pull #372)
• Add support for SSL_CERT_FILE and SSL_CERT_DIR environment variables. (Pull #307)
• Add debug logging to calls into ASGI apps. (Pull #371)
• Add debug logging to SSL configuration. (Pull #378)

Fixed

• Fix a bug when using Client without timeouts in Python 3.6. (Pull #383)
• Propagate Client configuration to HTTP proxies. (Pull #377)

Added

• HTTP Proxy support. (Pulls #259, #353)
• Add Digest authentication. (Pull #332)
• Add .build_request() method to Client and AsyncClient. (Pull #319)
• Add .elapsed property on responses. (Pull #351)
• Add support for SSLKEYLOGFILE in Python 3.8b4+. (Pull #301)

Removed

• Drop NPN support for HTTP version negotiation. (Pull #314)

Fixed

• Fix distribution of type annotations for mypy (Pull #361).
• Set Host header when redirecting cross-origin. (Pull #321)
• Drop Content-Length headers on GET redirects. (Pull #310)
• Raise KeyError if header isn't found in Headers. (Pull #324)
• Raise NotRedirectResponse in response.next() if there is no redirection to perform. (Pull #297)
• Fix bug in calculating the HTTP/2 maximum frame size. (Pull #153)

• Enforce using httpx.AsyncioBackend for the synchronous client. (Pull #232)
• httpx.ConnectionPool will properly release a dropped connection. (Pull #230)
• Remove the raise_app_exceptions argument from Client. (Pull #238)
• DecodeError will no longer be raised for an empty body encoded with Brotli. (Pull #237)
• Added http_versions parameter to Client. (Pull #250)
• Only use HTTP/1.1 on short-lived connections like httpx.get(). (Pull #284)
• Convert Client.cookies and Client.headers when set as a property. (Pull #274)
• Setting HTTPX_DEBUG=1 enables debug logging on all requests. (Pull #277)

• Include files with source distribution to be installable. (Pull #233)

• Add the trust_env property to BaseClient. (Pull #187)
• Add the links property to BaseResponse. (Pull #211)
• Accept ssl.SSLContext instances into SSLConfig(verify=...). (Pull #215)
• Add Response.stream_text() with incremental encoding detection. (Pull #183)
• Properly updated the Host header when a redirect changes the origin. (Pull #199)
• Ignore invalid Content-Encoding headers. (Pull #196)
• Use ~/.netrc and ~/_netrc files by default when trust_env=True. (Pull #189)
• Create exception base class HTTPError with request and response properties. (Pull #162)
• Add HSTS preload list checking within BaseClient to upgrade HTTP URLs to HTTPS. (Pull #184)
• Switch IDNA encoding from IDNA 2003 to IDNA 2008. (Pull #161)
• Expose base classes for alternate concurrency backends. (Pull #178)
• Improve Multipart parameter encoding. (Pull #167)
• Add the headers property to BaseClient. (Pull #159)
• Add support for Google's brotli library. (Pull #156)
• Remove deprecated TLS versions (TLSv1 and TLSv1.1) from default SSLConfig. (Pull #155)
• Fix URL.join(...) to work similarly to RFC 3986 URL joining. (Pull #144)

---

• Check for disconnections when searching for an available connection in ConnectionPool.keepalive_connections (Pull #145)
• Allow string comparison for URL objects (Pull #139)
• Add HTTP status codes 418 and 451 (Pull #135)
• Add support for client certificate passwords (Pull #118)
• Enable post-handshake client cert authentication for TLSv1.3 (Pull #118)
• Disable using commonName for hostname checking for OpenSSL 1.1.0+ (Pull #118)
• Detect encoding for Response.json() (Pull #116)

• Check for connection aliveness on re-acquisition (Pull #111)