[docs] [issue31075] Collections - ChainMap - Documentation example wrong order line

Marcos Soutullo report at bugs.python.org
Sat Jul 29 08:24:17 EDT 2017


New submission from Marcos Soutullo:

Hello,

I have been taking a look into your ChainMap collections documentation (https://docs.python.org/3.6/library/collections.html?highlight=collections#collections.ChainMap), specifically the third code example on "8.3.1.1. ChainMap Examples and Recipes"
that clearly describe and illustrate a use case for the ChainMap class. However, I found a very small code issue in regards to how the sample code (line 7) is presented to the reader. Please refer to the code compilation below:

Line 7 >>> d['x']                # Get first key in the chain of contexts
raise KeyError(key)
KeyError: 'x'
Line 8 >>> d['x'] d['x'] = 1            # Set value in current context

The key named 'x' had not been initialised yet and of course, the compiler is complaining. It should be the other way around.

Line 8 >>> d['x'] = 1   # Set value in current context
Line 7 >>> d['x']       # Get first key in the chain of contexts


Many thanks for the great work you do with Python,

Marcos S.

----------
assignee: docs at python
components: Documentation
messages: 299465
nosy: Marcos Soutullo, docs at python
priority: normal
severity: normal
status: open
title: Collections - ChainMap - Documentation example wrong order line
type: compile error
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue31075>
_______________________________________


More information about the docs mailing list