U :g8@srddlZddlmZddlmZddlmZmZeedrBej Z nGdddZ Gdd d Z d d Z d d Z dS)N)warn) ascii_lower)compile_selector_listsplit_whitespacecached_propertyc@s&eZdZdddZdefddZdS)rNcCs*|p|j|_|j|_|p|j|_||_dSN)__name__ __module____doc__func)selfr namedocr3/tmp/pip-unpacked-wheel-xeg67qda/cssselect2/tree.py__init__s  zcached_property.__init__cCs>|dkr |S|j|j|}||kr:||}||j|j<|Sr)__dict__getr r )r objtypeZ_cached_property__missingvaluerrr__get__s  zcached_property.__get__)NN)r r __qualname__robjectrrrrrr s c@s$eZdZdZed:ddZed;ddZedElementWrapperaWrapper 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. NcCs|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_languagerrr from_xml_root-szElementWrapper.from_xml_rootcCs|j||ddS)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. Trrr rrrfrom_html_root@szElementWrapper.from_html_rootTcCs&t|dr|}||ddd||dS)Ngetrootr)parentindexpreviousrr#)hasattrr&)r!r"r#rrrrrJs zElementWrapper._from_rootcCsN||_||_||_|dk r$|j|_n|g|_||_||_||_d|_d|_ dSr) etree_elementr'r)etree_childrenZetree_siblingsr(rtransport_content_language _ancestors_previous_siblings)r r+r'r(r)rr#rrrrSs zElementWrapper.__init__cCst|t|ko|j|jkSr)rr+r otherrrr__eq__os zElementWrapper.__eq__cCs ||k Srrr0rrr__ne__tszElementWrapper.__ne__cCstt||jfSr)hashrr+r rrr__hash__wszElementWrapper.__hash__ccs|EdHdSr) iter_childrenr5rrr__iter__zszElementWrapper.__iter__cCs0|jdkr*|jdkrdn|jj|jf|_|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' ancestorsr5rrrr9}s  zElementWrapper.ancestorscCs0|jdkr*|jdkrdn|jj|jf|_|jS)uTuple of previous siblings. Tuple of existing :class:`ElementWrapper` objects for this element’s previous siblings, in reversed tree order. Nr)r/r)previous_siblingsr5rrrr:s  z ElementWrapper.previous_siblingsccstdt|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)rDeprecationWarningr9r5rrriter_ancestorss zElementWrapper.iter_ancestorsccstdt|jEdHdS)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)rr;r:r5rrriter_previous_siblingss z%ElementWrapper.iter_previous_siblingsccs&|jdkr|Vn|jEdHdS)uIterate over siblings. Return an iterator of newly-created :class:`ElementWrapper` objects for this element’s siblings, in tree order. N)r'r7r5rrr iter_siblingss zElementWrapper.iter_siblingsccs,d}|D]}|r|V||kr d}q dS)uIterate over next siblings. Return an iterator of newly-created :class:`ElementWrapper` objects for this element’s next siblings, in tree order. FTN)r>)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)r'r(r)r) enumerater,rr)r childiZ etree_childrrrr7szElementWrapper.iter_childrenccsJt|gg}|rFt|dd}|dkr0|q |V||q dS)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)iternextpopappendr7)r stackelementrrr iter_subtrees  zElementWrapper.iter_subtreecCsdd|DS)NcSs@g|]8}t|dr|gnt|D]}|jdkr |js |jq qS)testN)r*rZpseudo_elementZ never_matchesrM).0selectorZcompiled_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`. c3s|]}|VqdSrrrNrMr5rr sz)ElementWrapper.matches..)anyrRr rQrr5rmatches szElementWrapper.matchescsN||tdkr(td|S|rBfdd|DStdSdS)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)c3s|]}|VqdSrrrSrKrrrT*sz5ElementWrapper.query_all...N)rU)rNtestsrXrrT(sz+ElementWrapper.query_all..rN)rRlenfilterrLrFrVrrYr 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)rGr]rVrrrquery.s 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)rNrKrrrrPFs z1ElementWrapper.etree_children..)r+r5rrrr,;s zElementWrapper.etree_childrencCs"t|jj\}}||jtd<|S)z,The local name of this element, as a string. namespace_url_split_etree_tagr+r`rrar rb local_namerrrrfJszElementWrapper.local_namecCs"t|jj\}}||jtd<|S)z/The namespace URL of this element, as a string.rfrcrerrrrbQszElementWrapper.namespace_urlcCs |jdS)z$The ID of this element, as a string.id)r+rr5rrrrgXszElementWrapper.idcCstt|jddS)z:The classes of this element, as a :class:`set` of strings.class)setrr+rr5rrrclasses]szElementWrapper.classescCs|jd}|dk rt|S|jp*|jdk}|rL|jd}|dk rLt|S|jdk r^|jjS|rd}|jd}|D]*}|dd}t|dkrvt|d }qv|dk rt|St|j pdS) 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) r+rrrrbr'rlrF_parse_content_languager-)r Zxml_langZis_htmlrlr#iteratormetaZ http_equivrrrrlbs8    zElementWrapper.langcsh|jdkrdSd}d|jjj|koZ|jjddk oZ|jjkpZtfdd|D}|pf|jjS)NFz&{http://www.w3.org/1999/xhtml}fieldsetz${http://www.w3.org/1999/xhtml}legenddisabledc3s|]}|jjkVqdSr)r+r`)rNr@ZlegendrrrTsz6ElementWrapper.in_disabled_fieldset..)r'r+r`rrUr=in_disabled_fieldset)r fieldsetZdisabled_fieldsetrrrrrss z#ElementWrapper.in_disabled_fieldset)N)N)T)N)#r r rr classmethodr$r%rrr2r3r6r8propertyr9r:r<r=r>rAr7rL staticmethodrRrWr]r^rr,rfrbrgrkrlrsrrrrr!sT                rcCsJ|d}|dkrd|fS|ddks*t|d|||ddfSdS)N}rErir{r)rfindAssertionError)r`positionrrrrds  rdcCs0|dk r,d|kr,t|}t|dkr,|dSdS)N,rr)rr[)rpartsrrrrns rn) functoolswarningsr webencodingsrcompilerrrr*rrrdrnrrrrs   r