| Server IP : 209.38.156.173 / Your IP : 216.73.216.122 [ Web Server : Apache/2.4.52 (Ubuntu) System : Linux lakekumayuhotel 5.15.0-136-generic #147-Ubuntu SMP Sat Mar 15 15:53:30 UTC 2025 x86_64 User : root ( 0) PHP Version : 8.1.2-1ubuntu2.22 Disable Function : NONE Domains : 2 Domains MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /usr/lib/python3/dist-packages/twisted/words/protocols/jabber/__pycache__/ |
Upload File : |
o
�b� � @ st U d Z ddlmZ ddlmZmZmZ G dd� de�Zdd� Z dd � Z
i Z ee d
f e
d < d d
� ZG dd
� 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<twisted.words.protocols.jabber.xmpp_stringprep>}.
� )�Dict)�nameprep�nodeprep� resourceprepc @ s e Zd ZdZdS )�
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.pyr s r c C s� d}d}d}| � d�}| � d�}|dkr,|dkr| }nY| d|� }| |d d� p*d}nH|dkrA| d|� p7d}| |d d� }n3||k rd| d|� pLd}| |d ||| � }| |d d� pbd}n| d|� }| |d d� psd}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 � )�find�prep)� jidstring�user�host�resource�user_sep�res_sepr r r �parse s(
r c C s� | rz t �t| ��} W n
ty td��w d} |s td��z t�t|��}W n ty3 td��w |rKz t�t|��}W n
tyJ td��w d}| ||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}
z Invalid character in usernameNzServer address required.z Invalid character in hostnamez Invalid character in resource)r �prepare�str� UnicodeErrorr r r )r r r r r r r M s, � � �
r �JID� __internJIDsc C s$ | t v rt | S t| �}|t | < |S )z2
Return interned JID.
@rtype: L{JID}
)r r )r �jr r r � internJIDy s
r c @ sf e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd ed e fd
d�Z
dd� Z dd� Z e Z
d efdd�ZdS )r z�
Represents a stringprep'd Jabber ID.
JID objects are hashable so they can be used in sets and as keys in
dictionaries.
Nc C sH |s|st d��|rt|�\}}}nt|� \}}}|| _|| _|| _d S )Nz?You must provide a value for either 'str' or 'tuple' arguments.)� RuntimeErrorr r r r r )�selfr �tupler r �resr r r �__init__� s �
z JID.__init__c C s | j r | j � d| j� �S | jS )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}
r
)r r �r" r r r �userhost� s z JID.userhostc C s | j r t| �� �S | S )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}
)r r r' r& r r r � userhostJID� s
zJID.userhostJIDc C sV | j r | jr| j � d| j� d| j� �S | j � d| j� �S | jr(| j� d| j� �S | jS )zW
Return the string representation of this JID.
@rtype: L{str}
r
r )r r r r& r r r �full� s zJID.full�other�returnc C s2 t |t�r| j|jko| j|jko| j|jkS tS )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.
)�
isinstancer r r r �NotImplemented)r" r* r r r �__eq__� s
�
�z
JID.__eq__c C s t | j| j| jf�S )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.
)�hashr r r r& r r r �__hash__� s z JID.__hash__c C s | � � 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__� s zJID.__unicode__c C s d| � � S )z�
Get object representation.
Returns a string that would create a new JID object that compares equal
to this one.
zJID(%r)r1 r& r r r �__repr__� s z JID.__repr__)NN)r r r r
r% r' r( r) �object�boolr. r0 r2 �__str__r r3 r r r r r � s
N)r
�typingr �.twisted.words.protocols.jabber.xmpp_stringprepr r r � Exceptionr r r r r �__annotations__r r r r r r �<module> s /)