twisted.words.protocols.jabber.xmlstream : API documentation

XMPP XML Streams

Building blocks for setting up XML Streams, including helping classes for doing authentication on either client or server side, and working with XML Stanzas.

Variable	STREAM_AUTHD_EVENT	Token dispatched by `Authenticator` when the stream has been completely initialized (type: `str`.)
Variable	INIT_FAILED_EVENT	Token dispatched by `Authenticator` when the stream has failed to be initialized (type: `str`.)
Variable	Reset	Token to signal that the XML stream has been reset. (type: Basic object.)
Variable	STREAM_CONNECTED_EVENT	This event signals that the connection has been established. (type: `str`.)
Variable	STREAM_START_EVENT	This event signals that the root element of the XML Stream has been received. For XMPP, this would be the `<stream:stream ...>` opening tag. (type: `str`.)
Variable	STREAM_END_EVENT	This event signals that the connection has been closed. (type: `str`.)
Variable	STREAM_ERROR_EVENT	This event signals that a parse error occurred. (type: `str`.)
Function	hashPassword	Create a SHA1-digest string of a session identifier and password.
Class	Authenticator	Base class for business logic of initializing an XmlStream
Class	ConnectAuthenticator	Authenticator for initiating entities.
Class	ListenAuthenticator	Authenticator for receiving entities.
Class	FeatureNotAdvertized	Exception indicating a stream feature was not advertized, while required by the initiating entity.
Class	BaseFeatureInitiatingInitializer	Base class for initializers with a stream feature.
Class	TLSError	TLS base exception.
Class	TLSFailed	Exception indicating failed TLS negotiation
Class	TLSRequired	Exception indicating required TLS negotiation.
Class	TLSNotSupported	Exception indicating missing TLS support.
Class	TLSInitiatingInitializer	TLS stream initializer for the initiating entity.
Class	XmlStream	XMPP XML Stream protocol handler.
Class	XmlStreamFactory	Factory for Jabber XmlStream objects as a reconnecting client.
Class	XmlStreamServerFactory	Factory for Jabber XmlStream objects as a server.
Class	TimeoutError	Exception raised when no IQ response has been received before the configured timeout.
Function	upgradeWithIQResponseTracker	Enhances an XmlStream for iq response tracking.
Class	IQ	Wrapper for an iq stanza.
Function	toResponse	Create a response stanza from another stanza.
Class	XMPPHandler	XMPP protocol handler.
Class	XMPPHandlerCollection	Collection of XMPP subprotocol handlers.
Class	StreamManager	Business logic representing a managed XMPP connection.

STREAM_AUTHD_EVENT =

Token dispatched by Authenticator when the stream has been completely initialized (type: str.)

INIT_FAILED_EVENT =

Token dispatched by Authenticator when the stream has failed to be initialized (type: str.)

Reset =

Token to signal that the XML stream has been reset. (type: Basic object.)

STREAM_CONNECTED_EVENT =

This event signals that the connection has been established. (type: str.)

STREAM_START_EVENT =

This event signals that the root element of the XML Stream has been received. For XMPP, this would be the

<stream:stream 
...>

opening tag. (type: str.)

STREAM_END_EVENT =

This event signals that the connection has been closed. (type: str.)

STREAM_ERROR_EVENT =

This event signals that a parse error occurred. (type: str.)

def hashPassword(sid, password): (source)

Create a SHA1-digest string of a session identifier and password.

Parameters	sid	The stream session identifier. (type: `unicode`.)
	password	The password to be hashed. (type: `unicode`.)

def upgradeWithIQResponseTracker(xs): (source)

Enhances an XmlStream for iq response tracking.

This makes an XmlStream object provide IIQResponseTracker. When a response is an error iq stanza, the deferred has its errback invoked with a failure that holds a StanzaError that is easier to examine.

def toResponse(stanza, stanzaType=None): (source)

Create a response stanza from another stanza.

This takes the addressing and id attributes from a stanza to create a (new, empty) response stanza. The addressing attributes are swapped and the id copied. Optionally, the stanza type of the response can be specified.

Parameters	stanza	the original stanza (type: `domish.Element`)
	stanzaType	optional response stanza type (type: `str`)
Returns	the response stanza. (type: `domish.Element`)

API Documentation for Twisted, generated by pydoctor at 2017-09-23 19:45:03.

twisted.words.protocols.jabber.xmlstream module documentation

`twisted.words.protocols.jabber.xmlstream` module documentation