summaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)Author
2009-10-09Remove comment.Chris McDonough
2009-10-09Use renderers.Chris McDonough
2009-10-09view -> static directive.Chris McDonough
2009-10-09view -> static directive.Chris McDonough
2009-10-09route -> static directive.Chris McDonough
2009-10-09Protip from elpargo.Chris McDonough
2009-10-09Fix ordering.Chris McDonough
2009-10-04(no commit message)Chris McDonough
2009-09-30Mention modwsgi.Chris McDonough
2009-09-30Put labels on arrows.Chris McDonough
2009-09-30- Add a diagram which explains the operation of the BFG router to theChris McDonough
"Router" narrative chapter.
2009-09-30- Describe "request-only" view calling conventions inside theChris McDonough
urldispatch narrative chapter, where it's most helpful.
2009-09-30Note.Chris McDonough
2009-09-30Fix.Chris McDonough
2009-09-30Add narrative docs about the append_slash_notfound_view.Chris McDonough
2009-09-30- For behavior like Django's ``APPEND_SLASH=True``, use theChris McDonough
``repoze.bfg.view.append_slash_notfound_view`` view as the Not Found view in your application. When this view is the Not Found view (indicating that no view was found), and any routes have been defined in the configuration of your application, if the value of ``PATH_INFO`` does not already end in a slash, and if the value of ``PATH_INFO`` *plus* a slash matches any route's path, do an HTTP redirect to the slash-appended PATH_INFO. Note that this will *lose* ``POST`` data information (turning it into a GET), so you shouldn't rely on this to redirect POST requests.
2009-09-30- The import of ``repoze.bfg.view.NotFound`` is deprecated in favor ofChris McDonough
``repoze.bfg.exceptions.NotFound``. The old location still functions, but emits a deprecation warning. - The import of ``repoze.bfg.security.Unauthorized`` is deprecated in favor of ``repoze.bfg.exceptions.Forbidden``. The old location still functions but emits a deprecation warning. The rename from ``Unauthorized`` to ``Forbidden`` brings parity to the the name of the exception and the system view it invokes when raised. - New ``repoze.bfg.exceptions`` module was created to house exceptions that were previously sprinkled through various modules. - An ``exceptions`` API chapter was added, documenting the new ``repoze.bfg.exceptions`` module.
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-23Prep for 1.1a4.Chris McDonough
2009-09-21Fix docs after updates.Chris McDonough
2009-09-19(no commit message)Chris McDonough
2009-09-19Typos.Chris McDonough
2009-09-19- Added a tutorial which explains how to use ``repoze.session``Chris McDonough
(ZODB-based sessions) in a ZODB-based repoze.bfg app.
2009-09-19- Added a tutorial which explains how to add ZEO to a ZODB-basedChris McDonough
``repoze.bfg`` application.
2009-09-18Rendering.Chris McDonough
2009-09-18Add a mod_wsgi configuration tutorial.Chris McDonough
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-16Prep for 1.1a3.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-14Prep for 1.1a2.Chris McDonough
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-06Prep for 1.1a1.Chris McDonough
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-23Logo that matches background of docs sidebar contributed by Mike Naberezny.Chris McDonough
2009-07-22Prep for 1.0.1.Chris McDonough