a î½jËã@sîdZddlmZmZddlZdZdZdZedZed Z ed Z ed Z ed Z ed Z edZedZedZedZedZedZedZedZedZedZedZedZedZedZedZedZedZedZed Z ed!Z!ed"Z"ed#Z#ed$Z$ed%Z%ed&Z&d'Z'd(Z(e(d)Z)d*Z*d+Z+d,Z,d-Z-d.Z.d/Z/d0Z0d1Z1d2Z2d3Z3d4Z4d5Z5d6Z6d7Z7d8Z8d9Z9d:Z:d;Z;e;d<ZZ>d?Z?d@Z@dAZAdBZBdCZCdDZDdEZEdFZFdGZGdHZHdIZIdJZJdKZKdLZLeLdMZMeLdNZNeLdOZOeLdPZPeLdQZQeLdRZReLdSZSeLdTZTeLdUZUeLdVZVdWZWdXZXdYZYdZZZd[Z[d\Z\d]Z]d^Z^d_Z_d`Z`daZadbZbdcZcddZddeZedfZfdgZgdhZhdiZidjZjdkZkdlZldmZmdnZndoZodpZpdqZqdrZrdsZsdtZtduZudvZvdwZwiiZxZyetdxeufejdyevfecdzewffD]†\ZzZ{Z|e| }d{¡dd…D]fZ~e~ }d|¡\ZZ€ZZ‚e{d}e ƒ¡ „d~d}¡Z…ezdee†ƒe…<e€ee‚gexezde<e€rÚeeye€<qÚq¾[z[{[|[~[[€[[‚d€d„Z‡d‚dƒ„ZˆGd„d…„d…e‰ƒZŠGd†d‡„d‡e‰ƒZ‹Gdˆd‰„d‰e‹ƒZŒGdŠd‹„d‹e‹ƒZGdŒd„de‹ƒZŽGdŽd„de‹ƒZGdd‘„d‘e‹ƒZGd’d“„d“e‹ƒZ‘Gd”d•„d•e‹ƒZ’Gd–d—„d—e‹ƒZ“Gd˜d™„d™e‹ƒZ”Gdšd›„d›e‹ƒZ•Gdœd„de‹ƒZ–GdždŸ„dŸe‹ƒZ—Gd d¡„d¡e‹ƒZ˜Gd¢d£„d£e‹ƒZ™Gd¤d¥„d¥e‹ƒZšGd¦d§„d§e‹ƒZ›Gd¨d©„d©e‹ƒZœGdªd«„d«e‹ƒZGd¬d­„d­e‹ƒZžGd®d¯„d¯e‹ƒZŸGd°d±„d±e‹ƒZ Gd²d³„d³e‹ƒZ¡Gd´dµ„dµe‹ƒZ¢Gd¶d·„d·e‹ƒZ£eŒeeŽeee‘e’e“e”e•e–e—e˜e™eše›eœeežeŸe e¡e¢e£d¸œZ¤Gd¹dº„dºƒZ¥Gd»d¼„d¼eƒZ¦Gd½d¾„d¾e¦ƒZ§Gd¿dÀ„dÀe¦ƒZ¨GdÁd„dÂe¦ƒZ©GdÃdÄ„dÄeƒZªGdÅdÆ„dÆe¦ƒZ«GdÇdÈ„dÈeƒZ¬GdÉdÊ„dÊeƒZ­GdËdÌ„dÌeƒZ®GdÍd΄dÎeƒZ¯dS)Ïz_ Protocol module contains tools that is needed for processing of xmpp-related data structures. é)ÚNodeÚustréNz#http://jabber.org/protocol/activityz"http://jabber.org/protocol/addressz http://jabber.org/protocol/adminz #add-userz #delete-userz #disable-userz#reenable-userz#end-user-sessionz#get-user-passwordz#change-user-passwordz#get-user-rosterz#get-user-lastloginz #user-statsz#edit-blacklistz#edit-whitelistz#get-registered-users-numz#get-disabled-users-numz#get-online-users-numz#get-active-users-numz#get-idle-users-numz#get-registered-users-listz#get-disabled-users-listz#get-online-users-listz#get-active-users-listz#get-idle-users-listz #announcez #set-motdz #edit-motdz #delete-motdz #set-welcomez#delete-welcomez #edit-adminz#restartz #shutdownzjabber:iq:agentszhttp://jabber.org/protocol/ampz#errorszjabber:iq:authzjabber:iq:avatarz urn:ietf:params:xml:ns:xmpp-bindzjabber:iq:browsez&http://jabber.org/protocol/bytestreamszhttp://jabber.org/protocol/capsz%http://jabber.org/protocol/chatstatesz jabber:clientz#http://jabber.org/protocol/commandszjabber:component:acceptz0http://jabberd.jabberstudio.org/ns/component/1.0z#http://jabber.org/protocol/compressz jabber:x:dataz'http://jabber.org/protocol/xdata-layoutz)http://jabber.org/protocol/xdata-validatezjabber:x:delayzjabber:server:dialbackz http://jabber.org/protocol/discoz#infoz#itemszjabber:x:encryptedzjabber:x:eventz&http://jabber.org/protocol/feature-negz3http://jabber.org/protocol/si/profile/file-transferzjabber:iq:gatewayz!http://jabber.org/protocol/geoloczgc-1.0z#http://jabber.org/protocol/httpbindzhttp://jabber.org/protocol/ibbzpresence-invisibleÚiqzjabber:iq:lastÚmessagezhttp://jabber.org/protocol/moodzhttp://jabber.org/protocol/mucz#adminz#ownerz#uniquez#userz #registerz#requestz #roomconfigz #roominfoz#roomsz#trafficzhttp://jabber.org/protocol/nickz"http://jabber.org/protocol/offlinez"http://jabber.org/protocol/physlocÚpresencezjabber:iq:privacyzjabber:iq:privatez!http://jabber.org/protocol/pubsubzjabber:iq:registerzhttp://jabber.org/protocol/rczjabber:iq:rosterz"http://jabber.org/protocol/rosterxz jabber:iq:rpcz urn:ietf:params:xml:ns:xmpp-saslzjabber:iq:searchz jabber:serverz#urn:ietf:params:xml:ns:xmpp-sessionzhttp://jabber.org/protocol/siz http://jabber.org/protocol/sipubzjabber:x:signedz#urn:ietf:params:xml:ns:xmpp-stanzasz http://etherx.jabber.org/streamszjabber:iq:timezurn:ietf:params:xml:ns:xmpp-tlsz#http://jabber.org/protocol/vacationz vcard-tempzvcard-temp:x:updatezjabber:iq:versionz&http://jabber.org/protocol/waitinglistz#http://jabber.org/protocol/xhtml-imz#urn:ietf:params:xml:ns:xmpp-streamsaS bad-format -- -- -- The entity has sent XML that cannot be processed. bad-namespace-prefix -- -- -- The entity has sent a namespace prefix that is unsupported, or has sent no namespace prefix on an element that requires such a prefix. conflict -- -- -- The server is closing the active stream for this entity because a new stream has been initiated that conflicts with the existing stream. connection-timeout -- -- -- The entity has not generated any traffic over the stream for some period of time. host-gone -- -- -- The value of the 'to' attribute provided by the initiating entity in the stream header corresponds to a hostname that is no longer hosted by the server. host-unknown -- -- -- The value of the 'to' attribute provided by the initiating entity in the stream header does not correspond to a hostname that is hosted by the server. improper-addressing -- -- -- A stanza sent between two servers lacks a 'to' or 'from' attribute (or the attribute has no value). internal-server-error -- -- -- The server has experienced a misconfiguration or an otherwise-undefined internal error that prevents it from servicing the stream. invalid-from -- cancel -- -- The JID or hostname provided in a 'from' address does not match an authorized JID or validated domain negotiated between servers via SASL or dialback, or between a client and a server via authentication and resource authorization. invalid-id -- -- -- The stream ID or dialback ID is invalid or does not match an ID previously provided. invalid-namespace -- -- -- The streams namespace name is something other than "http://etherx.jabber.org/streams" or the dialback namespace name is something other than "jabber:server:dialback". invalid-xml -- -- -- The entity has sent invalid XML over the stream to a server that performs validation. not-authorized -- -- -- The entity has attempted to send data before the stream has been authenticated, or otherwise is not authorized to perform an action related to stream negotiation. policy-violation -- -- -- The entity has violated some local service policy. remote-connection-failed -- -- -- The server is unable to properly connect to a remote resource that is required for authentication or authorization. resource-constraint -- -- -- The server lacks the system resources necessary to service the stream. restricted-xml -- -- -- The entity has attempted to send restricted XML features such as a comment, processing instruction, DTD, entity reference, or unescaped character. see-other-host -- -- -- The server will not provide service to the initiating entity but is redirecting traffic to another host. system-shutdown -- -- -- The server is being shut down and all active streams are being closed. undefined-condition -- -- -- The error condition is not one of those defined by the other conditions in this list. unsupported-encoding -- -- -- The initiating entity has encoded the stream in an encoding that is not supported by the server. unsupported-stanza-type -- -- -- The initiating entity has sent a first-level child of the stream that is not supported by the server. unsupported-version -- -- -- The value of the 'version' attribute provided by the initiating entity in the stream header specifies a version of XMPP that is not supported by the server. xml-not-well-formed -- -- -- The initiating entity has sent XML that is not well-formed.a bad-request -- 400 -- modify -- The sender has sent XML that is malformed or that cannot be processed. conflict -- 409 -- cancel -- Access cannot be granted because an existing resource or session exists with the same name or address. feature-not-implemented -- 501 -- cancel -- The feature requested is not implemented by the recipient or server and therefore cannot be processed. forbidden -- 403 -- auth -- The requesting entity does not possess the required permissions to perform the action. gone -- 302 -- modify -- The recipient or server can no longer be contacted at this address. internal-server-error -- 500 -- wait -- The server could not process the stanza because of a misconfiguration or an otherwise-undefined internal server error. item-not-found -- 404 -- cancel -- The addressed JID or item requested cannot be found. jid-malformed -- 400 -- modify -- The value of the 'to' attribute in the sender's stanza does not adhere to the syntax defined in Addressing Scheme. not-acceptable -- 406 -- cancel -- The recipient or server understands the request but is refusing to process it because it does not meet criteria defined by the recipient or server. not-allowed -- 405 -- cancel -- The recipient or server does not allow any entity to perform the action. not-authorized -- 401 -- auth -- The sender must provide proper credentials before being allowed to perform the action, or has provided improper credentials. payment-required -- 402 -- auth -- The requesting entity is not authorized to access the requested service because payment is required. recipient-unavailable -- 404 -- wait -- The intended recipient is temporarily unavailable. redirect -- 302 -- modify -- The recipient or server is redirecting requests for this information to another entity. registration-required -- 407 -- auth -- The requesting entity is not authorized to access the requested service because registration is required. remote-server-not-found -- 404 -- cancel -- A remote server or service specified as part or all of the JID of the intended recipient does not exist. remote-server-timeout -- 504 -- wait -- A remote server or service specified as part or all of the JID of the intended recipient could not be contacted within a reasonable amount of time. resource-constraint -- 500 -- wait -- The server or recipient lacks the system resources necessary to service the request. service-unavailable -- 503 -- cancel -- The server or recipient does not currently provide the requested service. subscription-required -- 407 -- auth -- The requesting entity is not authorized to access the requested service because a subscription is required. undefined-condition -- 500 -- -- unexpected-request -- 400 -- wait -- The recipient or server understood the request but was not expecting it at this time (e.g., the request was out of order).aû aborted -- -- -- The receiving entity acknowledges an element sent by the initiating entity; sent in reply to the element. incorrect-encoding -- -- -- The data provided by the initiating entity could not be processed because the [BASE64]Josefsson, S., The Base16, Base32, and Base64 Data Encodings, July 2003. encoding is incorrect (e.g., because the encoding does not adhere to the definition in Section 3 of [BASE64]Josefsson, S., The Base16, Base32, and Base64 Data Encodings, July 2003.); sent in reply to a element or an element with initial response data. invalid-authzid -- -- -- The authzid provided by the initiating entity is invalid, either because it is incorrectly formatted or because the initiating entity does not have permissions to authorize that ID; sent in reply to a element or an element with initial response data. invalid-mechanism -- -- -- The initiating entity did not provide a mechanism or requested a mechanism that is not supported by the receiving entity; sent in reply to an element. mechanism-too-weak -- -- -- The mechanism requested by the initiating entity is weaker than server policy permits for that initiating entity; sent in reply to a element or an element with initial response data. not-authorized -- -- -- The authentication failed because the initiating entity did not provide valid credentials (this includes but is not limited to the case of an unknown username); sent in reply to a element or an element with initial response data. temporary-auth-failure -- -- -- The authentication failed because of a temporary error condition within the receiving entity; sent in reply to an element or element.ZSTREAMZERRZSASLÚ z -- Ú_ú-ú cCs|o| ¡dkS)z/ Returns true if the node is a positive reply. Úresult©ÚgetType©Únode©rúS/Users/admin/.hermes/hermes-agent/venv/lib/python3.9/site-packages/xmpp/protocol.pyÚ isResultNodeÎsrcCs|o| ¡dkS)z/ Returns true if the node is a negative reply. Úerrorr rrrrÚ isErrorNodeÑsrc@seZdZdZdS)Ú NodeProcessedzQ Exception that should be raised by handler when the handling should be stopped. N©Ú__name__Ú __module__Ú __qualname__Ú__doc__rrrrrÕsrc@seZdZdZdS)Ú StreamErrorz( Base exception class for stream errors.Nrrrrrr×src@s eZdZdS)Ú BadFormatN©rrrrrrrrÙórc@s eZdZdS)ÚBadNamespacePrefixNrrrrrr Úrr c@s eZdZdS)ÚConflictNrrrrrr!Ûrr!c@s eZdZdS)ÚConnectionTimeoutNrrrrrr"Ürr"c@s eZdZdS)ÚHostGoneNrrrrrr#Ýrr#c@s eZdZdS)Ú HostUnknownNrrrrrr$Þrr$c@s eZdZdS)ÚImproperAddressingNrrrrrr%ßrr%c@s eZdZdS)ÚInternalServerErrorNrrrrrr&àrr&c@s eZdZdS)Ú InvalidFromNrrrrrr'árr'c@s eZdZdS)Ú InvalidIDNrrrrrr(ârr(c@s eZdZdS)ÚInvalidNamespaceNrrrrrr)ãrr)c@s eZdZdS)Ú InvalidXMLNrrrrrr*ärr*c@s eZdZdS)Ú NotAuthorizedNrrrrrr+årr+c@s eZdZdS)ÚPolicyViolationNrrrrrr,ærr,c@s eZdZdS)ÚRemoteConnectionFailedNrrrrrr-çrr-c@s eZdZdS)ÚResourceConstraintNrrrrrr.èrr.c@s eZdZdS)Ú RestrictedXMLNrrrrrr/érr/c@s eZdZdS)Ú SeeOtherHostNrrrrrr0êrr0c@s eZdZdS)ÚSystemShutdownNrrrrrr1ërr1c@s eZdZdS)ÚUndefinedConditionNrrrrrr2ìrr2c@s eZdZdS)ÚUnsupportedEncodingNrrrrrr3írr3c@s eZdZdS)ÚUnsupportedStanzaTypeNrrrrrr4îrr4c@s eZdZdS)ÚUnsupportedVersionNrrrrrr5ïrr5c@s eZdZdS)ÚXMLNotWellFormedNrrrrrr6ðrr6)z bad-formatzbad-namespace-prefixÚconflictzconnection-timeoutz host-gonez host-unknownzimproper-addressingzinternal-server-errorz invalid-fromz invalid-idzinvalid-namespacez invalid-xmlznot-authorizedzpolicy-violationzremote-connection-failedzresource-constraintzrestricted-xmlzsee-other-hostzsystem-shutdownzundefined-conditionzunsupported-encodingzunsupported-stanza-typezunsupported-versionzxml-not-well-formedc@s|eZdZdZddd„Zdd„Zdd „Zd d „Zd d „Zdd„Z dd„Z dd„Z dd„Z dd„Z dd„Zd dd„Zdd„ZdS)!ÚJIDzW JID object. JID can be built from string, modified, compared, serialised into string. NÚcCsº|s|stdƒ‚n¤t|ƒt|ƒkr@|j|j|j|_|_|_nv|r\||||_|_|_nZ| d¡dr~| dd¡\|_}nd|_| d¡dr¨| dd¡\|_|_n|d|_|_dS)zÉ Constructor. JID can be specified as string (jid argument) or as separate parts. Examples: JID('node@domain/resource') JID(node='node',domain='domain.org') z%JID must contain at least domain nameú@rr9ú/N)Ú ValueErrorÚtyperÚdomainÚresourceÚfindÚsplit)ÚselfÚjidrr>r?rrrÚ__init__ s."$z JID.__init__cCs|jS)z! Return the node part of the JID r©rBrrrÚgetNodesz JID.getNodecCs| ¡|_dS)zQ Set the node part of the JID to new value. Specify None to remove the node part.N)Úlowerr©rBrrrrÚsetNodesz JID.setNodecCs|jS)z# Return the domain part of the JID )r>rErrrÚ getDomain!sz JID.getDomaincCs| ¡|_dS)z- Set the domain part of the JID to new value.N)rGr>)rBr>rrrÚ setDomain$sz JID.setDomaincCs|jS)z% Return the resource part of the JID ©r?rErrrÚ getResource'szJID.getResourcecCs ||_dS)zY Set the resource part of the JID to new value. Specify None to remove the resource part.NrL)rBr?rrrÚ setResource*szJID.setResourcecCs | d¡S)zH Return the bare representation of JID. I.e. string value w/o resource. r)Ú__str__rErrrÚ getStripped-szJID.getStrippedcCsBz t|ƒ}Wnty YdS0|j|jko@| d¡| d¡kS)z@ Compare the JID to another instance or to string for equality. r)r8r<r?rO©rBÚotherrrrÚ__eq__0sz JID.__eq__cCs | |¡ S)zD Compare the JID to another instance or to string for non-equality. )rSrQrrrÚ__ne__5sz JID.__ne__cCs| d¡t|ƒ d¡kS)z> Compare the node and domain parts of the JID's for equality. r)rOr8rQrrrÚ bareMatch8sz JID.bareMatchrcCs:|jr|jd|j}n|j}|r6|jr6|d|jS|S)z Serialise JID into string. r:r;)rr>r?)rBZ wresourcerCrrrrO;sz JID.__str__cCs t| ¡ƒS)zO Produce hash of the JID, Allows to use JID objects as keys of the dictionary. )ÚhashrOrErrrÚ__hash__Asz JID.__hash__)Nr9r9r9)r)rrrrrDrFrIrJrKrMrNrPrSrTrUrOrWrrrrr8 s  r8c @s¨eZdZdZddddigdddf dd„Zdd„Zdd„Zd d „Zd d „Zd d„Z dd„Z dd„Z dd„Z dd„Z dd„Zdd„Zd#dd„Zd$dd„Zdd „Zd!d"„ZdS)%ÚProtocolz\ A "stanza" object class. Contains methods that are common for presences, iqs and messages. Nc Cs|si}|r||d<|r ||d<|r,||d<tj||||| d| sR|rR| |¡|drh| |d¡|dr~| |d¡| r°t|ƒt| ƒkr°|j| jkr°d|jvr°|jd=d|_|j dt dD]@} z.|  ¡rä|   d ¡|  ¡krô|  |   d ¡¡WqÄYqÄ0qÄ|dur|  |¡dS) aå Constructor, name is the name of the stanza i.e. 'message' or 'presence' or 'iq'. to is the value of 'to' attribure, 'typ' - 'type' attribute frn - from attribure, attrs - other attributes mapping, payload - same meaning as for simplexml payload definition timestamp - the time value that needs to be stamped over stanza xmlns - namespace of top stanza node node - parsed or unparsed stana to be taken as prototype. ÚtoÚfromr=)ÚtagÚattrsÚpayloadrÚidNÚx©Ú namespaceÚstamp)rrDÚ setNamespaceÚsetToÚsetFromr=Ú __class__r\Ú timestampÚgetTagsÚNS_DELAYÚ getTimestampÚgetAttrÚ setTimestamp) rBÚnamerYÚtypÚfrmr\r]rgÚxmlnsrr_rrrrDGs   2.zProtocol.__init__cCsz |dWSYdS0dS)z% Return value of the 'to' attribute. rYNrrErrrÚgetTo^s zProtocol.getTocCsz |dWSYdS0dS)z' Return value of the 'from' attribute. rZNrrErrrÚgetFrombs zProtocol.getFromcCs|jS)z7 Return the timestamp in the 'yyyymmddThhmmss' format. )rgrErrrrjfszProtocol.getTimestampcCs | d¡S)z) Return the value of the 'id' attribute. r^©rkrErrrÚgetIDiszProtocol.getIDcCs| dt|ƒ¡dS)z& Set the value of the 'to' attribute. rYN©ÚsetAttrr8©rBÚvalrrrrdlszProtocol.setTocCs | d¡S)z+ Return the value of the 'type' attribute. r=rsrErrrroszProtocol.getTypecCs| dt|ƒ¡dS)z( Set the value of the 'from' attribute. rZNrurwrrrrerszProtocol.setFromcCs| d|¡dS)z( Set the value of the 'type' attribute. r=N©rvrwrrrÚsetTypeuszProtocol.setTypecCs| d|¡dS)z& Set the value of the 'id' attribute. r^NryrwrrrÚsetIDxszProtocol.setIDcCs@| d¡}|r<| ¡D]}| ¡dkr| ¡Sq| ¡SdS)z^ Return the error-condition (if present) or the textual description of the error (otherwise). rÚtextN)ÚgetTagÚ getChildrenÚgetNameÚgetData)rBZerrtagr[rrrÚgetError{s   zProtocol.getErrorcCs | dd¡S)z# Return the error code. Obsolette. rÚcode)Z getTagAttrrErrrÚ getErrorCode‚szProtocol.getErrorCodecCsz|r@t|ƒtt ¡ƒvr.ttt|ƒ|d}q`tt|d|d}n t|ƒtdƒtdƒfvr`t|ƒ}| d¡|j|ddS)z> Set the error code. Obsolette. Use error-conditions instead. )r|Úcancel)r‚rnr|r9rrN) ÚstrÚlistÚ _errorcodesÚkeysÚ ErrorNodeZERR_UNDEFINED_CONDITIONr=rzÚaddChild)rBrr‚rrrÚsetError…s *  zProtocol.setErrorcCs4|st dt ¡¡}||_|jdd|jitddS)zBSet the timestamp. timestamp should be the yyyymmddThhmmss string.z%Y%m%dT%H:%M:%Sr_rbr`N)ÚtimeÚstrftimeÚgmtimergÚsetTagrirwrrrrlszProtocol.setTimestampcCs0g}| ¡D]}| ¡}||vr | |¡q |S)zL Return the list of namespaces to which belongs the direct childs of element)r~Ú getNamespaceÚappend)rBÚpropsÚchildÚproprrrÚ getProperties’s  zProtocol.getPropertiescCs|dvrt|ƒ}| ||¡S)z( Set the item 'item' to the value 'val'.)rYrZ)r8rv)rBÚitemrxrrrÚ __setitem__™szProtocol.__setitem__)N)N)rrrrrDrqrrrjrtrdrrerzr{rrƒr‹rlr•r—rrrrrXEs"  rXc @sheZdZdZddddidgdedf dd„Zdd„Zdd„Zd d „Zd d „Z d d„Z dd„Z ddd„Z dS)ÚMessagez( XMPP Message stanza - "push" mechanism.Nc Cs>tj|d||||||| | d |r,| |¡|r:| |¡dS)aS Create message object. You can specify recipient, text of message, type of message any additional attributes, sender of the message, any additional payload (f.e. jabber:x:delay element) and namespace in one go. Alternatively you can pass in the other XML object as the 'node' parameted to replicate it as message. r©rYrnr\ror]rgrprN)rXrDÚsetBodyÚ setSubject) rBrYÚbodyrnÚsubjectr\ror]rgrprrrrrD szMessage.__init__cCs | d¡S)z Returns text of the message. rœ©Ú getTagDatarErrrÚgetBody§szMessage.getBodycCs | d¡S)z! Returns subject of the message. rržrErrrÚ getSubjectªszMessage.getSubjectcCs | d¡S)z Returns thread of the message. ÚthreadržrErrrÚ getThread­szMessage.getThreadcCs| d|¡dS)z Sets the text of the message. rœN©Ú setTagDatarwrrrrš°szMessage.setBodycCs| d|¡dS)z" Sets the subject of the message. rNr¤rwrrrr›³szMessage.setSubjectcCs| d|¡dS)z! Sets the thread of the message. r¢Nr¤rwrrrÚ setThread¶szMessage.setThreadcCs6t| ¡| ¡|| ¡d}| ¡}|r2| |¡|S)zª Builds and returns another message object with specified text. The to, from, thread and type properties of new message are pre-set as reply to this message. )rYrorœrn)r˜rrrqrr£r¦)rBr|ÚmÚthrrrÚ buildReply¹szMessage.buildReply)N) rrrrÚ NS_CLIENTrDr r¡r£ršr›r¦r©rrrrr˜žsr˜c @s¨eZdZdZdddddiddgedf dd„Zdd„Zdd„Zd d „Zd d „Z d d„Z dd„Z dd„Z dd„Z dd„Zdd„Zdd„Zdd„Zdd„Zdd „Zd!d"„ZdS)#ÚPresencez XMPP Presence object.Nc CsLtj|d||||| || | d |r,| |¡|r:| |¡|rH| |¡dS)ar Create presence object. You can specify recipient, type of message, priority, show and status values any additional attributes, sender of the presence, timestamp, any additional payload (f.e. jabber:x:delay element) and namespace in one go. Alternatively you can pass in the other XML object as the 'node' parameted to replicate it as presence. rr™N)rXrDÚ setPriorityÚsetShowÚ setStatus) rBrYrnÚpriorityÚshowÚstatusr\rorgr]rprrrrrDÃszPresence.__init__cCs | d¡S)z& Returns the priority of the message. r¯ržrErrrÚ getPriorityËszPresence.getPrioritycCs | d¡S)z( Returns the show value of the message. r°ržrErrrÚgetShowÎszPresence.getShowcCs | d¡S)z+ Returns the status string of the message. r±ržrErrrÚ getStatusÑszPresence.getStatuscCs| d|¡dS)z# Sets the priority of the message. r¯Nr¤rwrrrr¬ÔszPresence.setPrioritycCs| d|¡dS)z% Sets the show value of the message. r°Nr¤rwrrrr­×szPresence.setShowcCs| d|¡dS)z( Sets the status string of the message. r±Nr¤rwrrrr®ÚszPresence.setStatuscCs4| d¡D]$}| |¡D]}| |¡Sq dS)Nr_)rhrk)rBr[ÚattrÚxtagr“rrrÚ_muc_getItemAttrÞszPresence._muc_getItemAttrcCsP| d¡D]@}| d¡D]0}| |¡D] }| ¡| |¡fSqq dS)Nr_r–)NN)rhr€rk)rBr[rµr¶r“ZcchildrrrÚ_muc_getSubTagDataAttrâs "zPresence._muc_getSubTagDataAttrcCs | dd¡S)z)Returns the presence role (for groupchat)r–Zrole©r·rErrrÚgetRoleèszPresence.getRolecCs | dd¡S)z0Returns the presence affiliation (for groupchat)r–Z affiliationr¹rErrrÚgetAffiliationëszPresence.getAffiliationcCs | dd¡S)z5Returns the nick value (for nick change in groupchat)r–Znickr¹rErrrÚgetNickîszPresence.getNickcCs | dd¡S)z(Returns the presence jid (for groupchat)r–rCr¹rErrrÚgetJidñszPresence.getJidcCs| dd¡dS)ú2Returns the reason of the presence (for groupchat)Úreasonr9r©r¸rErrrÚ getReasonôszPresence.getReasoncCs| dd¡dS)r¾ZactorrCrrÀrErrrÚgetActor÷szPresence.getActorcCs | dd¡S)z7Returns the status code of the presence (for groupchat)r±r‚r¹rErrrÚ getStatusCodeúszPresence.getStatusCode)rrrrrªrDr²r³r´r¬r­r®r·r¸rºr»r¼r½rÁrÂrÃrrrrr«Ás" r«c@s|eZdZdZddiddgedfdd„Zdd„Zdd„Zd d „Zd d „Z d d„Z ddd„Z dd„Z dd„Z dd„Zdd„ZdS)ÚIqz, XMPP Iq object - get/set dialog mechanism. Nc Cs:tj|d||||||d|r(| |¡|r6| |¡dS)aB Create Iq object. You can specify type, query namespace any additional attributes, recipient of the iq, sender of the iq, any additional payload (f.e. jabber:x:data node) and namespace in one go. Alternatively you can pass in the other XML object as the 'node' parameted to replicate it as an iq. r)rYrnr\rorprN)rXrDÚsetQueryPayloadÚ setQueryNS) rBrnZqueryNSr\rYror]rprrrrrDsz Iq.__init__cCs:| ¡}d}| ¡D] }d|ks,d| ¡kr|}q6q|S)z< Return the IQ's child element if it exists, None otherwise.Nr)rr~r)rBrnÚqueryr“rrrÚgetQuerys z Iq.getQuerycCs| ¡}|r| ¡SdS)z3 Return the namespace of the 'query' child element.N)rÈr©rBr[rrrÚ getQueryNSsz Iq.getQueryNScCs| ¡ d¡S)z@ Return the 'node' attribute value of the 'query' child element.r)rÈrkrErrrÚ getQuerynodeszIq.getQuerynodecCs| ¡}|r| ¡SdS)z* Return the 'query' child element payload.N)rÈZ getPayloadrÉrrrÚgetQueryPayloadszIq.getQueryPayloadcCs| ¡}|r| ¡SdS)z. Return the 'query' child element child nodes.N)rÈr~rÉrrrÚgetQueryChildrenszIq.getQueryChildrencCs0| ¡}|dur| d¡}|dur,| |¡|S)z› Change the name of the query node, creating it if needed. Keep the existing name if none is given (use 'query' if it's a creation). Return the query node.NrÇ)rÈrŠÚsetName)rBrmrÇrrrÚsetQuerys   z Iq.setQuerycCs| ¡ |¡dS)z0 Set the namespace of the 'query' child element.N)rÏrc)rBrarrrrÆ'sz Iq.setQueryNScCs| ¡ |¡dS)z' Set the 'query' child element payload.N)rÏZ setPayload)rBr]rrrrÅ*szIq.setQueryPayloadcCs| ¡ d|¡dS)z= Set the 'node' attribute value of the 'query' child element.rN)rÏrvrHrrrÚ setQuerynode-szIq.setQuerynodecCs@t|| ¡| ¡d| ¡id}| | ¡ ¡¡ | ¡¡|S)z’ Builds and returns another Iq object of specified type. The to, from and query child node of new Iq are pre-set as reply to this Iq. r^)rYror\) rÄrrrqrtrÏrÈrrcrÊ)rBrnrrrrr©0s z Iq.buildReply)N)rrrrrªrDrÈrÊrËrÌrÍrÏrÆrÅrÐr©rrrrrÄþs  rÄc@seZdZdZddd„ZdS)r‰z¨ XMPP-style error element. In the case of stanza error should be attached to XMPP stanza. In the case of stream-level errors should be used separately. Nc Cs¶|tvr$t|\}}}| ¡d}ndtddf\}}}}|r@|}|rH|}|rP|}t |dit|ƒg¡|rv| d|¡|s„| d¡|r¢|jt|di|gƒd |r²| d |¡d S) zÍ Create new error node object. Mandatory parameter: name - name of error condition. Optional parameters: code, typ, text. Used for backwards compartibility with older XMPP protocol.rÚ500r„r9rr=z stream:errorz textrr‚N)ÚERRORSrAÚ NS_STANZASrrDrvrÎrŠ) rBrmr‚rnr|Zcodr=ÚtxtÚnsrrrrD;szErrorNode.__init__)NNN)rrrrrDrrrrr‰7sr‰c@s$eZdZdZddd„Zd dd„ZdS) ÚErrorz< Used to quickly transform received stanza into error reply.rcCsP|r tj|| ¡| ¡|dntj||d| |¡| ¡dkrL|j|_dS)a Create error reply basing on the received 'node' stanza and the 'error' error condition. If the 'node' is not the received stanza but locally created ('to' and 'from' fields needs not swapping) specify the 'reply' argument as false.)rYrorrrN)rXrDrrrqr‹rÚ __dupstr__rO)rBrrZreplyrrrrDNs  zError.__init__NcCsdS)z¨ Dummy function used as preventor of creating error node in reply to error node. I.e. you will not be able to serialise "double" error into string. r9r)rBZdup1Údup2rrrr×VszError.__dupstr__)r)NN)rrrrrDr×rrrrrÖLs rÖc@s¼eZdZdZddddddgdfdd„Zd+dd„Zd d „Zd d „Zd d„Zdd„Z dd„Z dd„Z dd„Z dd„Z dd„Zdd„Zdd„Zdd „Zd!d"„Zd#d$„Zd%d&„Zd'd(„Zd)d*„ZdS),Ú DataFieldzÚ This class is used in the DataForm class to describe the single data item. If you are working with jabber:x:data (XEP-0004, XEP-0068, XEP-0122) then you will need to work with instances of this class. Nrc Cs¦tj|d|d|r| |¡t|ƒttfvr:| |¡n|rH| |¡|rX| |¡n|sj|sj| d¡|rx|  |¡|r†|  |¡|r”|  |¡|r¢|  |¡dS)a Create new data field of specified name,value and type. Also 'required','desc' and 'options' fields can be set. Alternatively other XML object can be passed in as the 'node' parameted to replicate it as a new datafiled. Úfieldrz text-singleN) rrDÚsetVarr=r†ÚtupleÚ setValuesÚsetValuerzÚ setRequiredÚsetLabelÚsetDescÚ setOptions) rBrmÚvaluernÚrequiredÚlabelÚdescÚoptionsrrrrrD`szDataField.__init__rcCs8|r| d¡n$z| d¡Wnty2YdS0dS)z* Change the state of the 'required' flag. räN)rÚdelChildr<)rBÚreqrrrrßoszDataField.setRequiredcCs | d¡S)z' Returns in this field a required one. rä©r}rErrrÚ isRequireduszDataField.isRequiredcCs| d|¡dS)z Set the label of this field. råNry)rBrårrrràxszDataField.setLabelcCs | d¡S)z! Return the label of this field. rårsrErrrÚgetLabel{szDataField.getLabelcCs| d|¡dS)z$ Set the description of this field. ræNr¤)rBrærrrrá~szDataField.setDesccCs | d¡S)z' Return the description of this field. ræržrErrrÚgetDescszDataField.getDesccCs| d|¡dS)z Set the value of this field. rãNr¤rwrrrrÞ„szDataField.setValuecCs | d¡S)NrãržrErrrÚgetValue‡szDataField.getValuecCs.| d¡r| d¡q|D]}| |¡qdS)z” Set the values of this field as values-list. Replaces all previous filed values! If you need to just add a value - use addValue method.rãN)r}rèÚaddValue)rBÚlstrxrrrr݉szDataField.setValuescCs| di|g¡dS)z> Add one more value to this field. Used in 'get' iq's or such.rãN©rŠrwrrrrïŽszDataField.addValuecCs&g}| d¡D]}| | ¡¡q|S)z6 Return the list of values associated with this field.rã)rhr‘r€©rBÚretr[rrrÚ getValues‘szDataField.getValuescCs2g}| d¡D]}| | d¡| d¡g¡q|S)z; Return label-option pairs list associated with this field.Úoptionrårã)rhr‘rkrŸròrrrÚ getOptions–s*zDataField.getOptionscCs.| d¡r| d¡q|D]}| |¡qdS)z8 Set label-option pairs list associated with this field.rõN)r}rèÚ addOption)rBrðÚoptrrrrâ›szDataField.setOptionscCsHt|ƒttfvr$| d¡ d|¡n | dd|di¡ d|d¡dS)z. Add one more label-option pair to this field.rõrãrårrN)r=r…rŠr¥)rBrørrrr÷Ÿs$zDataField.addOptioncCs | d¡S)z Get type of this field. r=rsrErrrr£szDataField.getTypecCs | d|¡S)z Set type of this field. r=ryrwrrrrz¦szDataField.setTypecCs | d¡S)z* Get 'var' attribute value of this field. ÚvarrsrErrrÚgetVar©szDataField.getVarcCs | d|¡S)z* Set 'var' attribute value of this field. rùryrwrrrrÛ¬szDataField.setVar)r)rrrrrDrßrëràrìrárírÞrîrÝrïrôrörâr÷rrzrúrÛrrrrrÙ\s( rÙc@sDeZdZdZddd„Zdd„Zddd„Zd d „Zd d „Zd d„Z dS)Ú DataReportedas This class is used in the DataForm class to describe the 'reported data field' data items which are used in 'multiple item form results' (as described in XEP-0004). Represents the fields that will be returned from a search. This information is useful when you try to use the jabber:iq:search namespace to return dynamic form information. NcCsXtj|d|d|rTg}| ¡D],}| ¡dkrB| t|d¡q | |¡q ||_dS)aÌ Create new empty 'reported data' field. However, note that, according XEP-0004: * It MUST contain one or more DataFields. * Contained DataFields SHOULD possess a 'type' and 'label' attribute in addition to 'var' attribute * Contained DataFields SHOULD NOT contain a element. Alternatively other XML object can be passed in as the 'node' parameted to replicate it as a new dataitem. ÚreportedrrÚN©rrDr~rr‘rÙÚkids©rBrÚnewkidsÚnrrrrD¶s  zDataReported.__init__cCs|jdd|idS©z; Return the datafield object with name 'name' (if exists). rÚrù)r\rê©rBrmrrrÚgetFieldÅszDataReported.getFieldcCs*| |¡}|r|S|jt|d|d|ƒdS)z® Create if nessessary or get the existing datafield object with name 'name' and return it. If created, attributes 'type' and 'label' are applied to new datafield.Nrr©rrŠrÙ)rBrmrnråÚfrrrÚsetFieldÈs zDataReported.setFieldcCsi}| d¡D]f}| d¡}| ¡}t|tƒrb|dd…dkrbg}| d¡D]}| | ¡¡qLn | d¡}|||<q| d¡rŒ|  ¡|d<|S©zT Represent dataitem as simple dictionary mapping of datafield names to their values.rÚrùéúÿÿÿNú-multirãÚ instructions© rhrkrÚ isinstancer…r‘r€rŸr}ÚgetInstructions©rBrórÚrmrnrxÚirrrÚasDictÎs    zDataReported.asDictcCs"| |¡}|r| ¡Stdƒ‚dS©zJ Simple dictionary interface for getting datafields values by their names.z No such fieldN©rrîÚ IndexError©rBrmr–rrrÚ __getitem__Ûs  zDataReported.__getitem__cCs| |¡ |¡S©zJ Simple dictionary interface for setting datafields values by their names.©rrÞ©rBrmrxrrrr—àszDataReported.__setitem__)N)NN© rrrrrDrrrrr—rrrrrû°s   rûc@sBeZdZdZddd„Zdd„Zdd„Zd d „Zd d „Zd d„Z dS)ÚDataItemzœ This class is used in the DataForm class to describe data items which are used in 'multiple item form results' (as described in XEP-0004). NcCsXtj|d|d|rTg}| ¡D],}| ¡dkrB| t|d¡q | |¡q ||_dS)a  Create new empty data item. However, note that, according XEP-0004, DataItem MUST contain ALL DataFields described in DataReported. Alternatively other XML object can be passed in as the 'node' parameted to replicate it as a new dataitem. r–rrÚNrýrÿrrrrDès  zDataItem.__init__cCs|jdd|idSrrêrrrrrõszDataItem.getFieldcCs"| |¡}|r|S|jt|ƒdS©z[ Create if nessessary or get the existing datafield object with name 'name' and return it. rr©rBrmrrrrrøs zDataItem.setFieldcCsi}| d¡D]f}| d¡}| ¡}t|tƒrb|dd…dkrbg}| d¡D]}| | ¡¡qLn | d¡}|||<q| d¡rŒ|  ¡|d<|Srr rrrrrýs    zDataItem.asDictcCs"| |¡}|r| ¡Stdƒ‚dSrrrrrrr s  zDataItem.__getitem__cCs| |¡ |¡Srrrrrrr—szDataItem.__setitem__)Nrrrrrräs  rc@s‚eZdZdZdgddfdd„Zdd„Zdd„Zd d „Zd d „Zd d„Z dd„Z dd„Z dd„Z dd„Z dd„Zdd„Zdd„ZdS)ÚDataFormz¥ DataForm class. Used for manipulating dataforms in XMPP. Relevant XEPs: 0004, 0068, 0122. Can be used in disco, pub-sub and many other applications.Nc CsŽtj|d|d|rg}| ¡D]h}| ¡dkrB| t|d¡q | ¡dkr`| t|d¡q | ¡dkr~| t|d¡q | |¡q ||_|rž|  |¡|  t ¡|r¶|  |¡t |ƒt iƒkrôg}t| ¡ƒD]}| t|||ƒ¡qÖ|}|D]} t | ƒt dƒt dƒfvr"| | ¡qø| jjdkr>|j | ¡qø| jjdkrZ|j | ¡qø| jjd krv|j | ¡qø|j t| d¡qød S) a$ Create new dataform of type 'typ'; 'data' is the list of DataReported, DataItem and DataField instances that this dataform contains; 'title' is the title string. You can specify the 'node' argument as the other node to be used as base for constructing this dataform. title and instructions is optional and SHOULD NOT contain newlines. Several instructions MAY be present. 'typ' can be one of ('form' | 'submit' | 'cancel' | 'result' ) 'typ' of reply iq can be ( 'result' | 'set' | 'set' | 'result' ) respectively. 'cancel' form can not contain any fields. All other forms contains AT LEAST one field. 'title' MAY be included in forms of type "form" and "result" r_rrÚr–rür9rÙrrûN)rrDr~rr‘rÙrrûrþrzrcÚNS_DATAÚsetTitler=r†rˆÚaddInstructionsrfr) rBrnÚdataÚtitlerrrÚnewdatarmr“rrrrDs,   &&zDataForm.__init__cCs | d¡S)z Return the type of dataform. r=rsrErrrr<szDataForm.getTypecCs| d|¡dS)z Set the type of dataform. r=Nry)rBrnrrrrz?szDataForm.setTypecCs | d¡S)z Return the title of dataform. r#ržrErrrÚgetTitleBszDataForm.getTitlecCs| d|¡dS)z Set the title of dataform. r#Nr¤©rBr|rrrr EszDataForm.setTitlecCs | d¡S)z& Return the instructions of dataform. r ržrErrrrHszDataForm.getInstructionscCs| d|¡dS)z# Set the instructions of dataform. r Nr¤r&rrrÚsetInstructionsKszDataForm.setInstructionscCs| di|g¡dS)z+ Add one more instruction to the dataform. r Nrñr&rrrr!NszDataForm.addInstructionscCs|jdd|idSrrêrrrrrQszDataForm.getFieldcCs"| |¡}|r|S|jt|ƒdSrrrrrrrTs zDataForm.setFieldcCsi}| d¡D]f}| d¡}| ¡}t|tƒrb|dd…dkrbg}| d¡D]}| | ¡¡qLn | d¡}|||<q| d¡rŒ|  ¡|d<|S)zT Represent dataform as simple dictionary mapping of datafield names to their values.rÚrùr Nr rãr r rrrrrYs    zDataForm.asDictcCs"| |¡}|r| ¡Stdƒ‚dSrrrrrrrfs  zDataForm.__getitem__cCs| |¡ |¡Srrrrrrr—kszDataForm.__setitem__)rrrrrDrrzr%r rr'r!rrrrr—rrrrrs% r)°rZ simplexmlrrrŒZ NS_ACTIVITYZ NS_ADDRESSZNS_ADMINZNS_ADMIN_ADD_USERZNS_ADMIN_DELETE_USERZNS_ADMIN_DISABLE_USERZNS_ADMIN_REENABLE_USERZNS_ADMIN_END_USER_SESSIONZNS_ADMIN_GET_USER_PASSWORDZNS_ADMIN_CHANGE_USER_PASSWORDZNS_ADMIN_GET_USER_ROSTERZNS_ADMIN_GET_USER_LASTLOGINZNS_ADMIN_USER_STATSZNS_ADMIN_EDIT_BLACKLISTZNS_ADMIN_EDIT_WHITELISTZNS_ADMIN_REGISTERED_USERS_NUMZNS_ADMIN_DISABLED_USERS_NUMZNS_ADMIN_ONLINE_USERS_NUMZNS_ADMIN_ACTIVE_USERS_NUMZNS_ADMIN_IDLE_USERS_NUMZNS_ADMIN_REGISTERED_USERS_LISTZNS_ADMIN_DISABLED_USERS_LISTZNS_ADMIN_ONLINE_USERS_LISTZNS_ADMIN_ACTIVE_USERS_LISTZNS_ADMIN_IDLE_USERS_LISTZNS_ADMIN_ANNOUNCEZNS_ADMIN_SET_MOTDZNS_ADMIN_EDIT_MOTDZNS_ADMIN_DELETE_MOTDZNS_ADMIN_SET_WELCOMEZNS_ADMIN_DELETE_WELCOMEZNS_ADMIN_EDIT_ADMINZNS_ADMIN_RESTARTZNS_ADMIN_SHUTDOWNZ NS_AGENTSZNS_AMPZ NS_AMP_ERRORSZNS_AUTHZ NS_AVATARZNS_BINDZ NS_BROWSEZ NS_BYTESTREAMZNS_CAPSZ NS_CHATSTATESrªZ NS_COMMANDSZNS_COMPONENT_ACCEPTZNS_COMPONENT_1Z NS_COMPRESSrZNS_DATA_LAYOUTZNS_DATA_VALIDATEriZ NS_DIALBACKZNS_DISCOZ NS_DISCO_INFOZNS_DISCO_ITEMSZ NS_ENCRYPTEDZNS_EVENTZ NS_FEATUREZNS_FILEZ NS_GATEWAYZ NS_GEOLOCZ NS_GROUPCHATZ NS_HTTP_BINDZNS_IBBZ NS_INVISIBLEZNS_IQZNS_LASTZ NS_MESSAGEZNS_MOODZNS_MUCZ NS_MUC_ADMINZ NS_MUC_OWNERZ NS_MUC_UNIQUEZ NS_MUC_USERZNS_MUC_REGISTERZNS_MUC_REQUESTZNS_MUC_ROOMCONFIGZNS_MUC_ROOMINFOZ NS_MUC_ROOMSZ NS_MUC_TRAFICZNS_NICKZ NS_OFFLINEZ NS_PHYSLOCZ NS_PRESENCEZ NS_PRIVACYZ NS_PRIVATEZ NS_PUBSUBZ NS_REGISTERZNS_RCZ NS_ROSTERZ NS_ROSTERXZNS_RPCZNS_SASLZ NS_SEARCHZ NS_SERVERZ NS_SESSIONZNS_SIZ NS_SI_PUBZ NS_SIGNEDrÓZ NS_STREAMSZNS_TIMEZNS_TLSZ NS_VACATIONZNS_VCARDZNS_VCARD_UPDATEZ NS_VERSIONZNS_WAITINGLISTZ NS_XHTML_IMZNS_XMPP_STREAMSZxmpp_stream_error_conditionsZxmpp_stanza_error_conditionsZsasl_error_conditionsrÒr‡rÕZerrnameZerrpoolrAÚerrZcondr‚rnr|ÚupperÚreplacermÚlocalsrrÚ Exceptionrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6Zstream_exceptionsr8rXr˜r«rÄr‰rÖrÙrûrrrrrrÚs‚ þé:Y#=9T4/