o e@sfdZdgZddlmZddlmZmZddlmZddl m Z ddl Z ddl ZGd dde jjZdS) zCSSStyleSheet implements DOM Level 2 CSS CSSStyleSheet. Partly also: - http://dev.w3.org/csswg/cssom/#the-cssstylesheet - http://www.w3.org/TR/2006/WD-css3-namespace-20060828/ TODO: - ownerRule and ownerNode CSSStyleSheet) Deprecated) _Namespaces_readUrl)CSSRule)CSSVariablesDeclarationNcsNeZdZdZ         d>fdd Zdd Zd d Zd d ZddZddZ e ddZ e j ddZ ddZ ddZe e edZddZ d?ddZd@ddZd d!Zd"d#Ze eed$Ze d%d&Zd'd(Ze d)d*d+d,Zd-d.Zd/d0ZdAd1d2Ze d3d*d4d,Zd5d6Ze ed7d,Zed8d9d:Z ed;d) rr*r#r,encodingrr namespacesidr-r$r$r%__str__Ws zCSSStyleSheet.__str__cCsp|j}t|j}d}|t|kr6||}|j|jkr*|j|jf|vr*| |n|d7}|t|ksdSdS)z;Remove all namespace rules with same namespaceURI but last.rrN) rlistr0itemslentypeNAMESPACE_RULEprefix namespaceURI deleteRule)rrulesZnamespaceitemsiruler$r$r%_cleanNamespacesjs   zCSSStyleSheet._cleanNamespacescCsdt}|D]*}|j|jkr||jq|j|jkr/|D]}|j|jkr.||jqq|S)z%Return set of URIs used in the sheet.)set STYLE_RULEr6updateZ selectorListZ _getUsedUris MEDIA_RULE)rusedurisr1r2r$r$r% _getUsedURIsys   zCSSStyleSheet._getUsedURIscC|jS)zDAll Rules in this style sheet, a :class:`~cssutils.css.CSSRuleList`.r&r(r$r$r%rzCSSStyleSheet.cssRulescCs2|j|_|j|_|j|_|D]}||_q||_dS)z1Set new cssRules and update contained rules refs.N) insertRuleappendextendr: __delitem___parentStyleSheetr')rrr=r$r$r%rs  cCs tj|S)z9Textual representation of the stylesheet (a byte string).)rserZdo_CSSStyleSheetr(r$r$r% _getCssTexts zCSSStyleSheet._getCssTextcsH|\}}|}ddd}dfdd }fdd}fdd }fd d }fd d } fdd} fdd} fdd} fdd} fdd}j}j}tj_|_t_ g}j d||||dddd|| ||| | | | d |d\}}|rt j d_ dS|_|_ dS) a Parse `cssText` and overwrites the whole stylesheet. :param cssText: a parseable string or a tuple of (cssText, dict-of-namespaces) :exceptions: - :exc:`~xml.dom.NamespaceErr`: If a namespace prefix is found which is not declared. - :exc:`~xml.dom.NoModificationAllowedErr`: Raised if the rule is readonly. - :exc:`~xml.dom.SyntaxErr`: Raised if the specified CSS string value has a syntax error and is unparsable. NcSstd|pdS)Nrr)maxexpectedseqtoken tokenizerr$r$r%Ssz$CSSStyleSheet._setCssText..Scs&tjj|gdtd|pdS)zspecial: sets parent*r rr)rIrrZ CSSCommentrPrQr(r$r%COMMENTsz*CSSStyleSheet._setCssText..COMMENTcsPtjjd}|||_|dkrjd|tjj |S|j r& |dS)NrWrzFCSSStylesheet: CSSCharsetRule only allowed at beginning of stylesheet.r) rrCSSCharsetRule _tokensupto2cssTextrerrorxmldomHierarchyRequestErr wellformedrIrRrSrTrUr=r(r$r% charsetrules z.CSSStyleSheet._setCssText..charsetrulecsPtjjd}|||_|dkrjd|tjj |S|j r& |dS)NrWrz.CSSStylesheet: CSSImportRule not allowed here.) rrZ CSSImportRulerZr[rr\r]r^r_r`rIrar(r$r% importrules z-CSSStyleSheet._setCssText..importrulecstjj||d}|dkrjd|tjj|S|j rJ|j j vr-j |ddnj |jD]}|j |j krB||jq4|jj|j <dS)N)r[r z1CSSStylesheet: CSSNamespaceRule not allowed here.F)_clean)rrZCSSNamespaceRulerZrr\r]r^r_r`r8r0rIr rulesOfTyper7Z_replaceNamespaceURIr9r)rRrSrTrUr=rr(r$r% namespacerules&    z0CSSStyleSheet._setCssText..namespacerulecsXtjjd}|||_|dkrjd|tjj |S|j r* | dS)NrWrdz1CSSStylesheet: CSSVariablesRule not allowed here.) rrZCSSVariablesRulerZr[rr\r]r^r_r`rI_updateVariablesrar(r$r% variablesrules z0CSSStyleSheet._setCssText..variablesrulec0tjjd}|||_|jr|dSNrW)rrZCSSFontFaceRulerZr[r`rIrar(r$r% fontfacerule  z/CSSStyleSheet._setCssText..fontfacerulecrkrl)rrZ CSSMediaRulerZr[r`rIrar(r$r% mediaruleroz,CSSStyleSheet._setCssText..mediarulecrkrl)rrZ CSSPageRulerZr[r`rIrar(r$r%pageruleroz+CSSStyleSheet._setCssText..pagerulecs|dtjjjvr!jjd|ddtjjd}|||_njjd|ddtjj d}|||_|j r@ |t d|pEdS)Nrz*CSSStylesheet: MarginRule out CSSPageRule.T)Z neverraiserWz#CSSStylesheet: Unknown @rule found.r) rrZ MarginRuleZmarginsrr\rZr[warnZCSSUnknownRuler`rIrPrar(r$r% unknownrule s z.CSSStyleSheet._setCssText..unknownrulecrkrl)rrZ CSSStyleRulerZr[r`rIrar(r$r%ruleset5roz*CSSStyleSheet._setCssText..rulesetrcWdSNr$Zignoredr$r$r%Qz+CSSStyleSheet._setCssText..cWrurvr$rwr$r$r%rxRry) rVrXZCDOZCDCZ CHARSET_SYMZ FONT_FACE_SYMZ IMPORT_SYMZ NAMESPACE_SYMZPAGE_SYMZ MEDIA_SYMZ VARIABLES_SYMZ ATKEYWORD)defaultr rv)_checkReadonlyZ_splitNamespacesOffZ _tokenize2rrrrrrr_parserrr>r'ri)rr[r0rUrVrXrbrcrhrjrnrprqrsrtZ oldCssRulesZ oldNamespacesZnewseqr`rRr$r(r% _setCssTexts\                zCSSStyleSheet._setCssTextz8Textual representation of the stylesheet (a byte string)c Cs^z|j}Wnty$z|jdj}Wn ttfy!d}YnwYnwt||j|j|dS)zORead (encoding, enctype, decodedContent) from `url` for @import sheets.rN)fetcherZoverrideEncodingparentEncoding)_CSSStyleSheet__newEncodingAttributeErrorr'r/ IndexErrorrrr)rurlrr$r$r%_resolveImportqs   zCSSStyleSheet._resolveImportcCs^|r||_|r ||_||_|r|j|_d|_dS|r-||_z|`WdSty,YdSwdS)zSet `cssText` but use `encodingOverride` to overwrite detected encoding. This is used by parse and @import during setting of cssText. If `encoding` is given use this but do not save as `encodingOverride`. N)rrr[r/r)rr[ZencodingOverrider/r$r$r%_setCssTextWithEncodingOverrides    z-CSSStyleSheet._setCssTextWithEncodingOverridecCs ||_dS)z4Set @import URL loader, if None the default is used.N)r)rr~r$r$r% _setFetchers zCSSStyleSheet._setFetcherc Cs(z|jdjWSttfyYdSw)zEncoding set in :class:`~cssutils.css.CSSCharsetRule` or if ``None`` resulting in default ``utf-8`` encoding being used.rzutf-8)r'r/rrr(r$r$r% _getEncodings zCSSStyleSheet._getEncodingcCstz|jd}Wn tyd}Ynw|r)|j|jkr)|r"||_dS|ddS|r8|tjj |dddSdS)zSet `encoding` of charset rule if present in sheet or insert a new :class:`~cssutils.css.CSSCharsetRule` with given `encoding`. If `encoding` is None removes charsetrule if present resulting in default encoding of utf-8. rN)r/) r'r CHARSET_RULEr6r/r:rIrrrY)rr/r=r$r$r% _setEncodings  zCSSStyleSheet._setEncodingzW(cssutils) Reflect encoding of an @charset rule or 'utf-8' (default) if set to ``None``cCrG)z*All Namespaces used in this CSSStyleSheet.)rr(r$r$r%r0rHzCSSStyleSheet.namespacescCsv|jtjD]}|j}|r|jD] }|j||j|qq|jtjD]}|jD] }|j||j|q+q&dS)zdUpdates self._variables, called when @import or @variables rules is added to sheet. N) rrfr IMPORT_RULEZ styleSheet variablesrZ setVariableVARIABLES_RULE)rrgsvarZvrr$r$r%ris  zCSSStyleSheet._updateVariablescCrGrv)rr(r$r$r%rxzCSSStyleSheet.zA :class:`cssutils.css.CSSVariablesDeclaration` containing all available variables in this CSSStyleSheet including the ones defined in imported sheets.)doccCs|j|dddS)zoAdd `rule` to style sheet at appropriate position. Same as ``insertRule(rule, inOrder=True)``. NT)indexinOrder)rIrr=r$r$r%addszCSSStyleSheet.addcCs|t|tr#t|jD] \}}||kr|}n qtjd|z|j|}Wnt y=tjd||jj fw|j |j krbdd|D}| }|j|vrb||jdkrbtjdd|_|j|=dS)a~Delete rule at `index` from the style sheet. :param index: The `index` of the rule to be removed from the StyleSheet's rule list. For an `index` < 0 **no** :exc:`~xml.dom.IndexSizeErr` is raised but rules for normal Python lists are used. E.g. ``deleteRule(-1)`` removes the last rule in cssRules. `index` may also be a CSSRule object which will then be removed from the StyleSheet. :exceptions: - :exc:`~xml.dom.IndexSizeErr`: Raised if the specified index does not correspond to a rule in the style sheet's rule list. - :exc:`~xml.dom.NamespaceErr`: Raised if removing this rule would result in an invalid StyleSheet - :exc:`~xml.dom.NoModificationAllowedErr`: Raised if this style sheet is readonly. zsz,CSSStyleSheet.deleteRule..rzHCSSStyleSheet: NamespaceURI defined in this rule is used, cannot remove.N)r{ isinstancer enumeraterr]r^ IndexSizeErrr'rlengthr6r7rFr9countZNoModificationAllowedErrrM)rrr<rgr=urisrCr$r$r%r:s<     zCSSStyleSheet.deleteRulec Cs<||durt|j}n|dks||jjkr$tjd||jjft|trt |j |j |j |j |jd}|j|_|j|_|ds`|jr`|jdj|jdjkr`d\}}|jdj|}nd\}}||jf|_t|j|ks{t|j|tjjs|jd|dS|j|}d|_nt|tjjrt|D] \}} | | ||q|S|j!s|jd dS|j|jkr|rd}|jr|jdj|jkr|j"|jd_"n|j#d|n|dks|jr|jdj|jkr|jjd tjj$d dS|j#||n|j|j%|j&fvr6|s6|dkr-|jr-|jdj|jkr-|jjd tjj$d dS|j#||nT|j|j'kr|r|jd d|Dvritt(|jD]\}} | j|jkrft|j|}nqRnb|jr}|jdj|j|j&fvr}d}nNd}nK|dkr|jr|jdj|jkr|jjdtjj$d dS|jd|D]$} | j| j)| j*| j+| j,| j-| j.fvr|jjd|tjj$d dSq|j#|||/n|j|j)kr|r/|jdd|Dvr tt(|jD]\}} | j|jkrt|j|}nqnrt|jD]\}} | j| j*| j+| j,| j-| j.| j%| j&fvr,|}nqnN|j|dD]} | j| j| j'fvrQ|jjd|tjj$d dSq6|jd|D]"} | j| j*| j+| j,| j-| j.fvr{|jjd|tjj$d dSqZ|j0|j1vr|j1|j0|j2ks|j#|||r|3n|j|j*krL|r|jdd|Dvrtt(|jD]\}} | j|jkrt|j|}nqnpt|jD]\}} | j| j+| j,| j-| j.| j%| j&fvr|}nqnN|j|dD]} | j| j| j'| j)fvr|jjd|tjj$d dSq|jd|D] } | j| j+| j,| j-| j.fvr>|jjd|tjj$d dSq|j#|||/n>|r]|j4|t|jd}n-|j|dD]} | j| j| j'| j)fvr|jjd|tjj$d dSqd|j#||||_|j'|jkr|j5s|j |_ |S)a( Used to insert a new rule into the style sheet. The new rule now becomes part of the cascade. :param rule: a parsable DOMString, in cssutils also a :class:`~cssutils.css.CSSRule` or :class:`~cssutils.css.CSSRuleList` :param index: of the rule before the new rule will be inserted. If the specified `index` is equal to the length of the StyleSheet's rule collection, the rule will be added to the end of the style sheet. If `index` is not given or ``None`` rule will be appended to rule list. :param inOrder: if ``True`` the rule will be put to a proper location while ignoring `index` and without raising :exc:`~xml.dom.HierarchyRequestErr`. The resulting index is returned nevertheless. :returns: The index within the style sheet's rule collection :Exceptions: - :exc:`~xml.dom.HierarchyRequestErr`: Raised if the rule cannot be inserted at the specified `index` e.g. if an @import rule is inserted after a standard rule set or other at-rule. - :exc:`~xml.dom.IndexSizeErr`: Raised if the specified `index` is not a valid insertion point. - :exc:`~xml.dom.NoModificationAllowedErr`: Raised if this style sheet is readonly. - :exc:`~xml.dom.SyntaxErr`: Raised if the specified rule has a syntax error and is unparsable. NrzDCSSStyleSheet: Invalid index %s for CSSRuleList with a length of %s.)rrrr r!z@charset)rdr)rrz CSSStyleSheet: Not a CSSRule: %sz-CSSStyleSheet: Invalid rules cannot be added.zKCSSStylesheet: @charset only allowed once at the beginning of a stylesheet.)r\z/CSSStylesheet: @charset must be the first rule.cs|]}|jVqdSrvr6rr$r$r% z+CSSStyleSheet.insertRule..rz)CSSStylesheet: Found @charset at index 0.zwCSSStylesheet: Cannot insert @import here, found @namespace, @variables, @media, @page or CSSStyleRule before index %s.csrrvrrr$r$r%rrzWCSSStylesheet: Cannot insert @namespace here, found @charset or @import after index %s.znCSSStylesheet: Cannot insert @namespace here, found @variables, @media, @page or CSSStyleRule before index %s.csrrvrrr$r$r%rrzcCSSStylesheet: Cannot insert @variables here, found @charset, @import or @namespace after index %s.zbCSSStylesheet: Cannot insert @variables here, found @media, @page or CSSStyleRule before index %s.z^CSSStylesheet: Cannot insert rule here, found @charset, @import or @namespace before index %s.)6r{r5r'rr]r^rrstrrrrrr r!rZ _ownerNoder startswithr6rr[rrrrrrr\rMrrrIr`r/insertr_Z UNKNOWN_RULErXrreversedr7rrBZ PAGE_RULEr@ZFONT_FACE_RULErir8r0r9r>rJZ hrefFound) rr=rrreZ tempsheetZ newrulescountZ newruleindexr<rgr$r$r%rI's"                zCSSStyleSheet.insertRulecCrGrv)rr(r$r$r%rxhrz:A ref to an @import rule if it is imported, else ``None``.cCs&|jD] }t|dr|jsdSqdS)z&Check if each contained rule is valid.validFT)rhasattrrrr$r$r% _getValidls zCSSStyleSheet._getValidz)``True`` if all contained rules are validz3Use ``cssutils.setSerializer(serializer)`` instead.cCst|tjr |t_dStd)z7Set the cssutils global Serializer used for all output.z9Serializer must be an instance of cssutils.CSSSerializer.N)rrZ CSSSerializerrN ValueError)rZ cssserializerr$r$r% setSerializervs  zCSSStyleSheet.setSerializerz+Set pref in ``cssutils.ser.prefs`` instead.cCstjj||dS)zSet a Preference of CSSSerializer used for output. See :class:`cssutils.serialize.Preferences` for possible preferences to be set. N)rrNZprefs __setattr__)rZprefvaluer$r$r%setSerializerPrefszCSSStyleSheet.setSerializerPref) NNr NNNFNT)NNrv)NFT)#r, __module__ __qualname____doc__rr)r.r2r>rFpropertyrsetterrOr}r[rrrrrr/r0rirrr:rIr!rrrrr __classcell__r$r$r"r%rs|$    R   8B   )r__all__Zcssutils.helperrZ cssutils.utilrrZcssrulerZcssvariablesdeclarationrZcssutils.stylesheetsrZxml.domr]Z stylesheetsZ StyleSheetrr$r$r$r%s