From a9fed7675d8da572dee840676714b2653e3f7f79 Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Wed, 16 Sep 2009 04:56:49 +0000 Subject: Checkpoint. Not 100% test coverage. --- CHANGES.txt | 54 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 53 insertions(+), 1 deletion(-) (limited to 'CHANGES.txt') diff --git a/CHANGES.txt b/CHANGES.txt index c94364efd..539d3d921 100644 --- a/CHANGES.txt +++ b/CHANGES.txt @@ -1,8 +1,60 @@ Next release ============ +- When used under Python < 2.6, BFG now has an installation time + dependency on the ``simplejson`` package. + +- The previous release (1.1a2) added a view configuration attribute + named ``template``. In this release, the attribute has been renamed + to ``renderer``. This signifies that the attribute is more generic: + it can now be not just a template name but any renderer name (ala + ``json``). A "renderer" is an object which accepts the return value + of a view and converts it to a string. This includes, but is not + limited to, templating systems. + +- In the previous release (1.1a2), the Chameleon text template + renderer was used if the system didn't associate the ``template`` + view configuration value with a filename with a "known" extension. + In this release, you must use a ``renderer`` attribute which is a + path that ends with a ``.txt`` extension + (e.g. ``templates/foo.txt``) to use the Chameleon text renderer. + +- The ``ITemplateRenderer`` interface has been changed. Previously + its ``__call__`` method accepted ``**kw``. It now accepts a single + positional parameter named ``kw``. + +- The ``ITemplateRendererFactory`` interface has been changed. + Previously its ``__call__`` method accepted an ``auto_reload`` + keyword parameter. Now it accepts no keyword parameters. Renderers + are now themselves responsible for determining details of + auto-reload. + +- The ``templating`` module has been removed. The bulk of its + functionality has been moved to a different module named + ``renderers``. + +- A new interface named ``IRenderer`` was added. The existing + interface, ``ITemplateRenderer`` now derives from this new + interface. This interface is internal. + +- A new interface named ``IRendererFactory`` was added. An existing + interface named ``ITemplateRenderer`` now derives from this + interface. This interface is internal. + +- The "Views" narrative chapter in the documentation has been updated + extensively to discuss "renderers". + - The ``view`` attribute of the ``view`` ZCML directive is no longer - required if the ZCML directive has a ``template`` attribute. + required if the ZCML directive also has a ``renderer`` attribute. + This is useful when the renderer is a template renderer and no names + need be passed to the template at render time. + +- A new zcml directive ``renderer_factory`` has been added. It is + documented in the "Views" narrative chapter of the documentation. + +- The ``template_renderer`` ZCML directive introduced in 1.1a2 has + been removed. It has been replaced by the ``renderer_factory`` + directive. - A ZCML ``view`` directive (and the associated ``bfg_view`` decorator) can now accept a "wrapper" value. If a "wrapper" value -- cgit v1.2.3