o Zh0hB5@sVddlmZddlmZddlmZddlmZmZGdddZ dd Z d d Z d S) )cached_property)warn) ascii_lower)compile_selector_listsplit_whitespacec@s&eZdZdZed:ddZed:ddZed;dd Z d:d d Zd d Z ddZ ddZ ddZ e ddZe ddZddZddZddZddZd d!Zd"d#Zed$d%Zd&d'Zd(d)Zd*d+Zed,d-Zed.d/Zed0d1Zed2d3Zed4d5Z ed6d7Z!ed8d9Z"dS)<ElementWrapperaWrapper of :class:`xml.etree.ElementTree.Element` for Selector matching. This class should not be instanciated directly. :meth:`from_xml_root` or :meth:`from_html_root` should be used for the root element of a document, and other elements should be accessed (and wrappers generated) using methods such as :meth:`iter_children` and :meth:`iter_subtree`. :class:`ElementWrapper` objects compare equal if their underlying :class:`xml.etree.ElementTree.Element` do. NcC|j||ddS)a.Wrap for selector matching the root of an XML or XHTML document. :param root: An ElementTree :class:`xml.etree.ElementTree.Element` for the root element of a document. If the given element is not the root, selector matching will behave is if it were. In other words, selectors will be not be `scoped`_ to the subtree rooted at that element. :returns: A new :class:`ElementWrapper` .. _scoped: https://drafts.csswg.org/selectors-4/#scoping Fin_html_document _from_rootclsrootcontent_languagerE/var/www/html/rh/venv/lib/python3.10/site-packages/cssselect2/tree.py from_xml_rootszElementWrapper.from_xml_rootcCr )zSame as :meth:`from_xml_root` with case-insensitive attribute names. Useful for documents parsed with an HTML parser like html5lib, which should be the case of documents with the ``text/html`` MIME type. Tr r rrrrfrom_html_root(szElementWrapper.from_html_rootTcCs&t|dr |}||ddd||dS)Ngetrootr)parentindexpreviousr r)hasattrr)rrrr rrrr 2s zElementWrapper._from_rootcCsN||_||_||_|dur|j|_n|g|_||_||_||_d|_d|_ dSN) etree_elementrretree_childrenetree_siblingsrr transport_content_language _ancestors_previous_siblings)selfrrrrr rrrr__init__:s  zElementWrapper.__init__cCst|t|uo |j|jkSr)typerr"otherrrr__eq__Vs zElementWrapper.__eq__cCs ||k Srrr%rrr__ne__[s zElementWrapper.__ne__cCstt||jfSr)hashr$rr"rrr__hash__^szElementWrapper.__hash__ccs|EdHdSr) iter_childrenr*rrr__iter__aszElementWrapper.__iter__cC4|jdur|jdur dn g|jj|jR|_|jS)uTuple of existing ancestors. Tuple of existing :class:`ElementWrapper` objects for this element’s ancestors, in reversed tree order, from :attr:`parent` to the root. Nr)r r ancestorsr*rrrr/ds  zElementWrapper.ancestorscCr.)uTuple of previous siblings. Tuple of existing :class:`ElementWrapper` objects for this element’s previous siblings, in reversed tree order. Nr)r!rprevious_siblingsr*rrrr0qs z ElementWrapper.previous_siblingscctdt|jEdHdS)uIterate over ancestors. Return an iterator of existing :class:`ElementWrapper` objects for this element’s ancestors, in reversed tree order (from :attr:`parent` to the root). The element itself is not included, this is an empty sequence for the root element. This method is deprecated and will be removed in version 0.7.0. Use :attr:`ancestors` instead. zfThis method is deprecated and will be removed in version 0.7.0. Use the "ancestors" attribute instead.N)rDeprecationWarningr/r*rrriter_ancestorss zElementWrapper.iter_ancestorsccr1)uIterate over previous siblings. Return an iterator of existing :class:`ElementWrapper` objects for this element’s previous siblings, in reversed tree order. The element itself is not included, this is an empty sequence for a first child or the root element. This method is deprecated and will be removed in version 0.7.0. Use :attr:`previous_siblings` instead. znThis method is deprecated and will be removed in version 0.7.0. Use the "previous_siblings" attribute instead.N)rr2r0r*rrriter_previous_siblingss  z%ElementWrapper.iter_previous_siblingsccs*|jdur |VdS|jEdHdS)uIterate over siblings. Return an iterator of newly-created :class:`ElementWrapper` objects for this element’s siblings, in tree order. N)rr,r*rrr iter_siblingss  zElementWrapper.iter_siblingsccs.d}|D] }|r|V||krd}qdS)uIterate over next siblings. Return an iterator of newly-created :class:`ElementWrapper` objects for this element’s next siblings, in tree order. FTN)r5)r"foundsiblingrrriter_next_siblingss z!ElementWrapper.iter_next_siblingsccs<d}t|jD]\}}t||||||jd}|VqdS)uIterate over children. Return an iterator of newly-created :class:`ElementWrapper` objects for this element’s child elements, in tree order. N)rrrr ) enumeraterr$r )r"childi etree_childrrrr,szElementWrapper.iter_childrenccsRt|gg}|r't|dd}|dur|n |V|||s dSdS)aIterate over subtree. Return an iterator of newly-created :class:`ElementWrapper` objects for the entire subtree rooted at this element, in tree order. Unlike in other methods, the element itself *is* included. This loops over an entire document: .. code-block:: python for element in ElementWrapper.from_root(root_etree).iter_subtree(): ... N)iternextpopappendr,)r"stackelementrrr iter_subtrees   zElementWrapper.iter_subtreecCsdd|DS)NcSs@g|]}t|dr |gnt|D] }|jdur|js|jqqS)testN)rrpseudo_element never_matchesrE).0selectorcompiled_selectorrrr s z+ElementWrapper._compile..r) selectorsrrr_compileszElementWrapper._compilecstfdd|DS)zReturn wether this elememt matches any of the given selectors. :param selectors: Each given selector is either a :class:`compiler.CompiledSelector`, or an argument to :func:`compile_selector_list`. c3|]}|VqdSrrrHrEr*rr z)ElementWrapper.matches..)anyrMr"rLrr*rmatchesszElementWrapper.matchescsJ||tdkrtd|S|r!fdd|DStdS)aReturn elements, in tree order, that match any of given selectors. Selectors are `scoped`_ to the subtree rooted at this element. .. _scoped: https://drafts.csswg.org/selectors-4/#scoping :param selectors: Each given selector is either a :class:`compiler.CompiledSelector`, or an argument to :func:`compile_selector_list`. :returns: An iterator of newly-created :class:`ElementWrapper` objects. rrc3s*|]tfddDrVqdS)c3rNrrrOrCrrrPrQz5ElementWrapper.query_all...N)rR)rHtestsrUrrPs z+ElementWrapper.query_all..r)rMlenfilterrDr>rSrrVr query_alls   zElementWrapper.query_allcGst|j|dS)ajReturn first element that matches any of given selectors. :param selectors: Each given selector is either a :class:`compiler.CompiledSelector`, or an argument to :func:`compile_selector_list`. :returns: A newly-created :class:`ElementWrapper` object, or :obj:`None` if there is no match. N)r?rZrSrrrquerys zElementWrapper.querycCsdd|jDS)a%Children as a list of :class:`xml.etree.ElementTree.Element`. Other ElementTree nodes such as :func:`comments ` and :func:`processing instructions ` are not included. cSsg|] }t|jtr|qSr) isinstancetagstr)rHrCrrrrK,s  z1ElementWrapper.etree_children..)rr*rrrr!s zElementWrapper.etree_childrencCs"t|jj\}}||jtd<|S)z,The local name of this element, as a string. namespace_url_split_etree_tagrr]__dict__r^r"r_ local_namerrrrd0zElementWrapper.local_namecCs"t|jj\}}||jtd<|S)z/The namespace URL of this element, as a string.rdr`rcrrrr_7rezElementWrapper.namespace_urlcCs |jdS)z$The ID of this element, as a string.id)rgetr*rrrrf>s zElementWrapper.idcCstt|jddS)z:The classes of this element, as a :class:`set` of strings.class)setrrrgr*rrrclassesCszElementWrapper.classescCs|jd}|durt|S|jp|jdk}|r&|jd}|dur&t|S|jdur/|jjS|rYd}|jd}|D]}|dd}t|dkrPt|d }q;|durYt|St|j p_dS) z*The language of this element, as a string.z*{http://www.w3.org/XML/1998/namespace}langNzhttp://www.w3.org/1999/xhtmllangz"{http://www.w3.org/1999/xhtml}metaz http-equivrizcontent-languagecontent) rrgrr r_rrlr>_parse_content_languager)r"xml_langis_htmlrlriteratormeta http_equivrrrrlHs.      zElementWrapper.langcsh|jdurdSd}d|jjj|ko-|jjdduo-|jjkp-tfdd|D}|p3|jjS)NFz&{http://www.w3.org/1999/xhtml}fieldsetz${http://www.w3.org/1999/xhtml}legenddisabledc3s|] }|jjkVqdSr)rr])rHr7legendrrrPns  z6ElementWrapper.in_disabled_fieldset..)rrr]rgrRr4in_disabled_fieldset)r"fieldsetdisabled_fieldsetrrurrwes  z#ElementWrapper.in_disabled_fieldsetr)T)#__name__ __module__ __qualname____doc__ classmethodrrr r#r'r(r+r-propertyr/r0r3r4r5r8r,rD staticmethodrMrTrZr[rrrdr_rfrkrlrwrrrrr sV                 rcCsF|d}|dkr d|fS|ddksJ|d|||ddfS)N}r=rir{r)rfind)r]positionrrrrats racCs8|durd|vrt|}t|dkr|dSdSdSdS)N,rr)rrX)valuepartsrrrrn}s  rnN) functoolsrwarningsr webencodingsrcompilerrrrrarnrrrrs  m