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 Not Found 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 arenderer
attribute exists on the directive, this attribute defaults to a view that returns an empty dictionary (see Writing View Callables 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 ofattr
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 ofrenderer
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 therequest.wrapped_body
attribute of its own request, and the response returned by this view as therequest.wrapped_response
attribute of its own request. This attribute has the same meaning as it would in the context of view; see the description ofwrapper
there). Note that the wrapper view should not be protected by any permission; behavior is undefined if it does.
Example¶
1 2 | <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 Not Found View.