corehttp.transport package

class corehttp.transport.AsyncHttpTransport

An http sender ABC.

abstract async close() → None

Close the session if it is not externally owned.

abstract async open() → None

Assign new session if one does not already exist.

abstract async send(request: HTTPRequestType, **kwargs: Any) → AsyncHTTPResponseType

Send the request using this HTTP sender.

Parameters:

request (any) – The request object. Exact type can be inferred from the pipeline.

Returns:

The response object. Exact type can be inferred from the pipeline.

Return type:

any

async sleep(duration: float) → None

Sleep for the specified duration.

You should always ask the transport to sleep, and not call directly the stdlib. This is mostly important in async, as the transport may not use asyncio but other implementation like trio and they their own way to sleep, but to keep design consistent, it’s cleaner to always ask the transport to sleep and let the transport implementor decide how to do it. By default, this method will use “asyncio”, and don’t need to be overridden if your transport does too.

Parameters:

duration (float) – The number of seconds to sleep.

class corehttp.transport.HttpTransport

An http sender ABC.

abstract close() → None

Close the session if it is not externally owned.

abstract open() → None

Assign new session if one does not already exist.

abstract send(request: HTTPRequestType, **kwargs: Any) → HTTPResponseType

Send the request using this HTTP sender.

Parameters:

request (HTTPRequest) – The pipeline request object

Returns:

The pipeline response object.

Return type:

HttpResponse

sleep(duration: float) → None

Sleep for the specified duration.

You should always ask the transport to sleep, and not call directly the stdlib. This is mostly important in async, as the transport may not use asyncio but other implementations like trio and they have their own way to sleep, but to keep design consistent, it’s cleaner to always ask the transport to sleep and let the transport implementor decide how to do it.

Parameters:

duration (float) – The number of seconds to sleep.

Subpackages

• corehttp.transport.aiohttp package
  • AioHttpTransport
    • AioHttpTransport.close()
    • AioHttpTransport.open()
    • AioHttpTransport.send()
    • AioHttpTransport.sleep()
• corehttp.transport.httpx package
  • AsyncHttpXTransport
    • AsyncHttpXTransport.close()
    • AsyncHttpXTransport.open()
    • AsyncHttpXTransport.send()
    • AsyncHttpXTransport.sleep()
  • HttpXTransport
    • HttpXTransport.close()
    • HttpXTransport.open()
    • HttpXTransport.send()
    • HttpXTransport.sleep()
• corehttp.transport.requests package
  • RequestsTransport
    • RequestsTransport.close()
    • RequestsTransport.open()
    • RequestsTransport.send()
    • RequestsTransport.sleep()