summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorChris McDonough <chrism@plope.com>2011-09-03 21:44:53 -0400
committerChris McDonough <chrism@plope.com>2011-09-03 21:44:53 -0400
commitc2aae1f09786f1044ded7c61a83961fed87cc7d9 (patch)
treef57e505a7ffd949035d1ad6f1ba92f4121a34281 /docs
parent7a7c8c788bbc739f25eb1fb3754999270cd87fb6 (diff)
parentea80f116274ce90ab6b88f7e2edaba8be091d8c1 (diff)
downloadpyramid-c2aae1f09786f1044ded7c61a83961fed87cc7d9.tar.gz
pyramid-c2aae1f09786f1044ded7c61a83961fed87cc7d9.tar.bz2
pyramid-c2aae1f09786f1044ded7c61a83961fed87cc7d9.zip
Merge branch 'master' of github.com:Pylons/pyramid
Diffstat (limited to 'docs')
-rw-r--r--docs/narr/environment.rst15
1 files changed, 13 insertions, 2 deletions
diff --git a/docs/narr/environment.rst b/docs/narr/environment.rst
index a5909e541..da93332c0 100644
--- a/docs/narr/environment.rst
+++ b/docs/narr/environment.rst
@@ -654,7 +654,18 @@ Here's how:
dictionary with the converted version of the variable *before* passing
it to the Configurator: the configurator makes a *copy* of ``settings``,
it doesn't use the one you pass directly.
-
+
+- When creating an ``includeme`` function that will be later added to your
+ application's configuration you may access the ``settings`` dictionary
+ through the instance of the :term:`Configurator` that is passed into the
+ function as its only argument. For Example:
+
+ .. code-block:: python
+
+ def includeme(config):
+ settings = config.registry.settings
+ debug_frobnosticator = settings['debug_frobnosticator']
+
- In the runtime code that you need to access the new settings value, find
the value in the ``registry.settings`` dictionary and use it. In
:term:`view` code (or any other code that has access to the request), the
@@ -662,7 +673,7 @@ Here's how:
.. code-block:: python
- registry = request.registry.settings
+ settings = request.registry.settings
debug_frobnosticator = settings['debug_frobnosticator']
If you wish to use the value in code that does not have access to the