o
/hm6 @ sr d Z ddlZddlZddlZddlZddlZddlZ ddl
m Z m Z m
Z
ddlmZ ddlmZ ddlmZ g dZe Ze Zeed Zd
ZG d d d Ze j d
e dd Z e dZ e dZ e dZ e dZ!dd Z"dd Z#dd Z$dd Z%ej&j'Z(ej)d,d d Z*e*+e j,d,d d Z-G d!d" d"Z.d-d#d$Z/G d%d& d&e0Z1d'd( Z2d)d* Z3e4d+kre5e dS dS ).aD
CSS Cascading Style Sheets library for Python
A Python package to parse and build CSS Cascading Style Sheets. DOM only, not
any rendering facilities!
Based upon and partly implementing the following specifications :
`CSS 2.1 `__
General CSS rules and properties are defined here
`CSS 2.1 Errata
`__
A few errata, mainly the definition of CHARSET_SYM tokens
`CSS3 Module: Syntax `__
Used in parts since cssutils 0.9.4. cssutils tries to use the features from
CSS 2.1 and CSS 3 with preference to CSS3 but as this is not final yet some
parts are from CSS 2.1
`MediaQueries `__
MediaQueries are part of ``stylesheets.MediaList`` since v0.9.4, used in
@import and @media rules.
`Namespaces `__
Added in v0.9.1, updated to definition in CSSOM in v0.9.4, updated in 0.9.5
for dev version
`CSS3 Module: Pages Media `__
Most properties of this spec are implemented including MarginRules
`Selectors `__
The selector syntax defined here (and not in CSS 2.1) should be parsable
with cssutils (*should* mind though ;) )
`DOM Level 2 Style CSS `__
DOM for package css. 0.9.8 removes support for CSSValue and related API,
see PropertyValue and Value API for now
`DOM Level 2 Style Stylesheets
`__
DOM for package stylesheets
`CSSOM `__
A few details (mainly the NamespaceRule DOM) is taken from here. Plan is
to move implementation to the stuff defined here which is newer but still
no REC so might change anytime...
The cssutils tokenizer is a customized implementation of `CSS3 Module: Syntax
(W3C Working Draft 13 August 2003) `__ which
itself is based on the CSS 2.1 tokenizer. It tries to be as compliant as
possible but uses some (helpful) parts of the CSS 2.1 tokenizer.
I guess cssutils is neither CSS 2.1 nor CSS 3 compliant but tries to at least
be able to parse both grammars including some more real world cases (some CSS
hacks are actually parsed and serialized). Both official grammars are not final
nor bugfree but still feasible. cssutils aim is not to be fully compliant to
any CSS specification (the specifications seem to be in a constant flow anyway)
but cssutils *should* be able to read and write as many as possible CSS
stylesheets "in the wild" while at the same time implement the official APIs
which are well documented. Some minor extensions are provided as well.
Please visit https://cssutils.readthedocs.io/ for more details.
Example::
>>> from cssutils import CSSParser
>>> parser = CSSParser()
>>> sheet = parser.parseString('a { color: red}')
# TODO: shouldn't have to decode here
>>> print(sheet.cssText.decode())
a {
color: red
}
N )css errorhandler stylesheets) CSSParser)Profiles)
CSSSerializer)r r r r )logc @ s8 e Zd ZdZg dZdd Zdd Zdd Zd d
Zd S ) DOMImplementationCSSad This interface allows the DOM user to create a CSSStyleSheet
outside the context of a document. There is no way to associate
the new CSSStyleSheet with a document in DOM Level 2.
This class is its *own factory*, as it is given to
xml.dom.registerDOMImplementation which simply calls it and receives
an instance of this class then.
))r 1.0)r 2.0)r r )r r
c C s* ddl }d}|j|tdd tj||dS )a(
Creates a new CSSStyleSheet.
title of type DOMString
The advisory title. See also the Style Sheet Interfaces
section.
media of type DOMString
The comma-separated list of media associated with the new style
sheet. See also the Style Sheet Interfaces section.
returns
CSSStyleSheet: A new CSS style sheet.
TODO: DOMException
SYNTAX_ERR: Raised if the specified media string value has a
syntax error and is unparsable.
r Nz|Deprecated, see https://web.archive.org/web/20200701035537/https://bitbucket.org/cthedot/cssutils/issues/69#comment-30669799 )
stacklevel)titlemedia)warningswarnDeprecationWarningr
CSSStyleSheet)selfr r r warning r E/var/www/html/myenv/lib/python3.10/site-packages/cssutils/__init__.pycreateCSSStyleSheeto s
z(DOMImplementationCSS.createCSSStyleSheetc O & dd l m m} | j|i |S Nr )xml.dom.minidomdomminidomDOMImplementationcreateDocumentr argskwargsr r r r r! z#DOMImplementationCSS.createDocumentc O r r )r r r r createDocumentTyper" r r r r& r% z'DOMImplementationCSS.createDocumentTypec C s | t|f| jv S N)lowerstr _features)r featureversionr r r
hasFeature z DOMImplementationCSS.hasFeatureN) __name__
__module__ __qualname____doc__r* r r! r& r- r r r r r ^ s r cssutilsc s* fdd}t t j|_ |_|_|S )Nc s t t | i |S r' )getattrr )r# r$ namer r func r. z _parser_redirect..func)r4 r r2 r1 r/ )r6 r7 r r5 r _parser_redirect s r8 parseString parseFileparseUrl
parseStylec C s t j| d dS )z8Set the global serializer used by all class in cssutils.)serN)globalsupdate)
serializerr r r
setSerializer s rA c c s< t | ddD ] }t|E dH qt| dr | jV dS dS )z4
Recursively find all CSSStyleDeclarations.
cssRulesr Nstyle)r4 _style_declarationshasattrrC )baseruler r r rD s
rD c C s, dd | D }dd t | D }t||S )ax Retrieve all ``url(urlstring)`` values (in e.g.
:class:`cssutils.css.CSSImportRule` or ``cssutils.css.CSSValue``
objects of given `sheet`.
:param sheet:
:class:`cssutils.css.CSSStyleSheet` object whose URLs are yielded
This function is a generator. The generated URL values exclude ``url(`` and
``)`` and surrounding single or double quotes.
c s s" | ] }|j |jkr|jV qd S r' )type IMPORT_RULEhref.0rG r r r s zgetUrls..c s s$ | ]
}t |D ]}|jV qqd S r' _uri_valuesuri)rL rC valuer r r rM s )rD itertoolschain)sheetimportsotherr r r getUrls s
rW c C s dd | j ddD S )Nc s s* | ]}|j D ]
}|jd kr|V qqdS )URIN)
propertyValuerH )rL proprQ r r r rM s
z _uri_values..T)all)
getProperties)rC r r r rO s
rO Fc sP fdd| D }|D ]}||j |_ q tttt| D ]}||j|_q dS )a
Replace all URLs in :class:`cssutils.css.CSSImportRule` or
``cssutils.css.CSSValue`` objects of given `sheet`.
:param sheet:
a :class:`cssutils.css.CSSStyleSheet` to be modified in place.
:param replacer:
a function which is called with a single argument `url` which
is the current value of each url() excluding ``url(``, ``)`` and
surrounding (single or double) quotes.
:param ignoreImportRules:
if ``True`` does not call `replacer` with URLs from @import rules.
c 3 s$ | ]
}|j |jkr s|V qd S r' )rH rI rK ignoreImportRulesr r rM s z replaceUrls..N)rJ _flattenmaprO rD rP )rT replacerr^ rU rG rQ r r] r replaceUrls s
rb c C s t | D ]}||j|_qdS )a Replace all URLs in :class:`cssutils.css.CSSImportRule` or
:class:`cssutils.css.CSSValue` objects of given `style`.
:param style:
a :class:`cssutils.css.CSSStyleDeclaration` to be modified in place.
:param replacer:
a function which is called with a single argument `url` which
is the current value of each url() excluding ``url(``, ``)`` and
surrounding (single or double) quotes.
:param ignoreImportRules:
not applicable, ignored.
NrN )rC ra r^ rQ r r r _ s rc c @ s, e Zd ZdZdd Zdd Zedd ZdS ) Replacerz<
A replacer that uses base to return adjusted URLs.
c C s | || _d S r' ) extract_baserF )r rF r r r __init__ s zReplacer.__init__c C sb t j|\}}}}}|s|s|dr|S tj|\}}tjtj| j ||}t j
|S )N/) urllibparseurlsplit
startswithospathsplitnormpathjoinrF request pathname2url) r rP schemelocationrm queryfragmentfilenamecombinedr r r __call__ s zReplacer.__call__c C s* t j| \}}}}}tj|\}}|S r' )rh ri rj rl rm rn )rP rc raw_path base_pathr r r re " s zReplacer.extract_baseN)r/ r0 r1 r2 rf ry staticmethodre r r r r rd s
rd c C sZ |s
t j| j| j| jd}| jD ]}|j|jkrq|j|jkr%t || q|
| q|S )a
Recursively combine all rules in given `sheet` into a `target` sheet.
Attempts to wrap @import rules that use media information into
@media rules, keeping the media information. This approach may not work in
all instances (e.g. if an @import rule itself contains an @import rule
with different media infos or if it contains rules that may not be
used inside an @media block like @namespace rules). In these cases,
the @import rule from the original sheet takes precedence and a WARNING
is issued.
:param sheet:
:class:`cssutils.css.CSSStyleSheet` from which all import rules are
resolved and added to a resulting *flat* sheet.
:param target:
A :class:`cssutils.css.CSSStyleSheet` object that will be the
resulting *flat* sheet if given.
:returns:
:class:`cssutils.css.CSSStyleSheet` with imports resolved.
)rJ r r ) r r rJ r r rB rH CHARSET_RULErI _resolve_importadd)rT targetrG r r r resolveImports) s
r c @ s, e Zd Zedd Zedd Zdd ZdS )MediaCombineDisallowedc C s" t t| j|}|r| |dS )zM
Check if rules present that may not be combined with media.
N)listrR filterfalse _combinable)clsrT failedr r r checkN s z MediaCombineDisallowed.checkc C s
| j d S r )r# )r r r r r W s
z MediaCombineDisallowed.failedc C s | j | j| jf}| j|v S r' )COMMENT
STYLE_RULErI rH )rG
combinabler r r r [ s
z"MediaCombineDisallowed._combinableN)r/ r0 r1 classmethodr propertyr r r r r r r M s
r c
C sf t jd| j dd | js t jd| j dd || d S |tjd| j d zt| j }W n# t
j j yT } zt j
d| dd || W Y d }~d S d }~ww t jd| j dd t|t| jdd zt| |}W n) ty } z t j
d
|jd d | j dd || W Y d }~d S d }~ww |p|}|D ]}|| q|r|| d S d S )
NzProcessing @import %rT
neverraisez1Cannot get referenced stylesheet %r, keeping rulez/* START @import "%s" */)cssTextz0@import: Cannot resolve target, keeping rule: %sz @import: Adjusting paths for %rr] zaCannot combine imported sheet with given media as rules other than comments or stylerules; found r z
, keeping )r inforJ hrefFounderrorr r
CSSCommentr
styleSheetxmlr HierarchyRequestErrr rb rd _check_media_proxyr r r )rG r
importedSheete media_proxyexc
imp_targetrr r r r~ ` sV
r~ c C s@ | j jdkrd S t| tjd| j j dd t| j jS )Nr[ z7@import: Wrapping some rules in @media to keep media: Tr )r mediaTextr r r r r CSSMediaRule)rG r r r r r s
r __main__)Fr' )6r2 functoolsrR os.pathrl urllib.parserh urllib.requestxml.domr r r r ri r profilesr serializer __all__ ErrorHandlerr r= profile_ANYNSr r registerDOMImplementationr8 r9 r: r; r< rA rD rW rO rS
from_iterabler_ singledispatchrb registerCSSStyleDeclarationrc rd r Exceptionr r~ r r/ printr r r r sP G
C
$1