summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2012-03-08 19:35:08 (GMT)
committerGeorg Brandl <georg@python.org>2012-03-08 19:35:08 (GMT)
commit4dcf474337022ec149c4ed6d90ebafb553e98796 (patch)
tree2db02c30b4d9b939cfc8f36d7a7a0fe303a3e4cc /Doc
parent50dbb3f2cf926fc15683b82607bd411b49d8d69d (diff)
downloadcpython-4dcf474337022ec149c4ed6d90ebafb553e98796.zip
cpython-4dcf474337022ec149c4ed6d90ebafb553e98796.tar.gz
cpython-4dcf474337022ec149c4ed6d90ebafb553e98796.tar.bz2
Fix indentation.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/collections.rst119
1 files changed, 60 insertions, 59 deletions
diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
index 188fd0a..5298dbc 100644
--- a/Doc/library/collections.rst
+++ b/Doc/library/collections.rst
@@ -91,65 +91,66 @@ The class can be used to simulate nested scopes and is useful in templating.
The use-cases also parallel those for the builtin :func:`super` function.
A reference to ``d.parents`` is equivalent to: ``ChainMap(*d.maps[1:])``.
- .. versionadded:: 3.3
-
- Example of simulating Python's internal lookup chain::
-
- import builtins
- pylookup = ChainMap(locals(), globals(), vars(builtins))
-
- Example of letting user specified values take precedence over environment
- variables which in turn take precedence over default values::
-
- import os, argparse
- defaults = {'color': 'red', 'user': guest}
- parser = argparse.ArgumentParser()
- parser.add_argument('-u', '--user')
- parser.add_argument('-c', '--color')
- user_specified = vars(parser.parse_args())
- combined = ChainMap(user_specified, os.environ, defaults)
-
- Example patterns for using the :class:`ChainMap` class to simulate nested
- contexts::
-
- c = ChainMap() Create root context
- d = c.new_child() Create nested child context
- e = c.new_child() Child of c, independent from d
- e.maps[0] Current context dictionary -- like Python's locals()
- e.maps[-1] Root context -- like Python's globals()
- e.parents Enclosing context chain -- like Python's nonlocals
-
- d['x'] Get first key in the chain of contexts
- d['x'] = 1 Set value in current context
- del['x'] Delete from current context
- list(d) All nested values
- k in d Check all nested values
- len(d) Number of nested values
- d.items() All nested items
- dict(d) Flatten into a regular dictionary
-
- .. seealso::
-
- * The `MultiContext class
- <http://svn.enthought.com/svn/enthought/CodeTools/trunk/enthought/contexts/multi_context.py>`_
- in the Enthought `CodeTools package
- <https://github.com/enthought/codetools>`_ has options to support
- writing to any mapping in the chain.
-
- * Django's `Context class
- <http://code.djangoproject.com/browser/django/trunk/django/template/context.py>`_
- for templating is a read-only chain of mappings. It also features
- pushing and popping of contexts similar to the
- :meth:`~collections.ChainMap.new_child` method and the
- :meth:`~collections.ChainMap.parents` property.
-
- * The `Nested Contexts recipe
- <http://code.activestate.com/recipes/577434/>`_ has options to control
- whether writes and other mutations apply only to the first mapping or to
- any mapping in the chain.
-
- * A `greatly simplified read-only version of Chainmap
- <http://code.activestate.com/recipes/305268/>`_.
+ .. versionadded:: 3.3
+
+ Example of simulating Python's internal lookup chain::
+
+ import builtins
+ pylookup = ChainMap(locals(), globals(), vars(builtins))
+
+ Example of letting user specified values take precedence over environment
+ variables which in turn take precedence over default values::
+
+ import os, argparse
+ defaults = {'color': 'red', 'user': guest}
+ parser = argparse.ArgumentParser()
+ parser.add_argument('-u', '--user')
+ parser.add_argument('-c', '--color')
+ user_specified = vars(parser.parse_args())
+ combined = ChainMap(user_specified, os.environ, defaults)
+
+ Example patterns for using the :class:`ChainMap` class to simulate nested
+ contexts::
+
+ c = ChainMap() # Create root context
+ d = c.new_child() # Create nested child context
+ e = c.new_child() # Child of c, independent from d
+ e.maps[0] # Current context dictionary -- like Python's locals()
+ e.maps[-1] # Root context -- like Python's globals()
+ e.parents # Enclosing context chain -- like Python's nonlocals
+
+ d['x'] # Get first key in the chain of contexts
+ d['x'] = 1 # Set value in current context
+ del['x'] # Delete from current context
+ list(d) # All nested values
+ k in d # Check all nested values
+ len(d) # Number of nested values
+ d.items() # All nested items
+ dict(d) # Flatten into a regular dictionary
+
+ .. seealso::
+
+ * The `MultiContext class
+ <http://svn.enthought.com/svn/enthought/CodeTools/trunk/enthought/contexts/multi_context.py>`_
+ in the Enthought `CodeTools package
+ <https://github.com/enthought/codetools>`_ has options to support
+ writing to any mapping in the chain.
+
+ * Django's `Context class
+ <http://code.djangoproject.com/browser/django/trunk/django/template/context.py>`_
+ for templating is a read-only chain of mappings. It also features
+ pushing and popping of contexts similar to the
+ :meth:`~collections.ChainMap.new_child` method and the
+ :meth:`~collections.ChainMap.parents` property.
+
+ * The `Nested Contexts recipe
+ <http://code.activestate.com/recipes/577434/>`_ has options to control
+ whether writes and other mutations apply only to the first mapping or to
+ any mapping in the chain.
+
+ * A `greatly simplified read-only version of Chainmap
+ <http://code.activestate.com/recipes/305268/>`_.
+
:class:`Counter` objects
------------------------