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

[Raymond Hettinger]

Changes by Raymond Hettinger :


--
stage:  -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

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

[Raymond Hettinger]

Raymond Hettinger added the comment:

> Many thanks for the great work you do with Python,

Thanks for the kudos.  Also, thanks for the close reading of the docs.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

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

[Raymond Hettinger]

Raymond Hettinger added the comment:

-0

The code block was originally intended to just be a table of patterns, not 
meant to be executed sequentially.  It followed the traditional presentation 
order (__getitem__, __setitem__, followed by __delitem__).

If we do change this, then the subsequent "k in d" example should also be 
changed to "'x' in d" because k isn't defined.

--
assignee: docs@python -> rhettinger
nosy: +rhettinger
priority: normal -> low
resolution:  -> not a bug

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

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

[Marcos Soutullo]

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@python
components: Documentation
messages: 299465
nosy: Marcos Soutullo, docs@python
priority: normal
severity: normal
status: open
title: Collections - ChainMap - Documentation example wrong order line
type: compile error
versions: Python 3.6

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com