Skip to main content

A CSS Cascading Style Sheets library for Python

Project description

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 | RSS feed

Download files

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

Source Distribution

cssutils-0.9.6b3.zip (575.4 kB view details)

Uploaded Source

Built Distributions

cssutils-0.9.6b3.win32.exe (440.6 kB view details)

Uploaded Source

cssutils-0.9.6b3-py2.6.egg (537.7 kB view details)

Uploaded Egg

cssutils-0.9.6b3-py2.5.egg (538.4 kB view details)

Uploaded Egg

cssutils-0.9.6b3-py2.4.egg (539.7 kB view details)

Uploaded Egg

File details

Details for the file cssutils-0.9.6b3.zip.

File metadata

  • Download URL: cssutils-0.9.6b3.zip
  • Upload date:
  • Size: 575.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for cssutils-0.9.6b3.zip
Algorithm Hash digest
SHA256 ff957886ba4b21eb8cdcdb93f46f5f0efaa41ebc4c231dab9679aaa6d7d4855d
MD5 c9dc89d4906a34db2cc42954c978623a
BLAKE2b-256 72c7e96942fdaf18c6cadf0daed7ca5094a9e9fbbe36093a5726428165547942

See more details on using hashes here.

File details

Details for the file cssutils-0.9.6b3.win32.exe.

File metadata

  • Download URL: cssutils-0.9.6b3.win32.exe
  • Upload date:
  • Size: 440.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for cssutils-0.9.6b3.win32.exe
Algorithm Hash digest
SHA256 3eec937cfe22b1cbd1a66bce210e7efe31bf913719a08e81a2ca78d7db1995fb
MD5 c28108c0f837bf3a2036fa3604c92581
BLAKE2b-256 9a39c1a485385afd0fd5538f00886266a70a2f9f88de0433fe40fc61f86e6bf5

See more details on using hashes here.

File details

Details for the file cssutils-0.9.6b3-py2.6.egg.

File metadata

  • Download URL: cssutils-0.9.6b3-py2.6.egg
  • Upload date:
  • Size: 537.7 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for cssutils-0.9.6b3-py2.6.egg
Algorithm Hash digest
SHA256 9ad22cb7586978379efa26e950f576ccc11a35da8bc9b7bf52a526480c11e40f
MD5 2fb50038cd1309be4513c45887e80996
BLAKE2b-256 660188c19c39b49605867b86667372746c186dcfc82fb23279fa02d78999a0aa

See more details on using hashes here.

File details

Details for the file cssutils-0.9.6b3-py2.5.egg.

File metadata

  • Download URL: cssutils-0.9.6b3-py2.5.egg
  • Upload date:
  • Size: 538.4 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for cssutils-0.9.6b3-py2.5.egg
Algorithm Hash digest
SHA256 19d2b114439ca78822a688bacca804f6cde3f4f9b67a5352a70195b45022c67f
MD5 229d40b1a902fe8135dc6d08bd2de454
BLAKE2b-256 b7995d11afe42632a6f121e2fb791b368dd91fd9f0efc14b5cfca7c9915b8177

See more details on using hashes here.

File details

Details for the file cssutils-0.9.6b3-py2.4.egg.

File metadata

  • Download URL: cssutils-0.9.6b3-py2.4.egg
  • Upload date:
  • Size: 539.7 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for cssutils-0.9.6b3-py2.4.egg
Algorithm Hash digest
SHA256 f973cef5626b20b5f26cf9f02e095636e1c878e603b62adc9bb33d35ec9ecd03
MD5 74242de723c18dddfacafb93783c3f02
BLAKE2b-256 0cc17e25836d2b998929df50e539e5f4935d08f3c1b7c42125946ecad3bd23c9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page