U  W[Q@shdZddlmZmZddlmZmZmZGdddeZ ddZ dd Z iZ d d Z Gd d d eZdS)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}. )_PY3unicode)nodeprep resourceprepnameprepc@seZdZdZdS) InvalidFormatzT The given string could not be parsed into a valid Jabber Identifier (JID). N)__name__ __module__ __qualname____doc__r r D/usr/lib/python3/dist-packages/twisted/words/protocols/jabber/jid.pyrsrcCsd}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{unicode} @return: tuple of (user, host, resource), each of type L{unicode} 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) jidstringuserhostresourceZuser_sepZres_sepr r r parses(     rcCs|r6ztt|}Wq:tk r2tdYq:Xnd}|sHtdn0ztt|}Wntk rvtdYnX|rztt|}Wqtk rtdYqXnd}|||fS)a\ Perform stringprep on all JID fragments. @param user: The user part of the JID. @type user: L{unicode} @param host: The host part of the JID. @type host: L{unicode} @param resource: The resource part of the JID. @type resource: L{unicode} @return: The given parts with stringprep applied. @rtype: L{tuple} zInvalid character in usernameNzServer address required.zInvalid character in hostnamezInvalid character in resource)rZpreparer UnicodeErrorrrr)rrrr r r rDs& rcCs(|tkrt|St|}|t|<|SdS)z2 Return interned JID. @rtype: L{JID} N) __internJIDsJID)rjr r r internJIDns rc@sbeZdZdZdddZddZddZd d Zd d Zd dZ ddZ ddZ e rVe Z ddZdS)rz Represents a stringprep'd Jabber ID. JID objects are hashable so they can be used in sets and as keys in dictionaries. NcCsH|s|std|r$t|\}}}nt|\}}}||_||_||_dS)Nz?You must provide a value for either 'str' or 'tuple' arguments.) RuntimeErrorrrrrr)selfstrtuplerrresr r r __init__sz JID.__init__cCs |jrd|j|jfS|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{unicode} %s@%sN)rrrr r r userhosts 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)rrr&r%r r r userhostJIDs  zJID.userhostJIDcCsR|jr2|jr d|j|j|jfSd|j|jfSn|jrHd|j|jfS|jSdS)z[ Return the string representation of this JID. @rtype: L{unicode} z%s@%s/%sr$z%s/%sN)rrrr%r r r fullszJID.fullcCs6t|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)rotherr r r __eq__s    z JID.__eq__cCs ||}|tkr|S| SdS)z Inequality comparison. This negates L{__eq__} for comparison with JIDs and uses the default comparison for other types. N)r,r*)rr+resultr r r __ne__s z JID.__ne__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__cCs 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)rr r r r#r&r'r(r,r.r0r2r__str__r3r r r r r|s    rN)r Ztwisted.python.compatrrZ.twisted.words.protocols.jabber.xmpp_stringpreprrr Exceptionrrrrrobjectrr r r r s.(