o /h̄@sVdZgZddlZddlZddlZddlZddlmZddl m Z ddl Z ddl m Z mZmZddlmZzddlmZWneyKddlmZYnweZGd d d ZGd d d eZGd ddeZGdddeZGdddeeZGdddZGdddZGdddZGdddZ Gddde Z! d!ddZ"Gdd d Z#dS)"zBbase classes and helper functions for css and stylesheets packagesN)chain)unique_everseen)codec errorhandler tokenize2 normalize)_defaultFetcherc@s.eZdZdZeZejZ ddZ ddZ dS) _BaseClasszi Base class for Base, Base2 and _NewBase. **Base and Base2 will be removed in the future!** cCs&t|dr|jrtjd|jdS)z>Raise xml.dom.NoModificationAllowedErr if rule/... is readonly _readonlyz%s is readonly.TF)hasattrr xmldomNoModificationAllowedErr __class__selfrA/var/www/html/myenv/lib/python3.10/site-packages/cssutils/util.py_checkReadonly$sz_BaseClass._checkReadonlycCs*|sdSt|tr |Sddd|DS)z Return string value of t (t may be a string, a list of token tuples or a single tuple in format (type, value, line, col). Mainly used to get a string value of t for error messages. cSsg|]}|dqS)rr).0xrrr 6z(_BaseClass._valuestr..) isinstancestrjoin)rtrrr _valuestr+s  z_BaseClass._valuestrN) __name__ __module__ __qualname____doc__r ErrorHandler_logrCSSProductions_prodsrr rrrrr s  r c@s>eZdZdZddZddZddZdd d Zed d Z d S)_NewBasezi New base class for classes using ProdParser. **Currently CSSValue and related ones only.** cC t|_dSNSeq_seqrrrr__init__@ z_NewBase.__init__cCsd|_||_dS)z'Set value of ``seq`` which is readonly.TN)r r.)rnewseqrrr_setSeqC z_NewBase._setSeqcCs|jdSr+)r.clearrrrr _clearSeqHz_NewBase._clearSeqFcCs t|dS)z8Get a writeable Seq() which is used to set ``seq`` later)readonly)r-rr7rrr_tempSeqKs z_NewBase._tempSeqcC|jS)z,Internal readonly attribute, **DO NOT USE**!r.rrrrseqOz _NewBase.seqNF) r!r"r#r$r/r2r5r9propertyr<rrrrr)9s r)c@PeZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ dS) _NewListBaseaR (EXPERIMENTAL) A base class used for list classes like stylesheets.MediaList adds list like behaviour running on inhering class' property ``seq`` - item in x => bool - len(x) => integer - get, set and del x[i] - for item in x - append(item) some methods must be overwritten in inheriting class cCr*r+r,rrrrr/er0z_NewListBase.__init__cCs |jD] }||jkr dSqdS)NTFr.value)ritemitrrr __contains__hs  z_NewListBase.__contains__cC |j|=dSr+r;rindexrrr __delitem__nr0z_NewListBase.__delitem__cCs |j|jSr+rBrHrrr __getitem__qr0z_NewListBase.__getitem__cfdd}|S)Nc3sjD]}|jVqdSr+rBrrrrgenus  z"_NewListBase.__iter__..genrrrNrrr__iter__ts z_NewListBase.__iter__cC t|jSr+lenr.rrrr__len__{ z_NewListBase.__len__cCtzmust be overwrittenNotImplementedErrorrrIrDrrr __setitem__~z_NewListBase.__setitem__cCrVrWrXrrDrrrappendr\z_NewListBase.appendN r!r"r#r$r/rFrJrKrPrTr[r^rrrrrAUs rAc @seZdZdZeZgggggggggggd ZeddZ ddZ ddZ dd d Z d d Z dddZddZddZ             dddZdddZ dddZd S)Basea **Superceded by _NewBase** **Superceded by Base2 which is used for new seq handling class.** Base class for most CSS and StyleSheets classes Contains helper methods for inheriting classes helping parsing ``_normalize`` is static as used by Preferences. ) backgroundborderz border-leftz border-rightz border-topz border-bottomcuefontz list-styleoutlinepausecCst|S)a normalizes x, namely: - remove any \ before non unicode sequences (0-9a-zA-Z) so for x=="c\olor\" return "color" (unicode escape sequences should have been resolved by the tokenizer already) - lowercase rrMrrr _normalizes zBase._normalizecCs2t|tr|dt|j|dfS|t|jdfS)z returns tuple (text, dict-of-namespaces) or if no namespaces are in cssText returns (cssText, {}) used in Selector, SelectorList, CSSStyleRule, CSSMediaRule and CSSStyleSheet rr)log)rtuple_SimpleNamespacesr&)rtext_namespaces_tuplerrr_splitNamespacesOffs  zBase._splitNamespacesOffcCs6|sdSt|tr|j|St|tr|gSt|S)zw returns tokens of textortokens which may already be tokens in which case simply returns input N)rr_Base__tokenizer2tokenizeriiter)r textortokensrrr _tokenize2s   zBase._tokenize2Nc Cs(zt|WStttfy|YSw)z>returns next token in generator tokenizer or the default value)next StopIterationAttributeError TypeError)r tokenizerdefaultrrr _nexttokens  zBase._nexttokencCs|r|dSdS)zreturns type of Tokenizer tokenrNr)rtokenrrr_typesz Base._typeFcCs&|r |r t|dS|r|dSdS)z returns value of Tokenizer tokenrN)r`rg)rryr rrr _tokenvalues zBase._tokenvaluecCs0|r|d}|d|d|dddSdS)z for STRING returns the actual content without surrounding "" or '' and without respective escapes, e.g.:: "with " char" => with " char r\rN)replacerryrCrrr_stringtokenvalues zBase._stringtokenvaluecCs`|r.|ddd}|r,|ddvr,|d|dkr,|d|d|ddd}|SdS)z for URI returns the actual content without surrounding url() or url(""), url('') and without respective escapes, e.g.:: url(""") => " rr}rz'"r|N)stripr~rrrr_uritokenvalues   zBase._uritokenvaluecCsXd}d}d}}}|rd}d}nM|rd}d}nF|rd}d}n?|r&d}d }n8|r/d}d}d }n/|r4d}n*| r9d }n%| r>d }n | rCd}n| rSd }|rR||d krRd}n | rZd}d}n|r^d}g}|r|||d}d |krt|d7}nd|kr}|d7}nd|kr|d7}|r|D]}|\}}}}d|kr||nyd|kr|d7}n2d|kr|d8}n)d |kr|d7}n d |kr|d8}nd|kstjj|kr|d7}nd|kr|d8}||||kr|krdkrnn ||vs||vrn|r|dkr||kr dkrnq||vrnq|r*|r&|dd|dfS|dfS|S)z returns tokens upto end of atrule and end index end is defined by parameters, might be ; } ) or other default looks for ending "}" and ";" z;}rr{r}}r;)STRINGz:;z;!][),(EOFN)r{r^r`r(FUNCTION)rrv starttokenblockstartonly blockendonly mediaendonlyimportmediaqueryendonlymediaqueryendonly semicolonpropertynameendonlypropertyvalueendonlypropertypriorityendonlyselectorattendonly funcendonly listseponly separateEndendsendtypesbracebracketparant resulttokensvalrytyplinecolrrr _tokensupto2s            "  zBase._tokensupto2csJd fdd }d dd}d dd}d dd }||||d }|||S) : adds default productions if not already present, used by _parse only each production should return the next expected token normaly a name like "uri" or "EOF" some have no expectation like S or COMMENT, so simply return the current value of self.__expected NcsP|dkrtj}|||_|jr|||Sdd<jjd|d|S)!default impl for unexpected @rulerF wellformed Expected EOF.ry) cssutilscssCSSUnknownRulercssTextrr^r&errorexpectedr<ryrvrulenewrrr ATKEYWORDs  z.Base._adddefaultproductions..ATKEYWORDcSs|tj|g|S)z.COMMENTcSs|S)z0default implementation for S token, does nothingrrrrrSr\z&Base._adddefaultproductions..ScSdSz$default implementation for EOF tokenrrrrrrrr\z(Base._adddefaultproductions..EOFrrrrr+NNNNupdate)r productionsrrrrrprrr_adddefaultproductionss    zBase._adddefaultproductionscsd}rfdd} tg} n} | r=|||} | D]} | | d|} | r2| ||| }qd}|jd| q||fS)a puts parsed tokens in seq by calling a production with (seq, tokenizer, token) expected a name what token or value is expected next, e.g. 'uri' seq to add rules etc to tokenizer call tokenizer.next() to get next token productions callbacks {tokentype: callback} default default callback if tokentype not in productions new used to init default productions initialtoken will be used together with tokenizer running 1st this token and then all tokens in tokenizer returns (wellformed, expected) which the last prod might have set Tc3sVEdHdS)z*Build new tokenizer including initialtokenNrr initialtokenrvrrtokensszBase._parse..tokensrFz!Unexpected token (%s, %s, %s, %s))rrgetr&r)rrr<rvrrwrrrr fulltokenizerprodsryrrrr_parses  z Base._parser+r>)NFFFFFFFFFFFFFNNN)r!r"r#r$r Tokenizerrm_SHORTHANDPROPERTIES staticmethodrgrlrqrxrzr{rrrrrrrrrr`sX        x5r`c@s"eZdZdZddZdddZdS)Base2zK **Superceded by _NewBase.** Base class for new seq handling. cCr*r+r,rrrrr/r0zBase2.__init__NcsVd fdd }d fdd }d fdd }d dd }||||d }|||S) rNcsf|dkr%tj}|||_|jr#|j|tjjj|d|dd|Sdd<j j d|d|S) rr)rrFrrr) rrrrrrr^CSSRule UNKNOWN_RULEr&rrrrrrs z/Base2._adddefaultproductions..ATKEYWORDcs:|dkrdd<jjd|d|tj|gd|S)z5default impl, adds CSSCommentRule if not token == EOFrFrzExpected EOF but found comment.rr)r&rr^rrrrrrrrs z-Base2._adddefaultproductions..COMMENTcs$|dkrdd<jjd|d|S)z.default impl, does nothing if not token == EOFrFrz"Expected EOF but found whitespace.r)r&rrrrrrsz'Base2._adddefaultproductions..ScSrrrrrrrr%r\z)Base2._adddefaultproductions..EOFrr+rr)rrrrrrrdefaultproductionsrrrrs   zBase2._adddefaultproductionsr+)r!r"r#r$r/rrrrrrsrc@seZdZdZd#ddZddZddZd d Zd d Zd dZ ddZ ddZ d$ddZ ddZ ddZd%ddZd&ddZdd Zd'd!d"ZdS)(r-z property seq of Base2 inheriting classes, holds a list of Item objects. used only by Selector for now is normally readonly, only writable during parsing TcCsg|_||_dS)z only way to write to a Seq is to initialize it with new items each itemtuple has (value, type, line) where line is optional N)r.r r8rrrr/<s z Seq.__init__cCs*d|j|jjddd|jD|jS)z8returns a repr same as a list of tuples of (value, type)z(cssutils.{}.{}([ {}], readonly={!r})z, cSsg|]}d|qS)%rr)rrDrrrrIrz Seq.__repr__..)formatr"rr!rr.r rrrr__repr__Ds z Seq.__repr__c Csg}|D]$}t|jtr||jqt|tr!||jdq|t|qd|jd|jjdt |d|d|j dt |dd S) Nrz ) rrCrr^rireprr"rr!rSr id)rvalsvrrr__str__Ms  <z Seq.__str__cCrGr+r;rirrrrJYr0zSeq.__delitem__cC |j|Sr+r;rrrrrK\rUzSeq.__getitem__cCs$|\}}}}t|||||j|<dSr+)Itemr.)rrxxx_todo_changemerrrrrrrr[_s zSeq.__setitem__cCrQr+)ror.rrrrrPcrUz Seq.__iter__cCrQr+rRrrrrrTfrUz Seq.__len__NcCsB|jrtdt|tr|j|dS|jt||||dS)zIf not readonly add new Item()Seq is readonly.N)r rtrrr.r^)rrrrrrrrr^is  z Seq.appendcCs|jrtd|j|dS)z.if not readonly add item which must be an ItemrN)r rtr.r^r]rrr appendItemsszSeq.appendItemcCs|jdd=dSr+r;rrrrr4zsz Seq.clearcCs|j|t||||dS)z4Insert new Item() at index # even if readony!? TODO!N)r.insertrrrIrrrrrrrr}sz Seq.insertr}cCs&|jrtdt|||||j|<dS)zm if not readonly replace Item at index with new Item or simply replace value or type rN)r rtrr.rrrrr~sz Seq.replacecCsL|jr |jdjtjjkr$|jd=|jr"|jdjtjjks dSdSdSdS)ztrims S items from end of Seqr}N)r.typerr'rrrrrrstrips*z Seq.rstripcCs<|jrtd|j|}t|j||j|j|j|j|<dS)zA if not readonly append to Item's value at index rN)r rtr.rrCrrr)rrrIoldrrr appendToVals $zSeq.appendToVal)TrNN)r}NNNN)Nr})r!r"r#r$r/rrrJrKr[rPrTr^rr4rr~rrrrrrr-3s"        r-c@sReZdZdZd ddZeddZeddZeddZed dZ d d Z dS) rat an item in the seq list of classes (successor to tuple items in old seq) each item has attributes: type a sematic type like "element", "attribute" value the actual value which may be a string, number etc or an instance of e.g. a CSSComment *line* **NOT IMPLEMENTED YET, may contain the line in the source later** NcCs||_||_||_||_dSr+) _Item__value _Item__type _Item__line _Item__col)rrCrrrrrrr/s z Item.__init__cCr:r+)rrrrrz Item.cCr:r+)rrrrrrrcCr:r+)rrrrrrrcCr:r+)rrrrrrrc Cs6|jd|jjd|jd|jd|jd|jd S)Nrz(value=z, type=z, line=z, col=r)r"rr!rrrrrrrrrs6z Item.__repr__r) r!r"r#r$r/r?rrCrrrrrrrrs      rc@r@)ListSeqas (EXPERIMENTAL) A base class used for list classes like cssutils.css.SelectorList or stylesheets.MediaList adds list like behaviour running on inhering class' property ``seq`` - item in x => bool - len(x) => integer - get, set and del x[i] - for item in x - append(item) some methods must be overwritten in inheriting class cCs g|_dSr+r<rrrrr/rUzListSeq.__init__cC ||jvSr+rr]rrrrFrUzListSeq.__contains__cCrGr+rrHrrrrJr0zListSeq.__delitem__cCrr+rrHrrrrKrUzListSeq.__getitem__crL)Nc3sjEdHdSr+rrrrrrNszListSeq.__iter__..genrrOrrrrPs zListSeq.__iter__cCrQr+)rSr<rrrrrTrUzListSeq.__len__cCrVrWrXrZrrrr[r\zListSeq.__setitem__cCrVrWrXr]rrrr^r\zListSeq.appendNr_rrrrrs rc@seZdZdZd#ddZddZddZd d Zd d Zd dZ ddZ ddZ ddZ e ddZddZddZddZddZdd Zd!d"ZdS)$ _Namespacesa A dictionary like wrapper for @namespace rules used in a CSSStyleSheet. Works on effective namespaces, so e.g. if:: @namespace p1 "uri"; @namespace p2 "uri"; only the second rule is effective and kept. namespaces a dictionary {prefix: namespaceURI} containing the effective namespaces only. These are the latest set in the CSSStyleSheet. parentStyleSheet the parent CSSStyleSheet NcGs||_||_dS)z5no initial values are set, only the relevant sheet isN)parentStyleSheetr&)rrrhargsrrrr/r3z_Namespaces.__init__cCs d|jS)Nr namespacesrrrrrrUz_Namespaces.__repr__cCrr+rrprefixrrrrFrUz_Namespaces.__contains__cCs`||}ttdd|jjD]\}}||kr!|j|dSq|jjd|tj j ddS)z6deletes CSSNamespaceRule(s) with rule.prefix == prefixcS |j|jkSr+rNAMESPACE_RULErrrrr  z)_Namespaces.__delitem__..NPrefix %s not found.r) _Namespaces__findrule enumeratefilterrcssRules deleteRuler&rrr NamespaceErr)rrdelrulerrrrrrJs   z_Namespaces.__delitem__cCs:z|j|WSty|jjd|tjjdYdSw)Nrr)rKeyErrorr&rrrr rrrrrKs   z_Namespaces.__getitem__cCs |jSr+)rrPrrrrrPrUz_Namespaces.__iter__cCrQr+)rSrrrrrrTrUz_Namespaces.__len__cCs^||}|s|jjtjj||ddddS||jvr||_|t|j vr-||_ dSdS)zDreplaces prefix or sets new rule, may raise NoModificationAllowedErrr namespaceURIT)inOrderN) rr insertRulerrCSSNamespaceRulerrlistvaluesr)rrrrrrrr[s   z_Namespaces.__setitem__cs,pdtfddt|jj}t|dS)Nrcs|j|jko |jkSr+)rrrrrrrr0z(_Namespaces.__findrule..)r reversedrr rr)rrfoundrrr __findrule+s    z_Namespaces.__findrulecCs6tddt|jj}t|tdd}dd|DS)zg A property holding only effective @namespace rules in self.parentStyleSheets. cSrr+rrrrrr<rz(_Namespaces.namespaces..r)keycSsi|]}|j|jqSrr)rrrrr Crz*_Namespaces.namespaces..)r rrr roperator attrgetter)rns_rules unique_rulesrrrr5s z_Namespaces.namespacescCs|j||Sr+)rr)rrrwrrrrEr6z_Namespaces.getcCt|jSr+)rritemsrrrrr"Hr6z_Namespaces.itemscCr!r+)rrkeysrrrrr#Kr6z_Namespaces.keyscCr!r+)rrrrrrrrNr6z_Namespaces.valuescCs4t|jD] \}}||kr|Sqtd|)zm returns effective prefix for given namespaceURI or raises IndexError if this cannot be foundzNamespaceURI %s not found.)rrr" IndexError)rrrurirrrprefixForNamespaceURIQs  z!_Namespaces.prefixForNamespaceURIcCs(d|jjdt|jdt|ddS)Nd}|st}||}|rt|dkr|ddur|\}}|r#d}|}n-|r*d}|}n&t|tr7t|\} } nt|\} } | rEd}| }n |rLd}|}nd}d}t|trX|} n@z$ztdd||d d} Wnt yz| |ru|nd} YnwWnt y} zt j | d d d} WYd} ~ nd} ~ ww||| fSd S) a1 Read cssText from url and decode it using all relevant methods (HTTP header, BOM, @charset). Returns - encoding used to decode text (which is needed to set encoding of stylesheet properly) - type of encoding (how it was retrieved, see list below) - decodedCssText ``fetcher`` see cssutils.CSSParser.setFetcher for details ``overrideEncoding`` If given this encoding is used and all other encoding information is ignored (HTTP, BOM etc) ``parentEncoding`` Encoding of parent stylesheet (while e.g. reading @import references sheets) or document if available. Priority or encoding information -------------------------------- **cssutils only**: 0. overrideEncoding 1. An HTTP "charset" parameter in a "Content-Type" field (or similar parameters in other protocols) 2. BOM and/or @charset (see below) 3. or other metadata from the linking mechanism (if any) 4. charset of referring style sheet or document (if any) 5. Assume UTF-8 Nrrrrzutf-8r)encodingT) neverraiser)r rSrrrdetectencoding_unicodedetectencoding_strcodecslookuprtdecodeUnicodeDecodeErrorrhwarn) urlfetcheroverrideEncodingparentEncodingenctyper httpEncodingcontentr0contentEncodingexplicitdecodedCssTexterrr_readUrlxsV!     rDc@sveZdZdZdZdddZddZdd d Zdd d Zdd dZ dddZ dddZ dddZ dddZ dddZdS) LazyRegexaA class to represent a lazily compiled regular expression. The interface is kept similar to a `re.compile`ed object from the standard regex library. :ivar pattern: The original regular expression. :ivar flags: Flags of the regular expression. :ivar matcher: The compiled regular expression, or None if it is not yet compiled. :ivar groups: The number of capturing groups in the pattern, or None. :ivar groupindex: A dictionary mapping any symbolic group names defined by `(?P)` to group numbers. The dictionary is empty if no symbolic groups were used in the pattern. None if the pattern is not yet compiled. )patternflagsmatchergroups groupindexrcCs"||_d|_||_d|_d|_dSr+)rFrHrGrIrJ)rrFrGrrrr/s  zLazyRegex.__init__cCsB|jdurdSt|j|j|_|jj|_|jj|_|jj|_dS)zzMake sure that the expression is compiled. If self.matcher is already a compiled expression, do nothing. N)rHrecompilerFrGrIrJrrrrensures   zLazyRegex.ensureNcCs||||S)z Shortcut for self.match(string).)matchrstringposendposrrr__call__szLazyRegex.__call__cC4||dur d}|durt|}|j|||S)zzAttempt to do a match of the regular expression. This is similar to the `.match` method of `re` objects. Nr)rMrSrHrNrOrrrrN zLazyRegex.matchcCrT)zmSearch the string for the pattern. This is similar to the `.search` method of `re` objects. Nr)rMrSrHsearchrOrrrrVrUzLazyRegex.searchcCs||j||S)zjSplit the string at the pattern. This is similar to the `.split` method of `re` objects. )rMrHsplit)rrPmaxsplitrrrrWszLazyRegex.splitcCrT)zFind all instances of the pattern in the given string. This is similar to the `.findall` method of `re` objects. Nr)rMrSrHfindallrOrrrrYrUzLazyRegex.findallcCrT)zFind all instances of the pattern in the given string. Returns an iterator. This is similar to the `.finditer` method of `re` objects. Nr)rMrSrHfinditerrOrrrrZ(s zLazyRegex.finditercC||j|||S)zReplace all occurences of the pattern with the given replacement. This is similar to the `.sub` method of `re` objects. )rMrHsubrreplrPcountrrrr\6z LazyRegex.subcCr[)zReplace all occurences of the pattern with the given replacement. This is similar to the `.subn` method of `re` objects. )rMrHsubnr]rrrra>r`zLazyRegex.subn)rr)r!r"r#r$ __slots__r/rMrSrNrVrWrYrZr\rarrrrrEs    rEr)$r$__all__r4rrKxml.domr itertoolsrmore_itertoolsrrrrrrhelperr _fetchgaer ImportError_fetchr%rhr r)rAr`rr-rrrrjrDrErrrrs@    2iEi/u Z