Skip to main content

A CSS Cascading Style Sheets library for Python

Project description

https://img.shields.io/pypi/v/cssutils.svg https://img.shields.io/pypi/pyversions/cssutils.svg tests Ruff https://readthedocs.org/projects/cssutils/badge/?version=latest https://img.shields.io/badge/skeleton-2024-informational https://tidelift.com/badges/package/pypi/cssutils

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 / CSS Custom Properties

Experimental specification of CSS Variables which cssutils implements partly. The vars defined in the newer CSS Custom Properties spec should in main parts be at least parsable with cssutils.

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.

Compatibility

cssutils is developed on modern Python versions. Check the package metadata for compatibilty.

Beware, cssutils is known to be thread unsafe.

Example

import cssutils

css = '''/* a comment with umlaut ä */
     @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
    }

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.

Thanks

Special thanks to Christof Höke for seminal creation of the library.

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.

For Enterprise

Available as part of the Tidelift Subscription.

This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use.

Learn more.

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-2.11.0.tar.gz (723.2 kB view details)

Uploaded Source

Built Distribution

cssutils-2.11.0-py3-none-any.whl (398.2 kB view details)

Uploaded Python 3

File details

Details for the file cssutils-2.11.0.tar.gz.

File metadata

  • Download URL: cssutils-2.11.0.tar.gz
  • Upload date:
  • Size: 723.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for cssutils-2.11.0.tar.gz
Algorithm Hash digest
SHA256 cd24a30b9a848ca92d80f0d1b362139c0b69de31394d585dbf1b17a5dc4aa627
MD5 96df4778e530343de96fbb7c303e4154
BLAKE2b-256 98e105a20aeed8da4c5f522fe9777fbcc85173318d1cd8413daef91b79fa0567

See more details on using hashes here.

Provenance

File details

Details for the file cssutils-2.11.0-py3-none-any.whl.

File metadata

  • Download URL: cssutils-2.11.0-py3-none-any.whl
  • Upload date:
  • Size: 398.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for cssutils-2.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 220816dc6d413e81281bbd568c473a8ae28f73b1af008b1bacf3a7ebd21e0334
MD5 9efc10c09240c8876b78e2ea29cb627f
BLAKE2b-256 97679a7e56eedd2177f468efe17cfb96eda89aa65daabb472d77f4040e585cb9

See more details on using hashes here.

Provenance

Supported by

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