[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