summaryrefslogtreecommitdiff
path: root/docs/narr
AgeCommit message (Collapse)Author
2009-09-26Added missing word found by Stephen WaterburyCarlos de la Guardia
2009-09-24Merge jpenny changes.Chris McDonough
2009-09-24Add traversal diagram.Chris McDonough
2009-09-21Fix docs after updates.Chris McDonough
2009-09-19- Added a tutorial which explains how to add ZEO to a ZODB-basedChris McDonough
``repoze.bfg`` application.
2009-09-17- Add a ``repoze.bfg.url.static_url`` API which is capable ofChris McDonough
generating URLs to static resources defined by the ``<static>`` ZCML directive. See the "Views" narrative chapter's section titled "Generating Static Resource URLs" for more information.
2009-09-17- Add a ``string`` renderer. This renderer converts a non-ResponseChris McDonough
return value of any view callble into a string. It is documented in the "Views" narrative chapter.
2009-09-16- Give the ``route`` ZCML directive the ``view_attr`` andChris McDonough
``view_renderer`` parameters (bring up to speed with 1.1a3 features). These can also be spelled as ``attr`` and ``renderer``.
2009-09-16Excise "page" vernacular.Chris McDonough
2009-09-16Review and edit views chapter.Chris McDonough
2009-09-16- The ``repoze.bfg.testing.registerDummyRenderer`` API has beenChris McDonough
deprecated in favor of ``repoze.bfg.testing.registerTemplateRenderer``. A deprecation warning is *not* issued at import time for the former name; it will exist "forever". - The ``repoze.bfg.templating.renderer_from_cache`` function has been moved to ``repoze.bfg.renderer.template_renderer_factory``. This was never an API, but code in the wild was spotted that used it. A deprecation warning is issued at import time for the former. - Better error message when a wrapper view returns None.
2009-09-16Checkpoint. Not 100% test coverage.Chris McDonough
2009-09-14- The ``view`` attribute of the ``view`` ZCML directive is no longerChris McDonough
required if the ZCML directive has a ``template`` attribute.
2009-09-14- A ZCML ``view`` directive (and the associated ``bfg_view``Chris McDonough
decorator) can now accept a "wrapper" value. If a "wrapper" value is supplied, it is the value of a separate view's *name* attribute. When a view with a ``wrapper`` attribute is rendered, the "inner" view is first rendered normally. Its body is then attached to the request as "wrapped_body", and then a wrapper view name is looked up and rendered (using ``repoze.bfg.render_view_to_response``), passed the request and the context. The wrapper view is assumed to do something sensible with ``request.wrapped_body``, usually inserting its structure into some other rendered template. This feature makes it possible to specify (potentially nested) "owrap" relationships between views using only ZCML or decorators (as opposed always using ZPT METAL and analogues to wrap view renderings in outer wrappers).
2009-09-14Page->view.Chris McDonough
2009-09-14Renderings.Chris McDonough
2009-09-14- A ZCML ``view`` directive (and the associated ``bfg_view``Chris McDonough
decorator) can now accept an "attr" value. If an "attr" value is supplied, it is considered a method named of the view object to be called when the response is required. This is typically only good for views that are classes or instances (not so useful for functions, as functions typically have no methods other than ``__call__``). - A ZCML ``view`` directive (and the associated ``bfg_view`` decorator) can now accept a "template" value. If a "template" value is supplied, and the view callable returns a dictionary, the associated template is rendered with the dictionary as keyword arguments.
2009-09-06Merge multiview2 branch to HEAD.Chris McDonough
2009-08-25- The ``repoze.bfg.view.static`` class now accepts a string as itsChris McDonough
first argument ("root_dir") that represents a package-relative name e.g. ``somepackage:foo/bar/static``. This is now the preferred mechanism for spelling package-relative static paths using this class. A ``package_name`` keyword argument has been left around for backwards compatibility. If it is supplied, it will be honored. - Fixed documentation for ``repoze.bfg.view.static`` (in narrative ``Views`` chapter).
2009-08-24Added ZCML directive to serve up static files from a directory.Malthe Borch
2009-08-13- Request-only-convention examples in the "Views" narrativeChris McDonough
documentation were broken.
2009-07-27Reorder authentication policies by most common to least.Chris McDonough
2009-07-20Fixed documentation bug showing invalid test for values from the ``matchdict``.Tres Seaver
o They are stored as attributes of the ``Article``, rather than subitems.
2009-07-20Fixed documentation bug showing wrong environment key for the ``matchdict``Tres Seaver
produced by the matching route. Thanks to leopay for the catch.
2009-07-20Small wording change courtesy of Russ FerridayPaul Everitt
2009-07-08Rendering.Chris McDonough
2009-07-08Rendering.Chris McDonough
2009-07-08Rendering.Chris McDonough
2009-07-05Spellcheck.Chris McDonough
2009-07-05Spelling.Chris McDonough
2009-07-05Specific.Chris McDonough
2009-07-05Spelling.Chris McDonough
2009-07-05Tweak and change test output.Chris McDonough
2009-07-04Wording changes.Chris McDonough
2009-07-03(no commit message)Chris McDonough
2009-07-03Wording.Chris McDonough
2009-07-03Not a publisher, a router.Chris McDonough
2009-07-03API docs audit.Chris McDonough
2009-07-03General editing walkthrough.Chris McDonough
2009-07-02Testing output.Chris McDonough
2009-07-02Rendering.Chris McDonough
2009-07-02Allow ``zcml_configure`` value to override the package.Chris McDonough
2009-07-02Reorder.Chris McDonough
2009-07-02Typo.Chris McDonough
2009-07-02- Added an "Extending" chapter to the narrative documentation whichChris McDonough
explains how to extend or modify an existing BFG application using another Python package and ZCML.
2009-07-02- Added a "Resources" chapter to the narrative documentation whichChris McDonough
explains how to override resources within one package from another package.
2009-07-02Document (upcoming) ``configure_zcml`` feature.Chris McDonough
2009-07-01Minimal mention of new feature.Chris McDonough
2009-07-01- Deprecate the ``authentication_policy`` and ``authorization_policy``Chris McDonough
arguments to ``repoze.bfg.router.make_app``. Instead, developers should use the various authentication policy ZCML directives (``repozewho1authenticationpolicy``, ``remoteuserauthenticationpolicy`` and ``authtktauthenticationpolicy``) and the `aclauthorizationpolicy`` authorization policy directive as described in the changes to the "Security" narrative documentation chapter and the wiki tutorials.
2009-06-30- Add a ``reload_resources`` configuration file setting (aka theChris McDonough
``BFG_RELOAD_RESOURCES`` environment variable). When this is set to true, the server never needs to be restarted when moving files between directory resource overrides (esp. for templates currently). - Add a ``reload_all`` configuration file setting (aka the ``BFG_RELOAD_ALL`` environment variable) that implies both ``reload_resources`` and ``reload_templates``. - The ``static`` helper view class now uses a ``PackageURLParser`` in order to allow for the overriding of static resources (CSS / logo files, etc) using the ``resource`` ZCML directive. The ``PackageURLParser`` class was added to a (new) ``static`` module in BFG; it is a subclass of the ``StaticURLParser`` class in ``paste.urlparser``. - The ``repoze.bfg.templating.renderer_from_cache`` function now checks for the ``reload_resources`` setting; if it's true, it does not register a template renderer (it won't use the registry as a template renderer cache). - Add ``pkg_resources`` to the glossary. - Update the "Environment" docs to note the existence of ``reload_resources`` and ``reload_all``. - Use a colon instead of a tab as the separator between package name and relpath to form the "spec" when register a ITemplateRenderer.