From 12cb6df7728c8321905a08b0864b3ff0386c62cf Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Tue, 27 Apr 2010 16:44:52 +0000 Subject: Features -------- - A locale negotiator no longer needs to be registered explicitly. The default locale negotiator at ``repoze.bfg.i18n.default_locale_negotiator`` is now used unconditionally as... um, the default locale negotiator. - The default locale negotiator has become more complex. * First, the negotiator looks for the ``_LOCALE_`` attribute of the request object (possibly set by an :term:`event listener`). * Then it looks for the ``request.params['_LOCALE_']`` value. * Then it looks for the ``request.cookies['_LOCALE_']`` value. Backwards Incompatibilities --------------------------- - The default locale negotiator now looks for the parameter named ``_LOCALE_`` rather than a parameter named ``locale`` in ``request.params``. Behavior Changes ---------------- - A locale negotiator may now return ``None``, signifying that the default locale should be used. Documentation ------------- - Documentation concerning locale negotiation in the Internationalizationa and Localization chapter was updated. --- repoze/bfg/configuration.py | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) (limited to 'repoze/bfg/configuration.py') diff --git a/repoze/bfg/configuration.py b/repoze/bfg/configuration.py index 9fa3fe8b2..546a6978b 100644 --- a/repoze/bfg/configuration.py +++ b/repoze/bfg/configuration.py @@ -145,6 +145,10 @@ class Configurator(object): class. The debug logger is used by :mod:`repoze.bfg` itself to log warnings and authorization debugging information. + If ``locale_negotiator`` is passed, it should be a + :term:`locale negotiator` implementation. See + :ref:`custom_locale_negotiator`. + """ manager = manager # for testing injection venusian = venusian # for testing injection @@ -367,9 +371,9 @@ class Configurator(object): initialization. ``setup_registry`` configures settings, a root factory, - security policies, renderers, and a debug logger using the - configurator's current registry, as per the descriptions in - the Configurator constructor.""" + security policies, renderers, a debug logger, and a locale + negotiator using the configurator's current registry, as per + the descriptions in the Configurator constructor.""" self._fix_registry() self._set_settings(settings) self._set_root_factory(root_factory) -- cgit v1.2.3