From d89aee7640b1e01a7dda4e603e87461074fbbdd7 Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Sun, 5 Sep 2010 22:39:20 +0000 Subject: - Each of the follow methods of the Configurator now allow the below-named arguments to be passed as "dotted name strings" (e.g. "foo.bar.baz") rather than as actual implementation objects that must be imported: setup_registry root_factory, authentication_policy, authorization_policy, debug_logger, locale_negotiator, request_factory, renderer_globals_factory add_subscriber subscriber, iface derive_view view add_view view, for_, context, request_type, containment add_route() view, view_for, factory, for_, view_context scan package add_renderer factory set_forbidden_view view set_notfound_view view set_request_factory factory set_renderer_globals_factory() factory set_locale_negotiator negotiator testing_add_subscriber event_iface --- docs/narr/urldispatch.rst | 25 +++++++++++++------------ 1 file changed, 13 insertions(+), 12 deletions(-) (limited to 'docs/narr/urldispatch.rst') diff --git a/docs/narr/urldispatch.rst b/docs/narr/urldispatch.rst index 07e96763d..9779113e5 100644 --- a/docs/narr/urldispatch.rst +++ b/docs/narr/urldispatch.rst @@ -448,11 +448,11 @@ represent neither predicates nor view configuration information. application. ``factory`` - A reference to a Python object (often a function or a class) that - will generate a :mod:`repoze.bfg` :term:`context` object when this - route matches. For example, ``mypackage.models.MyFactoryClass``. If - this argument is not specified, the traversal root factory will be - used. + A Python object (often a function or a class) or a :term:`Python + dotted name` to such an object that will generate a + :mod:`repoze.bfg` :term:`context` object when this route + matches. For example, ``mypackage.models.MyFactoryClass``. If this + argument is not specified, the traversal root factory will be used. ``traverse`` If you would like to cause the :term:`context` to be something other @@ -573,15 +573,16 @@ represent neither predicates nor view configuration information. **View-Related Arguments** ``view`` - A reference to a Python object that will be used as a view callable - when this route matches. e.g. ``mypackage.views.my_view``. + A Python object or a :term:`dotted Python name` to such an object + that will be used as a view callable when this route + matches. e.g. ``mypackage.views.my_view``. ``view_context`` - A reference to a class or an :term:`interface` that the - :term:`context` of the view should match for the view named by the - route to be used. This argument is only useful if the ``view`` - attribute is used. If this attribute is not specified, the default - (``None``) will be used. + A class or an :term:`interface` (or a :term:`dotted Python name` to + such an object) that the :term:`context` of the view should match + for the view named by the route to be used. This argument is only + useful if the ``view`` attribute is used. If this attribute is not + specified, the default (``None``) will be used. If the ``view`` argument is not provided, this argument has no effect. -- cgit v1.2.3