proxyprotocol.noop

class proxyprotocol.noop.ProxyProtocolNoop

Implements ProxyProtocol but does not read anything from the stream. A ProxyResultLocal result is always returned.

is_valid(signature)

Returns True if the signature is valid for this implementation of the PROXY protocol header.

Parameters:

signature (bytes) – The signature bytestring to check.

Return type:

NoReturn

unpack(data)

Parse a PROXY protocol header from the given bytestring and return information about the original connection.

Parameters:

data (bytes) – The bytestring read for the header thus far.

Raises:

• ProxyProtocolIncompleteError – The header was incomplete and must be extended with additional bytes or lines to finish parsing.

• ProxyProtocolSyntaxError – The header failed to parse due to a syntax error or unsupported format.

• ValueError – Malformed or out-of-range data was encountered in the header.

Return type:

ProxyResultLocal

pack(result)

Builds a PROXY protocol header that may be sent at the beginning of an outbound, client-side connection to indicate the original information about the connection.

Parameters:

result (ProxyResult) – The PROXY protocol result to build into a header.

Raises:

• KeyError – This PROXY protocol header format does not support the socket information.

• ValueError – The address data could not be written to the PROXY protocol header format.

Return type:

bytes