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 ;) )

Variables

Experimental specification of CSS Variables. Currently in development in cssutils.

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. Since 0.9.6 all tests pass on Jython (2.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 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.7a4.zip (557.8 kB view details)

Uploaded Source

Built Distributions

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

Uploaded Source

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

Uploaded Egg

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

Uploaded Egg

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

Uploaded Egg

File details

Details for the file cssutils-0.9.7a4.zip.

File metadata

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

File hashes

Hashes for cssutils-0.9.7a4.zip
Algorithm Hash digest
SHA256 0c1e32af8476df5851e93043de048520b256e1d29e5799099b2585665dad4ff4
MD5 db34b0b975e0ccc59b116d56ed934dee
BLAKE2b-256 9e786899ad2271a5e24f5729d1e8d7fa622d8a9a2324cb1e379716793aa9025e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for cssutils-0.9.7a4.win-amd64.exe
Algorithm Hash digest
SHA256 d2bbe6be18122e3cc6092e90a8dfe476e971cff1b00a7449bbe6328fad65bb7c
MD5 a17e778d8d91962d548133b186301277
BLAKE2b-256 b0d5324f1e723885b735ed9b3e950310f93bd1bd5b75d7b6ebbea59b97d329b4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for cssutils-0.9.7a4-py2.6.egg
Algorithm Hash digest
SHA256 f5de25973ccd4875d575a36c8645253304e692cc9a65fcf99a5ae2c52b3afc50
MD5 44f12031bca99016f508e89d3ef59c81
BLAKE2b-256 f41aee877d471814be1efa027917deca79358c0719de4b9bad4d2e564fdc1b48

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for cssutils-0.9.7a4-py2.5.egg
Algorithm Hash digest
SHA256 694ebb04c7cac7fb5785a41d3106546837e289524befe8a0defbb807809fac15
MD5 5afa0d3d6b960ac3c03aede9159db387
BLAKE2b-256 75f9d457228bfea8b9508f91bec5730190f508980aabd5b9796ffc18f5bfa393

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for cssutils-0.9.7a4-py2.4.egg
Algorithm Hash digest
SHA256 003d186d1e51ec8e1d3fdc635973d913f91b3095a939a170aa8945a53829dd3a
MD5 088cd34b35dd432a3d54a7030b6f550f
BLAKE2b-256 6b99a63232584ea8234ccbfe7f2946efc7d180c9a27b70ad7686875fccd57215

See more details on using hashes here.

Supported by

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