mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 18:29:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

Add cross-reference to typing.NamedTuple. Doctest two more examples.

Browse source
This commit is contained in:
Raymond Hettinger 2016-08-16 13:13:17 -07:00
parent f59249b048
commit fd27f62a74
1 changed files with 10 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

14
Doc/library/collections.rst
View file

@ -850,7 +850,9 @@ field names, the method and attribute names start with an underscore.
.. method:: somenamedtuple._asdict() .. method:: somenamedtuple._asdict()
Return a new :class:`OrderedDict` which maps field names to their corresponding Return a new :class:`OrderedDict` which maps field names to their corresponding
values:: values:
.. doctest::
>>> p = Point(x=11, y=22) >>> p = Point(x=11, y=22)
>>> p._asdict() >>> p._asdict()
@ -912,7 +914,9 @@ Since a named tuple is a regular Python class, it is easy to add or change
functionality with a subclass. Here is how to add a calculated field and functionality with a subclass. Here is how to add a calculated field and
a fixed-width print format: a fixed-width print format:
>>> class Point(namedtuple('Point', 'x y')): .. doctest::
>>> class Point(namedtuple('Point', ['x', 'y'])):
... __slots__ = () ... __slots__ = ()
... @property ... @property
... def hypot(self): ... def hypot(self):
@ -963,8 +967,10 @@ customize a prototype instance:
constructor that is convenient for use cases where named tuples are being constructor that is convenient for use cases where named tuples are being
subclassed. subclassed.
* :meth:`types.SimpleNamespace` for a mutable namespace based on an underlying * See :meth:`types.SimpleNamespace` for a mutable namespace based on an
dictionary instead of a tuple. underlying dictionary instead of a tuple.
* See :meth:`typing.NamedTuple` for a way to add type hints for named tuples.
:class:`OrderedDict` objects :class:`OrderedDict` objects