notfound
Warning
The notfound ZCML directive is deprecated in Pyramid
version 1.0. Instead, you should use the view
directive with a context that names the
pyramid.exceptions.NotFound class. See
changing_the_notfound_view form more information.
When Pyramid can’t map a URL to view code, it invokes a not found
view. The default not found view is very plain, but the view callable used
can be configured via the notfound ZCML tag.
Attributes
- view
- The dotted Python name to a view callable. This
attribute is required unless a renderer attribute also exists.
If a renderer attribute exists on the directive, this attribute
defaults to a view that returns an empty dictionary (see
views_which_use_a_renderer).
- attr
- The attribute of the view callable to use if __call__ is not
correct (has the same meaning as in the context of
view; see the description of attr
there).
- renderer
- This is either a single string term (e.g. json) or a string
implying a path or asset specification
(e.g. templates/views.pt) used when the view returns a
non-response object. This attribute has the same meaning as
it would in the context of view; see the
description of renderer there).
- wrapper
- The view name (not an object dotted name) of another view
declared elsewhere in ZCML (or via the @view_config decorator)
which will receive the response body of this view as the
request.wrapped_body attribute of its own request, and the
response returned by this view as the request.wrapped_response
attribute of its own request. This attribute has the same meaning
as it would in the context of view; see
the description of wrapper there). Note that the wrapper view
should not be protected by any permission; behavior is undefined
if it does.
Example
| <notfound
view="helloworld.views.notfound_view"/>
|
Alternatives
Use the view directive with a context that names
the pyramid.exceptions.NotFound class.
Use the pyramid.config.Configurator.add_view() method,
passing it a context which is the
pyramid.exceptions.NotFound class.
See Also
See also changing_the_notfound_view.