Skip to content

xtr_http_client.exception

Everything calling out through this package can raise.

The hierarchy is the contract's, re-exported here so one import answers "what can this client raise" without reaching into two packages: :class:HttpClientError at the root, :class:TransportError for "there is no answer" (with :class:TransportTimeoutError for running out of time), :class:HttpError for "there is one and it is not a success" (:class:RedirectionError, :class:ClientError, :class:ServerError), :class:DecodingError for an answer that is not what it was read as (with :class:JsonError for a body that is not the JSON it was read as), and :class:InvalidArgumentError for a request this client refuses to make. :class:LogicError is this package's own: a client built in a way that cannot work.

LogicError

Bases: HttpClientError, RuntimeError

A client was built in a way that cannot work, whatever it is asked to send.

Building the private-network guard without xtr-http-foundation installed, which holds the networks it refuses, is a mistake in the application's setup rather than in a request, so retrying it changes nothing.