Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

A CSS Cascading Style Sheets library for Python

Project description

Copyright: 2004-2009 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
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
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 http://cthedot.de/cssutils/ or http://code.google.com/p/cssutils/ for more details.

There is also a low-traffic cssutils discussion group.

compatibility

cssutils is developed on standard Python. On Jython 2.5 (from RC4 on) cssutils (from 0.9.6b1) also passes all tests.

license

Copyright 2005 - 2009 Christof Hoeke

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.0 cssutils uses EasyInstall. Please find installation instructions and more information about EasyInstall from http://peak.telecommunity.com/DevCenter/EasyInstall#installation-instructions.

After installing EasyInstall simply 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

Before using EasyInstall the first time or using the sdist please remove any old version which should be installed at PYTHONDIR/Lib/site-packages/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 Google.

thanks

Thanks to Walter Doerwald for patches, help and discussion. Thanks to Kevin D. Smith for the value validating module. Thanks also to Cory Dodt, Tim Gerla and James Dobson for helpful suggestions and code patches.

Project details


Release history Release notifications

History Node

1.0.2

History Node

1.0.1

History Node

1.0

History Node

0.9.10

History Node

0.9.10b1

History Node

0.9.9

History Node

0.9.8

History Node

0.9.8a3

History Node

0.9.8a2

History Node

0.9.8a1

History Node

0.9.7

History Node

0.9.7b4

History Node

0.9.7b3

History Node

0.9.7b2

History Node

0.9.7b1

History Node

0.9.7a6

History Node

0.9.7a5

History Node

0.9.7a4

History Node

0.9.7a3

History Node

0.9.7a2

History Node

0.9.6

History Node

0.9.6b5

History Node

0.9.6b4

This version
History Node

0.9.6b3

History Node

0.9.6b1

History Node

0.9.6a4

History Node

0.9.6a3

History Node

0.9.6a2

History Node

0.9.6a1

History Node

0.9.6a0

History Node

0.9.5.1

History Node

0.9.5

History Node

0.9.5rc2

History Node

0.9.5rc1

History Node

0.9.5b3

History Node

0.9.5b2

History Node

0.9.5b1

History Node

0.9.5a4

History Node

0.9.5a3

History Node

0.9.5a2

History Node

0.9.5a1

History Node

0.9.4b1

History Node

0.9.4a4

History Node

0.9.4a3

History Node

0.9.4a2

History Node

0.9.3a1

History Node

0.9.2b3

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
cssutils-0.9.6b3-py2.4.egg (539.7 kB) Copy SHA256 hash SHA256 Egg 2.4 Aug 2, 2009
cssutils-0.9.6b3-py2.5.egg (538.4 kB) Copy SHA256 hash SHA256 Egg 2.5 Aug 2, 2009
cssutils-0.9.6b3-py2.6.egg (537.7 kB) Copy SHA256 hash SHA256 Egg 2.6 Aug 2, 2009
cssutils-0.9.6b3.win32.exe (440.6 kB) Copy SHA256 hash SHA256 Windows Installer any Aug 2, 2009
cssutils-0.9.6b3.zip (575.4 kB) Copy SHA256 hash SHA256 Source None Aug 2, 2009

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page