mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-31 05:58:33 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 7

bpo-43245: Add keyword argument support to ChainMap.new_child() (GH-24788)

Browse source
This commit is contained in:
Kamil Turek 2021-03-14 04:15:44 +01:00 • committed by GitHub
parent 9c376bc1c4
commit 9923df9641
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
4 changed files with 18 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

12
Doc/library/collections.rst
View file

@ -72,19 +72,23 @@ The class can be used to simulate nested scopes and is useful in templating.
be modified to change which mappings are searched. The list should
always contain at least one mapping.
.. method:: new_child(m=None)
.. method:: new_child(m=None, **kwargs)
Returns a new :class:`ChainMap` containing a new map followed by
all of the maps in the current instance. If ``m`` is specified,
it becomes the new map at the front of the list of mappings; if not
specified, an empty dict is used, so that a call to ``d.new_child()``
is equivalent to: ``ChainMap({}, *d.maps)``. This method is used for
creating subcontexts that can be updated without altering values in any
of the parent mappings.
is equivalent to: ``ChainMap({}, *d.maps)``. If any keyword arguments
are specified, they update passed map or new empty dict. This method
is used for creating subcontexts that can be updated without altering
values in any of the parent mappings.
.. versionchanged:: 3.4
The optional ``m`` parameter was added.
.. versionchanged:: 3.10
Keyword arguments support was added.
.. attribute:: parents
Property returning a new :class:`ChainMap` containing all of the maps in