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

CSS3 Module: Pages Media

Most properties of this spec are implemented and the additional @rules should at least parse (as CSSUnknownRule)

Selectors

The selector syntax defined here (and not in CSS 2.1) should be parsable with cssutils (should mind though ;) )

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

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 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. Since 0.9.6 all tests pass on Jython (from v2.5.1) too.

License

Copyright 2005 - 2010 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.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.

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 Jason R. Coombs, Cory Dodt, Tim Gerla, James Dobson and Amit Moscovich 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.7.zip (447.7 kB view details)

Uploaded Source

Built Distributions

cssutils-0.9.7.win-amd64.exe (401.4 kB view details)

Uploaded Source

cssutils-0.9.7-py2.7.egg (360.7 kB view details)

Uploaded Egg

cssutils-0.9.7-py2.6.egg (361.4 kB view details)

Uploaded Egg

cssutils-0.9.7-py2.5.egg (361.6 kB view details)

Uploaded Egg

cssutils-0.9.7-py2.4.egg (359.3 kB view details)

Uploaded Egg

File details

Details for the file cssutils-0.9.7.zip.

File metadata

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

File hashes

Hashes for cssutils-0.9.7.zip
Algorithm Hash digest
SHA256 2160d5a183862f3a91734f22391e937ff9accf115fd767705577ddd7ddbcb38b
MD5 69e93d7edb30365dd6712d62df0850ed
BLAKE2b-256 23fa1fdc0ab33c23d39552473263751c5b4aa484452493411faaaea39d4fe633

See more details on using hashes here.

File details

Details for the file cssutils-0.9.7.win-amd64.exe.

File metadata

File hashes

Hashes for cssutils-0.9.7.win-amd64.exe
Algorithm Hash digest
SHA256 4513bcae431429d2ec5b308b7588055808ef310d87109445a94a8dcd45d22ed6
MD5 1b84cc88c97998570d220fc806359497
BLAKE2b-256 b594a7045720d3321a00acb8510e0a3751fc11a9dfa97d8d4a987ffacee096ba

See more details on using hashes here.

File details

Details for the file cssutils-0.9.7-py2.7.egg.

File metadata

  • Download URL: cssutils-0.9.7-py2.7.egg
  • Upload date:
  • Size: 360.7 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for cssutils-0.9.7-py2.7.egg
Algorithm Hash digest
SHA256 9be935b968312ea8bbfa37c15eb684ebf113074675bc74945083a2bd281acdc6
MD5 20d3580188f038b48501c4ad8c6d0087
BLAKE2b-256 ae3fc1689085ed9f3ff1bd84d01f672f4cfb9f3c517371c925274ac06dc34359

See more details on using hashes here.

File details

Details for the file cssutils-0.9.7-py2.6.egg.

File metadata

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

File hashes

Hashes for cssutils-0.9.7-py2.6.egg
Algorithm Hash digest
SHA256 03c7c91ff55cb3acbf9894a7cab4440e6930b20bc9223951b4792b590f590c29
MD5 6fc9ef19579645a97d3f7c028f35d54c
BLAKE2b-256 90092200ed7c7a67083d4bf519e02fc6bba7be23af8752b2a1fd3a59f8cd2f6c

See more details on using hashes here.

File details

Details for the file cssutils-0.9.7-py2.5.egg.

File metadata

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

File hashes

Hashes for cssutils-0.9.7-py2.5.egg
Algorithm Hash digest
SHA256 49c20e91a5df54acedae1eb89e7963970e90dfa42fab913bdcf71a81cbbc031b
MD5 d4e0c450ca5f9e701e73f8eb114655c7
BLAKE2b-256 288b5ff2ca827138c8557cd41cdbee278ca010b908ff2405ce230f17d78d0640

See more details on using hashes here.

File details

Details for the file cssutils-0.9.7-py2.4.egg.

File metadata

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

File hashes

Hashes for cssutils-0.9.7-py2.4.egg
Algorithm Hash digest
SHA256 81687fc87bb48a5c0cb550df8ca56270ac4014d4e2c024d56dd3f7058d241cfd
MD5 c618a378b6b235955ff578777884f476
BLAKE2b-256 12ce8e1107eecc82d39c7a101b59a253399d89fd66a659a3af98d4b29ac768f3

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