twisted.words.protocols.jabber.jid

module documentation

Jabber Identifier support.

This module provides an object to represent Jabber Identifiers (JIDs) and parse string representations into them with proper checking for illegal characters, case folding and canonicalisation through stringprep.

Class	`JID`	Represents a stringprep'd Jabber ID.
Exception	`InvalidFormat`	The given string could not be parsed into a valid Jabber Identifier (JID).
Function	`internJID`	Return interned JID.
Function	`parse`	Parse given JID string into its respective parts and apply stringprep.
Function	`prep`	Perform stringprep on all JID fragments.
Variable	`__internJIDs`	Undocumented

def internJID(jidstring): ¶

Return interned JID.

Returns
`JID`	Undocumented

def parse(jidstring: str) -> tuple[str | None, str, str | None]: ¶

Parse given JID string into its respective parts and apply stringprep.

Parameters
jidstring:`str`	string representation of a JID.
Returns
`tuple`	tuple of (user, host, resource), each of type `str` as the parsed and stringprep'd parts of the given JID. If the given string did not have a user or resource part, the respective field in the tuple will hold `None`.

def prep(user: str | None, host: str, resource: str | None) -> tuple[str | None, str, str | None]: ¶

Perform stringprep on all JID fragments.

Parameters
user:`str`	The user part of the JID.
host:`str`	The host part of the JID.
resource:`str`	The resource part of the JID.
Returns
`tuple`	The given parts with stringprep applied.

__internJIDs: dict[str, JID] = ¶

Undocumented