U n5{i @sUdZddlmZmZmZddlmZmZmZGddde Z e eee dfe ee dffddd Z ee dfe ee dfeee dfe ee dffd d d Z iZee d fed<ddZGdd d ZdS)a$ 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 L{stringprep}. )DictTupleUnion)nameprepnodeprep resourceprepc@seZdZdZdS) InvalidFormatzT The given string could not be parsed into a valid Jabber Identifier (JID). N)__name__ __module__ __qualname____doc__r r F/tmp/pip-unpacked-wheel-mnhg7r0q/twisted/words/protocols/jabber/jid.pyrsrN) jidstringreturncCsd}d}d}|d}|d}|dkrX|dkr6|}q|d|}||ddpTd}n|dkr|d|pnd}||dd}nf||kr|d|pd}||d|||}||ddpd}n |d|}||ddpd}t|||S)a Parse given JID string into its respective parts and apply stringprep. @param jidstring: string representation of a JID. @type jidstring: L{str} @return: tuple of (user, host, resource), each of type L{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 L{None}. @rtype: L{tuple} N@/r)findprep)ruserhostresourceZuser_sepZres_sepr r rparses(     r)rrrrcCs|r6ztt|}Wq:tk r2tdYq:Xnd}|sHtdn0ztt|}Wntk rvtdYnX|rztt|}Wqtk rtdYqXnd}|||fS)aP Perform stringprep on all JID fragments. @param user: The user part of the JID. @type user: L{str} @param host: The host part of the JID. @type host: L{str} @param resource: The resource part of the JID. @type resource: L{str} @return: The given parts with stringprep applied. @rtype: L{tuple} zInvalid character in usernameNzServer address required.zInvalid character in hostnamezInvalid character in resource)rpreparestr UnicodeErrorrrr)rrrr r rrMs& rJID __internJIDscCs(|tkrt|St|}|t|<|SdS)z2 Return interned JID. @rtype: L{JID} N)rr)rjr r r internJID{s r!c @seZdZdZdeedfeeeedfeeedffdfdddZddZdd Z d d Z e e d d dZ ddZddZeZedddZdS)rz Represents a stringprep'd Jabber ID. JID objects are hashable so they can be used in sets and as keys in dictionaries. N)rtuplecCsF|rt|\}}}n|r(t|\}}}ntd||_||_||_dS)Nz?You must provide a value for either 'str' or 'tuple' arguments.)rr RuntimeErrorrrr)selfrr"rrresr r r__init__sz JID.__init__cCs"|jr|jd|jS|jSdS)z Extract the bare JID as a unicode string. A bare JID does not have a resource part, so this returns either C{user@host} or just C{host}. @rtype: L{str} rN)rrr$r r ruserhosts z JID.userhostcCs|jrt|S|SdS)a Extract the bare JID. A bare JID does not have a resource part, so this returns a L{JID} object representing either C{user@host} or just C{host}. If the object this method is called upon doesn't have a resource set, it will return itself. Otherwise, the bare JID object will be created, interned using L{internJID}. @rtype: L{JID} N)rr!r(r'r r r userhostJIDs  zJID.userhostJIDcCs\|jr:|jr&|jd|jd|jS|jd|jSn|jrR|jd|jS|jSdS)zW Return the string representation of this JID. @rtype: L{str} rrN)rrrr'r r rfullszJID.full)otherrcCs6t|tr.|j|jko,|j|jko,|j|jkStSdS)z Equality comparison. L{JID}s compare equal if their user, host and resource parts all compare equal. When comparing against instances of other types, it uses the default comparison. N) isinstancerrrrNotImplemented)r$r+r r r__eq__s    z JID.__eq__cCst|j|j|jfS)a Calculate hash. L{JID}s with identical constituent user, host and resource parts have equal hash values. In combination with the comparison defined on JIDs, this allows for using L{JID}s in sets and as dictionary keys. )hashrrrr'r r r__hash__sz JID.__hash__cCs|S)z Get unicode representation. Return the string representation of this JID as a unicode string. @see: L{full} r*r'r r r __unicode__szJID.__unicode__)rcCs d|S)z Get object representation. Returns a string that would create a new JID object that compares equal to this one. zJID(%r)r1r'r r r__repr__sz JID.__repr__)NN)r r r r rrrr&r(r)r*objectboolr.r0r2__str__r3r r r rrs  $   )r typingrrrZ.twisted.words.protocols.jabber.xmpp_stringpreprrr Exceptionrrrrr__annotations__r!rr r r rs *0   +