Cssutils

cleaned up docstrings and added version information

complete rewrite with combination of parser and builder classes

0.1.x
-----
0.10 - 031221
first version to try if i can bring it to work at all

only a prettyprinter included, no builder

=======

- BUGFIX: False HASH color values like ``xyz`` were not being handled properly (thanks to Teruaki Koizumi)

- Fixed Bitbucket 23: Tests do work properly in newer Python (>2.7.1?) version now, old versions will report error. Before this was the other way round but this makes more sense probably

- Fixed Bitbucket 24: rgba color values did not validate properly

- (Jason R. Coombs) Fixed Bitbucket 25: Cssutils installs "tests" package

- Fixed Bitbucket 27: Small magnitude float values serialized incorrectly

- Fixed Bitbucket 28: Standalone semicolons in CSSStyleDeclaration is now simply stripped and does not remove directly following property too

- **REGRESSION**: Valid profiles reported by validation may not be right but as these hardly say anything in the real world anyway the advancements in the following bugfixes are probably worth this. ``Profiles.validateWithProfile`` currently not working but should be hardly used anyway. As a workaround remove all profiles and add just the ones you want to use for your application

- **BUGFIX**: Profiles have been updated. Multiple profiles can be added via ``addProfiles`` and this is preferred to adding separate profiles with ``addProfile``. Profiles do check for updated macros now so that e.g. CSS3 Colors defined in a different profile are valid for all properties defined before. This may lead to a reset of all properties and so may be an extremely expensive operation.

- BUGFIX: font-family names in profile CSS3_FONTS seem to have been defined wrongly. Family names containing spaces are valid now, even without quotes.

- BUGFIX: for Python 2.5 compatibility (thanks Jason)

+ IMPROVEMENT: Added all X11 color names and corresponding RGBA values

======

- FEATURE: Implemented API for ``MarginRule`` objects inside ``CSSPageRule``, see http://www.w3.org/TR/css3-page/. You can also use e.g. ``CSSPageRule['top-left']`` to retrieve the MarginRule it it is set etc. All dict like methods should be there. If a margin is set twice or more all properties are merged into a single margin rule. Double set properties are all kept though (see below).

- FEATURE: ``parseStyle()`` has optional parameter ``validate=False`` now too to disable validation (default is always ``True``).

- FEATURE: ``CSSStyleDeclaration.setProperty`` has new option ``replace=True``. if True (DEFAULT) the given property will replace a present property. If False a new property will be added always. The difference to `normalize` is that two or more properties with the same name may be set, useful for e.g. stuff like::

background: red;
background: rgba(255, 0, 0, 0.5);

which defines the same property but only capable UAs use the last property value, older ones use the first value.

+ CHANGE: rules attribute ``atkeyword`` value is now normalized. The actual keyword (example ``IMPorT``) is kept and is optionally reserialized but in the example ``atkeyword == 'import'``

- BUGFIX: 'auto' is now an invalid CSSPageRule pagename.
- BUGFIX: Fixed issue for GoogleAppEngine (GAE) which somehow handles codecs differently. ``parseUrl`` should work now.

- FEATURE: Feature Request (Bitbucket 4) to be able to disable validation of a stylesheet has been implemented. Add Parameter ``validate=False`` for parsing.

+ BUGFIX: Fixed Bitbucket 5 Unicode escaping inside strings. Thanks to Simon Sapin
+ BUGFIX: The integer is optional in counter-reset and counter-increment, and not only on the first counter. Thanks to Simon Sapin
+ BUGFIX: Fix for unicode replacements by Denis Bilenko, thanks! https://bitbucket.org/cthedot/cssutils/pull-request/1/fix-a-bug-in-regex-which-accidentally

- IMPROVEMENT: ``parseStyle`` moved to CSSParser, thanks to Simon Sapin