What's New in WebHelpers
This is a high-level overview of recent changes. Incompatible changes are in boldface; these may require modifying your application. See Changelog for the full changelog.
WebHelpers 1.0 has a lot of new features compared to 0.6.4. Several modules deprecated in 0.6.4 were removed, but otherwise there are only a few API incompatibilties with the 0.6 series.
webhelpers.html.secure_form was moved to webhelpers.pylonslib.secure_form because it depends on Pylons.
uk_counties() now returns tuples rather than strings.
webhelpers.feedgenerator was upgraded to the Django original (December 2009 version), and the "Geo" classes were added for geographical (GIS) feeds. Points are latitude/longitude by default, but there's a flag if your data is longitude first (as Django is). A Geometry class was reverse engineered for other geometries, but it's untested. Add a "published" property for Atom feeds.
New method for producing CDATA sections. The basic tag builders have a _nl flag to add a newline between content elements and after the tag for readability.
New helpers to render HTML to text, and to sanitize user input by stripping HTML tags.
markdown() adds an argument to choose a Markdown implementation. The Markdown included in WebHelpers will remain at version 1.7, but Markdown 2.x is available on PyPI, and a separate implementation confusingly called "Markdown2" is also available on PyPI.
Ported js_obfuscate() from the old rails helpers.
highlight() adds new arguments for flexibility, and is reimplemented using the HTML builder. The 'highlighter' argument is deprecated.
New helpers to flatten nested lists and tuples, and to gather all the subclasses of a specified class. There's an exception OverwriteError, and a DeclarativeException class for making your own exceptions with constant messages.
webhelpers.pylonslib is now a package. The Flash class accepts severity categories, which you can use to style more severe messages differently. The session structure is different, so delete existing HTTP sessions when upgrading.
webhelpers.text adds a suite of helpers from Ruby's stringex package to convert strings to URL-friendly format, and to remove inconvenient accents from characters, etc.
New helper to update the query parameters in a URL.
webhelpers.html.grid and webhelpers.pylonslib.grid contain helpers to make an HTML table from a list of objects such as database records. It has a demo program and an optional stylesheet. It's "experimental" because the API needs some changes and the docstrings aren't very clear. But it works. The next version will add support for more input types: a list of sequences, a list of dicts, or a single dict.
Other experiments are in the "unfinished" directory in the source distribution.