WebHelpers 0.6 final has been released. Just do:
$ easy_install -U WebHelpers
For now you'll have to read the docstrings in the source code for
documentation. I'm hoping these will be included online in the Pylons
0.9.7 documentation as soon as that project is finished. Here's
what's available online for now:
http://docs.pylonshq.com/helpers.html
There's a detailed howto for webhelpers.paginage, and a brief
description of the rest of the package.
Pylons 0.9.6 users using the stable version of WebHelpers should be
able to upgrade as-is, although there's no particular benefit unless
you want to start using the new (non-rails) helpers. You may have to
add the following to helpers.py:
from webhelpers.rails import *
from routes import url_for
from pylons.controllers.util import redirect_to
We're trying to eliminate WebHelper's dependencies on Routes; that's
the reason for the second two imports.
Pylons 0.9.7-dev users who are using the rails helpers should add this
to helpers.py:
from webhelpers.rails.wrapped import *
(And remove any other rails import, and add the url_for and
redirect_to import above.) The ``wrapped`` module contains specially
wrapped versions of all the rails helpers which will not be escaped by
Pylons 0.9.7's default Mako filter. Otherwise you'll find "<" escaped
to "<" on your web pages.
Users ready to upgrade from the rails helpers (which are all
deprecated now) should see "What's New in Pylons 0.9.7?" for a list
of suggested imports that are most similar to the rails helpers. The
functions are similar but not always identical, so check the argument
signature and function docstring.
The biggest change is that the option order in
webhelpers.html.tags.select() is the opposite of the old
options_for_select(): value before label instead of label before
value. There are tradeoffs both ways on this, but doing .items() on a
dict whose keys are SELECT values seems more common than dicts whose
keys are SELECT labels.
All Javascript in WebHelpers has been deprecated, including Prototype,
Scriptaculous, and link_to_remote(). We can't keep up with the rapid
evolution of Javascript libraries, and the best one changes every six
months. Several users have come up with short manual replacements to
link_to_remote(), which you can ask about here or on IRC. Those
wanting a comprehensive Javascript library can look at YUI, JQuery,
ExtJS, ForkJavascript, etc.
The rails helpers and Javascript stuff will be deleted in a future
version of WebHelpers, so now is a good time to start migrating from
them.
--
Mike Orr <[EMAIL PROTECTED]>
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"pylons-discuss" group.
To post to this group, send email to pylons-discuss@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/pylons-discuss?hl=en
-~----------~----~----~----~------~----~------~--~---
