cssutils

A CSS Cascading Style Sheets library for Python

These details have not been verified by PyPI

Project links

Project description

Copyright:: 2004-2012 Christof Hoeke

Overview

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.1rev1: General CSS rules and properties are defined here
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
CSS Fonts Module Level 3: Added changes and additional stuff (since cssutils v0.9.6)
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 ;) )
CSS Backgrounds and Borders Module Level 3, CSS3 Basic User Interface Module, CSS Text Level 3: Some validation for properties included, mainly cursor, outline, resize, box-shadow, text-shadow
Variables: Experimental specification of CSS Variables which cssutils implements partly. Media specific variables are not supported.
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) are 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 http://cthedot.de/cssutils/ or https://bitbucket.org/cthedot/cssutils/ for more details.

There is also a low-traffic cssutils discussion group.

Compatibility

cssutils is developed on standard Python but works under Python 2.x (from 2.5, v2.5.4 tested), 3.x (v3.2.2 tested) and Jython (from 2.5.1). IronPython has not been tested yet but might work? Python 2.4 and older are not supported since cssutils 0.9.8 anymore.

License

cssutils is published under the LGPL 3 or later

cssutils is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

cssutils is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with cssutils. If not, see http://www.gnu.org/licenses.

Installation

From 0.9.6 cssutils uses Distribute

After installing Distribute use:

> easy_install cssutils

to install the latest version of cssutils.

Alternatively download the provided source distribution. Expand the file and from a command line install with:

> python setup.py install

To uninstall remove any registrations of cssutils eggs with Distribute and remove the eggs which should be installed at PYTHONDIR/Lib/site-packages/cssutils too.

Example

# -*- coding: utf-8 -*-
import cssutils

css = u'''/* a comment with umlaut &auml; */
     @namespace html "http://www.w3.org/1999/xhtml";
     @variables { BG: #fff }
     html|a { color:red; background: var(BG) }'''
sheet = cssutils.parseString(css)

for rule in sheet:
    if rule.type == rule.STYLE_RULE:
        # find property
        for property in rule.style:
            if property.name == 'color':
                property.value = 'green'
                property.priority = 'IMPORTANT'
                break
        # or simply:
        rule.style['margin'] = '01.0eM' # or: ('1em', 'important')

sheet.encoding = 'ascii'
sheet.namespaces['xhtml'] = 'http://www.w3.org/1999/xhtml'
sheet.namespaces['atom'] = 'http://www.w3.org/2005/Atom'
sheet.add('atom|title {color: #000000 !important}')
sheet.add('@import "sheets/import.css";')

# cssutils.ser.prefs.resolveVariables == True since 0.9.7b2
print sheet.cssText

results in:

@charset "ascii";
@import "sheets/import.css";
/* a comment with umlaut \E4  */
@namespace xhtml "http://www.w3.org/1999/xhtml";
@namespace atom "http://www.w3.org/2005/Atom";
xhtml|a {
    color: green !important;
    background: #fff;
    margin: 1em
    }
atom|title {
    color: #000 !important
    }

Documentation

The current documenation can be found at http://packages.python.org/cssutils/

Kind Request

cssutils is far from being perfect or even complete. If you find any bugs (especially specification violations) or have problems or suggestions please put them in the Issue Tracker at Bitbucket.

Thanks

Thanks to Simon Sapin, Jason R. Coombs and Walter Doerwald for patches, help and discussion. Thanks to Kevin D. Smith for the value validating module. Thanks also to Cory Dodt, Tim Gerla, James Dobson and Amit Moscovich for helpful suggestions and code patches. Thanks to Fredrik Hedman for help on port of encutils to Python 3.

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

2.11.1

Jun 4, 2024

2.11.0

May 14, 2024

2.10.3

May 14, 2024

2.10.2

Mar 31, 2024

2.10.1

Mar 30, 2024

2.10.0

Mar 30, 2024

2.9.0

Oct 12, 2023

2.8.0

Oct 12, 2023

2.7.1

Jun 12, 2023

2.7.0

Jun 9, 2023

2.6.0

Aug 22, 2022

2.5.1

Jul 24, 2022

2.5.0

Jul 12, 2022

2.4.2

Jun 8, 2022

2.4.1

Jun 3, 2022

2.4.0

Feb 23, 2022

2.3.1

Feb 23, 2022

2.3.0

May 24, 2021

2.2.0

Mar 11, 2021

2.1.0

Mar 10, 2021

2.0.0

Mar 9, 2021

1.0.2

Mar 4, 2017

1.0.1

Oct 11, 2015

1.0

Dec 15, 2013

0.9.10

Mar 31, 2013

0.9.10b1 pre-release

Apr 28, 2012

This version

0.9.9

Jan 31, 2012

0.9.8

Dec 10, 2011

0.9.8a3 pre-release

Jul 26, 2011

0.9.8a2 pre-release

Jun 11, 2011

0.9.8a1 pre-release

Dec 12, 2010

0.9.7

Nov 27, 2010

0.9.7b4 pre-release

Nov 1, 2010

0.9.7b3 pre-release

Jun 20, 2010

0.9.7b2 pre-release

Jun 6, 2010

0.9.7b1 pre-release

May 30, 2010

0.9.7a6 pre-release

May 23, 2010

0.9.7a5 pre-release

May 23, 2010

0.9.7a4 pre-release

Mar 23, 2010

0.9.7a3 pre-release

Mar 14, 2010

0.9.7a2 pre-release

Dec 30, 2009

0.9.6

Oct 7, 2009

0.9.6b5 pre-release

Aug 30, 2009

0.9.6b4 pre-release

Aug 29, 2009

0.9.6b3 pre-release

Aug 2, 2009

0.9.6b1 pre-release

Jun 9, 2009

0.9.6a4 pre-release

May 9, 2009

0.9.6a3 pre-release

Apr 26, 2009

0.9.6a2 pre-release

Mar 8, 2009

0.9.6a1 pre-release

Feb 7, 2009

0.9.6a0 pre-release

Dec 14, 2008

0.9.5.1

Aug 11, 2008

0.9.5

Jul 30, 2008

0.9.5rc2 pre-release

Jul 14, 2008

0.9.5rc1 pre-release

Jul 9, 2008

0.9.5b3 pre-release

Jun 5, 2008

0.9.5b2 pre-release

Mar 23, 2008

0.9.5b1 pre-release

Mar 19, 2008

0.9.5a4 pre-release

Feb 22, 2008

0.9.5a3 pre-release

Feb 3, 2008

0.9.5a2 pre-release

Jan 15, 2008

0.9.5a1 pre-release

Jan 13, 2008

0.9.4b1 pre-release

Dec 29, 2007

0.9.4a4 pre-release

Dec 2, 2007

0.9.4a3 pre-release

Nov 6, 2007

0.9.4a2 pre-release

Oct 27, 2007

0.9.3a1 pre-release

Sep 5, 2007

0.9.2b3 pre-release

Aug 4, 2007

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.