what is it
----------
A Python package to parse and build CSS Cascading Style Sheets. (Not a
renderer though!)
As there have been quite a few bugfixes and also some minor changes this
is a release candidate and not the final release yet.
main changes
------------
0.9.5rc1 080709
- **API CHANGE/FEATURE**: ``The cssutils.log`` may be partly used
like a standard logging log. The following methods are available:
('setLevel', 'getEffectiveLevel', 'addHandler', 'removeHandler') as well
as all "messaging" calls like 'error', 'warning' etc.
Therefor ``cssutils.log.setloglevel`` has been *DEPRECATED* and
should be used via ``cssutils.log.setLevel``. The old method is still
available though.
``cssutils.log.setlog`` has been renamed to
``cssutils.log.setLog`` but is still available but *DEPRECATED* too.
- **FEATURE**: All three decoders in the codec now have an
additional ``force`` argument. If ``force`` is false, the encoding from
the input will only by used if is is detected explicitely via BOM or
@charset rule.
- **FEATURE**: ``cssparse`` script has new option ``-m --minify``
which results in the parsed CSS to be serialized minified
- **FEATURE**: ``CSSCapture`` and ``csscombine`` are now available
not only as standalone scripts but also via
``cssutils.script.CSSCapture`` and ``cssutils.script.csscombine``
repectively so you can use them programmatically now.
- **BUGFIX**: A space after @rule keyword is added when serializing
minified something like [EMAIL PROTECTED] all{}``. Until now it was
[EMAIL PROTECTED] which is recognized by Safari only and may not be valid
at all.
- **BUGFIX**: Properties of rules set via ``css.CSSStyleSheet.add``
or ``.insert`` were not set properly, e.g. ``parentStyleSheet`` or the
stylesheet handling of new @import rules was buggy.
- BUGFIX: Encountering OSError during resolving @import does not
throw an error anymore but the resulting CSSImportRule.styleSheet will
have a value of ``None``. OSError will probably only happen when using
``parseFile``.
- **BUGFIX/IMPROVEMENT**: A style sheet with ``href == None`` (e.g.
parsed with ``parseString()`` or build completely from scratch) uses
``os.getcwd()`` as its base href now to be able to resolve CSSImportRules.
- **BUGFIX/IMPROVEMENT**: Rewrote ``csscombine`` script which
should be much more stable now and handles namespaces correctly. Nested
imports are still not resolved yet but this may come in the next release.
- BUGFIX/IMPROVEMENT: Added catching of WindowsError to default
fetcher (e.g. is a file URL references a file not present).
- **BUGFIX/CHANGE**: Redone ``csscapture`` script. A few minor
method changes (parameter ``ua`` of ``capture`` has been replaced by
init parameter) and lots of internal improvement has been done.
- CHANGE: ``CSSStyleSheet.add(rule)`` simply appends rules with no
specific order in the sheet to the end of it. So e.g. COMMENTs,
STYLE_RULEs, etc are appended while rules with a specific place are
ordered-in as before (e.g. IMPORT_RULE or NAMESPACE_RULE). Until now
rules of a specific type like COMMENTs were ordered together which does
not really make sense. The ``csscombine`` script needs this
functionality and the resulting combined sheets should be more readable
and understandable now.
- CHANGE: Default URL fetcher emits an ERROR instead of a warning
if finding a different mine-type than ``text/css``.
- a few other changes, bugfixes and improvements
Note:
CSSValue, CSSValueList, and CSSPrimitiveValue and the relevant
methods/properties Property.cssValue and
CSSStyleDeclaration.getPropertyCSSValue are more or less DEPRECATED and
will probably be replaced with interfaces defined in CSSOM. For now use
the properties and methods that handle values as simple strings, e.g.
``Property.value``. As the aforementioned classes are not hardly that
useful anyway this should not be a big problem but please beware if you
use or have used them.
If you think this a bad idea please let me know!
license
-------
cssutils is published under the LGPL version 3 or later, see
http://cthedot.de/cssutils/
If you have other licensing needs please let me know.
download
--------
For download options see http://cthedot.de/cssutils/
cssutils needs Python 2.4 or higher (tested with Python 2.5.2 on Vista only)
Bug reports (via Google code), comments, etc are very much appreciated!
Thanks.
Christof
--
http://mail.python.org/mailman/listinfo/python-announce-list
Support the Python Software Foundation:
http://www.python.org/psf/donations.html
