a î½jçXã@stdZddlZdd„ZdZdd„ZGdd „d eƒZGd d „d ƒZGd d „d eƒZ dZ Gdd„dƒZ dd„Z dd„Z dS)zÌSimplexml module provides xmpppy library with all needed tools to handle XML nodes and XML streams. I'm personally using it in many other separate projects. It is designed to be as standalone as possible.éNcCs4| dd¡ dd¡ dd¡ dd¡ d d ¡ d d ¡S) zWReturns provided string with symbols & < > " replaced by their respective XML entities.ú&z&úz>ú"z"ú Úú)Úreplace)Útxt©r úT/Users/admin/.hermes/hermes-agent/venv/lib/python3.9/site-packages/xmpp/simplexml.pyÚ XMLescapesr zutf-8cCsNt|tƒr|Sz | ¡}Wnty4t|ƒ}Yn0t|tƒsJt|tƒS|S)zqConverts object "what" to unicode string using it's own __str__ method if accessible or unicode method otherwise.)Ú isinstanceÚstrÚ__str__ÚAttributeErrorÚENCODING)ÚwhatÚrr r r Úustrs rc@sxeZdZdZdZdigddddfdd„ZdNdd „ZdOd d „Zd d „Zdigddfdd„Z dd„Z dd„Z dd„Z ifdd„Z dd„Zdd„Zdd„Zdd„Zd d!„Zd"d#„Zd$d%„Zd&d'„Zidfd(d)„Zd*d+„Zd,d-„Ziddfd.d/„Zidfd0d1„Zd2d3„Zd4d5„Zd6d7„Zd8d9„Zd:d;„ZdPdd?„Z!d@dA„Z"ifdBdC„Z#dDdE„Z$dFdG„Z%dHdI„Z&dJdK„Z'dLdM„Z(dS)QÚNodea’ Node class describes syntax of separate XML Node. It have a constructor that permits node creation from set of "namespace name", attributes and payload of text strings and other nodes. It does not natively support building node from text string and uses NodeBuilder class for that purpose. After creation node can be mangled in many ways so it can be completely changed. Also node can be serialised into string in one of two modes: default (where the textual representation of node describes it exactly) and "fancy" - with whitespace added to make indentation and thus make result more readable by human. Node class have attribute FORCE_NODE_RECREATION that is defaults to False thus enabling fast node replication from the some other node. The drawback of the fast way is that new node shares some info with the "original" node that is changing the one node may influence the other. Though it is rarely needed (in xmpppy it is never needed at all since I'm usually never using original node after replication (and using replication only to move upwards on the classes tree). rNFcCsJ|râ|jrt|tƒrt|ƒ}t|tƒs6t||ƒ}d}nª|j|jigg|jif\|_|_|_|_ |_ |_|_ t |j  ¡ƒD]}|j||j|<qx|j D]} |j  | ¡q”|j D]} |j  | ¡q¬t |j  ¡ƒD]\} } | |j | <qÌn.ddiggdif\|_|_|_|_ |_ |_|_ |r||_i|_|rJt | ¡ƒD]\} } | |j| <q4t | ¡ƒD]L\} }| dkrt||j d<n|  d¡r’||j | dd…<|| |j| <qV|rþ|rÜdg| d¡d d…\}|_| |¡|_n"d |vrø| ¡\|_|_n||_t|tƒr|g}|D]0}t|tƒr2|j|d n|j  t|ƒ¡qdS) aÍ Takes "tag" argument as the name of node (prepended by namespace, if needed and separated from it by a space), attrs dictionary as the set of arguments, payload list as the set of textual strings and child nodes that this node carries within itself and "parent" argument that is another node that this one will be the child of. Also the __init__ can be provided with "node" argument that is either a text string containing exactly one node or another Node instance to begin with. If both "node" and other arguments is provided then the node initially created as replica of "node" provided and then modified to be compliant with other arguments.TÚtagrNÚxmlnsúxmlns:éú:éþÿÿÿú ©Únode)ÚFORCE_NODE_RECREATIONrrrÚ NodeBuilderÚnameÚ namespaceÚparentÚattrsÚdataÚkidsÚnsdÚlistÚkeysÚappendÚitemsÚ nsp_cacheÚ startswithÚsplitÚ lookup_nspÚaddChildr)Úselfrr%Úpayloadr$ÚnspÚ node_builtrÚkeyr&ÚkidÚkÚvÚattrÚvalÚpfxÚir r r Ú__init__4sD  4$$."    z Node.__init__rcCsR|j |d¡}|dur$|j |d¡}|durN|jrJ|j |¡}||j|<ndS|S)Nz%http://www.gajim.org/xmlns/undeclared)r(Úgetr-r$r0)r2r<Únsr r r r0bs  zNode.lookup_nspcCs|dddd|j}|jrL|jr4|jj|jkrLd|jvrL|d|j}t|j ¡ƒD]&}t|j|ƒ}|d|t|ƒf}qZ|d}d }|jr@|r¢|d }|jD]–}|sÖt |j ƒd|krÖ|t|j |ƒ}n(t |j ƒd|krþ|t|j |  ¡ƒ}t |t ƒr$|| |o|d¡}n|r6|| ¡}|d}q¨|snt |j ƒd|krn|t|j |ƒ}n*t |j ƒd|kr˜|t|j |  ¡ƒ}|jsÌ| d¡rÌ|d d …d }|r|d }nB|rî|j sî||ddd}|d|jd}|r|d }|S)z Method used to dump node into textual representation. if "fancy" argument is set to True produces indented output for readability.éérrrz xmlns="%s"z %s="%s"rrÚ Néÿÿÿÿz />z| |¡|j |¡|j d¡|S)z If "node" argument is provided, adds it as child node. Else creates new node from the other arguments' values and adds it as well.rz,Use namespace=x instead of attrs={'xmlns':x})rr$r%r3r)rr$rÚ setNamespacer'r+r&)r2r"r%r3r#rZnewnoder r r r1œs   z Node.addChildcCs |j t|ƒ¡|j d¡dS)z Adds some CDATA to node. N)r&r+rr'©r2r&r r r ÚaddDataªsz Node.addDatacCs g|_dS)z" Removes all CDATA from the node. N)r&©r2r r r Ú clearData®szNode.clearDatacCs |j|=dS)z Deletes an attribute "key" N©r%©r2r6r r r ÚdelAttr±sz Node.delAttrcCs,t|tƒs| ||¡}d|j|j |¡<|S)z© Deletes the "node" from the node's childs list, if "node" is an instance. Else deletes the first node that have specified name and (optionally) attributes. N)rrÚgetTagr'Úindex)r2rr%r r r ÚdelChild´sz Node.delChildcCs|jS)z. Returns all node's attributes as dictionary. rRrPr r r ÚgetAttrsºsz Node.getAttrscCs z |j|WSYdS0dS)z' Returns value of specified attribute. NrRrSr r r ÚgetAttr½sz Node.getAttrcCs|jS)z) Returns all node's child nodes as list. )r'rPr r r Ú getChildrenÁszNode.getChildrencCs d |j¡S)z2 Returns all node CDATA as string (concatenated). r)Újoinr&rPr r r ÚgetDataÄsz Node.getDatacCs|jS)z Returns the name of node ©r"rPr r r ÚgetNameÇsz Node.getNamecCs|jS)z Returns the namespace of node ©r#rPr r r Ú getNamespaceÊszNode.getNamespacecCs|jS)z* Returns the parent of node (if present). ©r$rPr r r Ú getParentÍszNode.getParentcCsxg}ttt|jƒt|jƒƒƒD]T}|t|jƒkrJ|j|rJ| |j|¡|t|jƒkr|j|r| |j|¡q|S)zä Return the payload of node i.e. list of child nodes and CDATA entries. F.e. for "text1 text2" will be returned list: ['text1', , , ' text2']. )ÚrangeÚmaxrEr&r'r+)r2Úretr=r r r Ú getPayloadÐs (*zNode.getPayloadcCs|j|||ddS)zx Filters all child nodes using specified arguments as filter. Returns the first found or None if not found. rA)Úone)ÚgetTags)r2r"r%r#r r r rUÙsz Node.getTagcCs&z| |¡j|WSYdS0dS)zY Returns attribute value of the child with specified name (or None if no such attribute).N)rUr%)r2rr:r r r Ú getTagAttrÝszNode.getTagAttrcCs$z| |¡ ¡WSYdS0dS)z< Returns cocatenated CDATA of the child with specified name.N)rUr\©r2rr r r Ú getTagDataászNode.getTagDatacCsg}|jD]x}|sq |r&|| ¡kr&q | ¡|krnt| ¡ƒD]$}||jvs^|j|||kr>qnq>| |¡|r |r |dSq |sŒ|SdS)zk Filters all child nodes using specified arguments as filter. Returns the list of nodes found. rN)r'r`r^r)r*r%r+)r2r"r%r#rgÚnodesrr6r r r rhås  " z Node.getTagsccsp|jD]d}|sq|dur&|| ¡kr&q| ¡|krt| ¡ƒD]$}||jvs^|j|||kr>qq>|VqdS)z@ Iterate over all children using specified arguments as filter. N)r'r`r^r)r*r%)r2r"r%r#rr6r r r ÚiterTagsós   ÿz Node.iterTagscCs||j|<dS)z, Sets attribute "key" with the value "val". NrR)r2r6r;r r r ÚsetAttrÿsz Node.setAttrcCst|ƒg|_dS)zA Sets node's CDATA to provided string. Resets all previous CDATA!N)rr&rNr r r ÚsetDatasz Node.setDatacCs ||_dS)z Changes the node name. Nr])r2r;r r r ÚsetNamesz Node.setNamecCs ||_dS)z Changes the node namespace. Nr_)r2r#r r r rMszNode.setNamespacecCs ||_dS)z¥ Sets node's parent to "node". WARNING: do not checks if the parent already present and not removes the node from the list of childs of previous parent. Nra©r2rr r r Ú setParent szNode.setParentcCs.t|tƒr|g}|r$|j|7_n||_dS)zÄ Sets node payload according to the list specified. WARNING: completely replaces all node's previous content. If you wish just to add child or CDATA - use addData or addChild methods. N)rrr')r2r3Úaddr r r Ú setPayloadszNode.setPayloadcCs.|j|||dd}|r|S|j|||dSdS)z} Same as getTag but if the node with specified namespace/attributes not found, creates such node and returns it. rA)r#rgr_N)rhr1)r2r"r%r#rr r r ÚsetTagsz Node.setTagcCs8z|| |¡j|<Wn|j|||idYn0dS)zv Creates new node (if not already present) with name "tag" and sets it's attribute "attr" to value "val". rRN)rUr%r1)r2rr:r;r r r Ú setTagAttrszNode.setTagAttrcCsBz| ||¡ t|ƒ¡Wn"|j||t|ƒgdYn0dS)z Creates new node (if not already present) with name "tag" and (optionally) attributes "attrs" and sets it's CDATA to string "val". ©r3N)rUrorr1)r2rr;r%r r r Ú setTagData szNode.setTagDatacCs ||jvS)z% Checks if node have attribute "key".rRrSr r r Úhas_attr%sz Node.has_attrcCs | |¡S)z( Returns node's attribute "item" value. )rY©r2Úitemr r r Ú __getitem__(szNode.__getitem__cCs | ||¡S)z% Sets node's attribute "item" value. )rn)r2r{r;r r r Ú __setitem__+szNode.__setitem__cCs | |¡S)z" Deletes node's attribute "item". )rTrzr r r Ú __delitem__.szNode.__delitem__cCs8|dkrt|ƒ|_|jS|dkr0t|ƒ|_|jSt‚dS)zK Reduce memory usage caused by T/NT classes - use memory only when needed. ÚTÚNTN)rr€r©r2r:r r r Ú __getattr__1s  zNode.__getattr__)r)r)r))Ú__name__Ú __module__Ú __qualname__Ú__doc__r r>r0rrLr1rOrQrTrWrXrYrZr\r^r`rbrfrUrirkrhrmrnrorprMrrrtrurvrxryr|r}r~r‚r r r r r$sL. !      rc@s0eZdZdZdd„Zdd„Zdd„Zdd „Zd S) rz= Auxiliary class used to quick access to node's child nodes. cCs||jd<dS)Nr)Ú__dict__rqr r r r>=óz T.__init__cCs |j |¡S©N)rrUrr r r r‚>rˆz T.__getattr__cCs4t|tƒr"tj|j |¡|dn|j ||¡SdS)Nr)rrr>rrurx©r2r:r;r r r Ú __setattr__?s"z T.__setattr__cCs |j |¡Sr‰)rrWrr r r Ú __delattr__Brˆz T.__delattr__N)rƒr„r…r†r>r‚r‹rŒr r r r r;s rc@s eZdZdZdd„Zdd„ZdS)r€z: Auxiliary class used to quick create node's child nodes. cCs |j |¡Sr‰)rr1rr r r r‚FrˆzNT.__getattr__cCs2t|tƒr|jj||dn|jj||gdSdS)Nrrw)rrrr1rŠr r r r‹GszNT.__setattr__N)rƒr„r…r†r‚r‹r r r r r€Dsr€Z nodebuilderc@sŽeZdZdZd"dd„Zdd„Zdd„Zd d „Zd d „Zd d„Z dd„Z d#dd„Z dd„Z dd„Z dd„Zdd„Zd$dd„Zdd„Zd d!„ZdS)%r!a½ Builds a Node class minidom from data parsed to it. This class used for two purposes: 1. Creation an XML Node from a textual representation. F.e. reading a config file. See an XML2Node method. 2. Handling an incoming XML stream. This is done by mangling the __dispatch_depth parameter and redefining the dispatch method. You do not need to use this class directly if you do not designing your own XML handler.NcCs®| tdd¡tjj ¡|_|j|j_|j |j_ |j |j_ |j |j_d|j_|jj|_d|_d|_d|_d|_d|_d|_||_d|_d|_d|_d|_|rª|j |d¡dS)al Takes two optional parameters: "data" and "initial_node". By default class initialised with empty Node class instance. Though, if "initial_node" is provided it used as "starting point". You can think about it as of "node upgrade". "data" (if provided) feeded to parser immidiatedly after instance init. z(Preparing to handle incoming XML stream.ÚstartTrrANr)ÚDEBUGÚDBG_NODEBUILDERÚxmlÚparsersÚexpatÚ ParserCreateÚ_parserÚstarttagÚStartElementHandlerÚendtagÚEndElementHandlerÚ handle_cdataÚCharacterDataHandlerÚhandle_namespace_startÚStartNamespaceDeclHandlerÚ buffer_textÚParseÚ_NodeBuilder__depthÚ_NodeBuilder__last_depthÚ_NodeBuilder__max_depthÚ_dispatch_depthÚ_document_attrsÚ _document_nspÚ _mini_domÚ last_is_dataÚ_ptrÚ data_bufferÚ streamError)r2r&Z initial_noder r r r>Rs*     zNodeBuilder.__init__cCs2|jr.|jj d |j¡¡|jdd…=d|_dS)Nr)r¨r§r&r+r[rPr r r Úcheck_data_bufferps zNodeBuilder.check_data_buffercCs,| ¡d|j_d|j_d|j_d|j_dS)z> Method used to allow class instance to be garbage-collected. N)rªr”r–r˜ršrœrPr r r Údestroyvs zNodeBuilder.destroyc Cs¾| ¡| ¡| td|j|t|ƒfd¡|j|jkrx|jsVt|||j dd|_ntj |j|||j dd|j|_ n6|j|jkr®|j j   t||j |dd¡|j j d|_ |jdkr’i|_i|_ dg| d ¡d d …\}}t| ¡ƒD]H\}}|d kr ||j d<qî| d ¡r,||j |dd …<qî||j|<qî|j  |d¡}z| |||¡Wn8ty}zd |_tt|ƒƒ‚WYd }~n d }~00|js´|j jr´|j jj  d¡d|_d S)ú$XML Parser callback. Used internallyz$DEPTH -> %i , tag -> %s, attrs -> %sZdownT)rr%r4r5)rr$r%r5rDrArrrNrrrz*http://www.gajim.org/xmlns/undeclared-rootr)rªÚ _inc_depthrŽrrŸÚreprr¢r¥rr¤r>r§r'r+r£r/r)r,r.r?Ústream_header_receivedÚ ValueErrorrr¦r$r&) r2rr%r4r"r:r;r@Úer r r r•~s<        "zNodeBuilder.starttagcCs¦| td|j|fd¡| ¡|j|jkr\|j ¡dkrN|j ¡d ¡|_|  |j¡n&|j|jkrt|j j |_ n| tdd¡|  ¡d|_ |jdkr¢| ¡dS)r¬zDEPTH -> %i , tag -> %sÚupÚerrorrz2Got higher than dispatch level. Stream terminated?ÚstopN)rŽrrŸrªr¢r¥r^rZr©Údispatchr§r$Ú _dec_depthr¦Ústream_footer_receivedrjr r r r—¡s   zNodeBuilder.endtagcCs@| t|d¡|jr(|jr<|j |¡n|jr<|g|_d|_dS)r¬r&rAN)rŽrr¦r¨r+r§rNr r r r™±szNodeBuilder.handle_cdatacCs | ¡dS)r¬N©rª)r2ÚprefixÚurir r r r›»sz"NodeBuilder.handle_namespace_startcCsdS)zM Gets all NodeBuilder walking events. Can be used for debugging if redefined.Nr )r2ÚlevelÚtextÚcommentr r r rŽ¿szNodeBuilder.DEBUGcCs| ¡|jS)z Returns just built Node. )rªr¥rPr r r ÚgetDomÁszNodeBuilder.getDomcCsdS)z¾ Gets called when the NodeBuilder reaches some level of depth on it's way up with the built node as argument. Can be redefined to convert incoming XML stanzas to program events. Nr )r2Zstanzar r r rµÅszNodeBuilder.dispatchcCs | ¡dS)z( Method called when stream just opened. Nr¸)r2r@rr%r r r r¯Èsz"NodeBuilder.stream_header_receivedcCs | ¡dS)z( Method called when stream just closed. Nr¸rPr r r r·Ësz"NodeBuilder.stream_footer_receivedrcCs|j|ko|j|kS)z9 Return True if at least one end tag was seen (at level) )rŸr¡)r2r»r r r Úhas_received_endtagÏszNodeBuilder.has_received_endtagcCs*|j|_|jd7_t|j|jƒ|_dS©NrA)rŸr rdr¡rPr r r r­ÓszNodeBuilder._inc_depthcCs|j|_|jd8_dSrÀ)rŸr rPr r r r¶ØszNodeBuilder._dec_depth)NN)N)r)rƒr„r…r†r>rªr«r•r—r™r›rŽr¾rµr¯r·r¿r­r¶r r r r r!Ls  #   r!cCs t|ƒ ¡S)z³ Converts supplied textual string into XML node. Handy f.e. for reading configuration file. Raises xml.parser.expat.parsererror if provided string is not well-formed XML. ©r!r¾©rr r r ÚXML2NodeÜsrÃcCs t|ƒ ¡S)a Converts supplied textual string into XML node. Survives if xml data is cutted half way round. I.e. "some text
some more text". Will raise xml.parser.expat.parsererror on misplaced tags though. F.e. "some text
some more text" will not work.rÁrÂr r r Ú BadXML2NodeásrÄ)r†Zxml.parsers.expatrr rrÚobjectrrr€rr!rÃrÄr r r r Ús