Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Branch: master
Fetching contributors…

Cannot retrieve contributors at this time

78 lines (59 sloc) 2.531 kB

notfound

Warning

The notfound ZCML directive is deprecated in Pyramid version 1.0. Instead, you should use the :ref:`view_directive` directive with a context that names the :exc:`pyramid.exceptions.NotFound` class. See :ref:`changing_the_notfound_view` form more information.

When Pyramid can't map a URL to view code, it invokes a :term:`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 :term:`dotted Python name` to a :term:`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 :ref:`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 :ref:`view_directive`; see the description of attr there).
renderer
This is either a single string term (e.g. json) or a string implying a path or :term:`asset specification` (e.g. templates/views.pt) used when the view returns a non-:term:`response` object. This attribute has the same meaning as it would in the context of :ref:`view_directive`; see the description of renderer there).
wrapper
The :term:`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 :ref:`view_directive`; 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

Alternatives

Use the :ref:`view_directive` directive with a context that names the :exc:`pyramid.exceptions.NotFound` class.

Use the :meth:`pyramid.config.Configurator.add_view` method, passing it a context which is the :exc:`pyramid.exceptions.NotFound` class.

See Also

See also :ref:`changing_the_notfound_view`.

Jump to Line
Something went wrong with that request. Please try again.