what is it

A CSS Cascading Style Sheets library for Python.

Partly implements the DOM Level 2 Style Stylesheets and CSS interfaces. An implementation of the WD CSS Module: Namespaces which has no official DOM yet is included since v0.9.1.

changes since 0.9.2b4

for full details see the relevant README file http://cssutils.googlecode.com/svn/tags/TAG_0.9.3a1/README.txt

Lots of thanks to Walter Dörwald who had quite an influence on this release (thinking, helping, coding).

from the README:

 - FEATURE: Implemented css.CSSValue, css.CSSPrimitiveValue and 

css.CSSValueList.

     Not yet implemented are:
         - css.CSSPrimitiveValue.getCounterValue and css. Counter
         - css.CSSPrimitiveValue.getRGBColorValue and css.RGBColor
         - css.CSSPrimitiveValue.getRectValue and css.Rect

     + FEATURE: css.CSSValueList is iterable so may be used in a for 

loop

     + FEATURE: CSSValue has property ``cssValueTypeString`` which 

is the name of the relevant cssValueType, e.g. "CSS_PRIMITIVE_TYPE". Mainly useful for debugging.

     + FEATURE: CSSPrimitiveValue has property 

primitiveTypeString which is the name of the relevant primitiveType, e.g. "CSS_PX". Mainly useful for debugging.

     + CSSValue has an init Parameter ``_propertyname`` to set a 

context property for validation. If none is set the value is always invalid. THIS MAY CHANGE!

 - FEATURE (**experimental**): CSSStyleDeclaration is iterable now. 

The iterator returns all properties set in this style as objects with properties name, cssValue and priority. Calling CSSStyleDeclaration.item(index) on the other hand simply returns a property name and also only the normalized name (once). Example::

         sheet = cssutils.parseString('a { color: red; c\olor: blue; 

left: 0 !important }') for rule in sheet.cssRules: style = rule.style for property in style: name = property.name cssValue = property.cssValue priority = property.priority print name, '=', cssValue.cssText, priority

             # prints:
             # color = red
             # c\olor = blue
             # left = 0 !important

             for i in range(0, style.length):
                 name = style.item(i)
                 cssValue = style.getPropertyCSSValue(name)
                 priority = style.getPropertyPriority(name)
                 print name, '=', cssValue.cssText , priority

             # prints:
             # color = blue
             # left = 0 !important

 - FEATURE (**experimental**): added 

CSSStyleSheet.replaceUrls(replacer) which may be used to adjust all "url()" values in a style sheet (currently in CSSStyleDeclaration and CSSImportRules).

 - FEATURE: added ``CSSStyleDeclaration.getCssText(separator=None)`` 

which returns serialized property cssText, each property separated by given separator which may e.g. be u'' to be able to use cssText directly in an HTML style attribute. ";" is always part of each property (except the last one) and can not be set with separator!

 - FEATURE: ``href`` and ``media`` arguments can now be passed to 

parse() and parseString() functions and methods. This sets the appropriate attributes on the generated stylesheet objects.

 - FEATURE: CSSMediaRule has an init parameter ``mediaText`` 

synchronous to CSSImportRule now

 - FEATURE: The ``MediaList`` constructor can now be passed a list 

of media types.

 - FEATURE: ``CSSRule`` and subclasses have a property 

typeString which is the name of the relevant type, e.g. STYLE_RULE. Mainly useful for debugging.

 - FEATURE: ``cssutils.serialize.Preferences`` has a new option 

lineSeparator that is used as linefeed character(s). May also be set to u'' for CSSStyleDeclareation.cssText' to be directly usable in e.g. HTML style attributes

 + API CHANGE (internal): renamed serializers method 

do_stylesheet to do_CSSStyleSheet

 - BUGFIX (issue #9): Parsing of empty ``url()`` values has been fixed
 - BUGFIX: Handling of linenumbers in the serializer has been fixed.
 - BUGFIX (minor): removed debug output in CSSStyleDeclaration

 + CHANGE (experimental!): CSSStyleDeclaration.getPropertyCSSValue() 

for shorthand properties like e.g. background should return None. cssutils returns a CSSValueList in these cases now. Use with care as this may change later

 + CHANGE: CSSValue default cssText is now ``u""`` and not 

u"inherit" anymore

 + CHANGE: ``css.CSSStyleDeclaration.cssText`` indents its property 

not anymore.

 + CHANGE: ``cssutils.serialize.CSSSerializer`` has been refactored 

internally to support the lineSeparator option.

 + CHANGE: The Selector and SameNamePropertyList (which might be 

renamed as it is experimental) class are now available from cssutils.css too.

 + CHANGE: Tokenizer strips HTML comment tokens CDO and CDC from 

tokenlist now.

 + CHANGE: Added __repr__ and __str__ methods to most classes. 

__str__ reports e.g. <cssutils.css.CSSImportRule object href=None at 0xaaa870>, __repr__ e.g. cssutils.css.CSSImportRule(href=None, mediaText=u'all') which is a valid contructor for the object in most cases (which might not be complete for all init parameter for all classes like in this case though). The following details are included:

   css
     - CSSStyleSheet shows the title and href
     - CSSCharsetRule shows the encoding
     - CSSCharsetRule shows the cssText (not in __str__ though)
     - CSSImportRule shows the href and the MediaList mediaText
     - CSSMediaRule shows the MediaList mediaText
     - CSSNameSpaceRule shows the prefix and uri
     - CSSPageRule shows the selectorText
     - CSSStyleRule shows the selectorText
     - CSSUnknownRule shows nothing special
     - CSSStyleDeclaration shows the number of properties set for 

__str__ but an empty CSSStyleDeclaration constructor for __repr__ as showing cssText might be way too much

     - SameNamePropertyList shows the name
     - CSSValue, CSSPrimitiveValue show the actual value for 

__repr__, some details for __str__

     - CSSValueList shows an __repr__ which is **not** possible to 

eval() and some details for __str__

     - _Property shows infos but should be used directly for now anyway!
     - Selector the selectorText

   stylesheets
     - MediaList shows the mediaText

license

cssutils is published under the LGPL.

download

for download options for cssutils 0.9.3a1 - 070905 see http://cthedot.de/cssutils/

cssutils needs

• Python 2.4 or higher (tested with Python 2.5 on Windows XP only)

bug reports, comments, etc are very much appreciated, (please use http://code.google.com/p/cssutils/).

thanks christof