mirror of https://github.com/python/cpython
Make the doctests in the docs pass, except for those in the turtle module.
This commit is contained in:
parent
90c61a2e09
commit
f6dab9542c
|
@ -472,7 +472,7 @@ Here's a sample usage of the ``generate_ints()`` generator:
|
||||||
|
|
||||||
>>> gen = generate_ints(3)
|
>>> gen = generate_ints(3)
|
||||||
>>> gen
|
>>> gen
|
||||||
<generator object at ...>
|
<generator object generate_ints at ...>
|
||||||
>>> gen.next()
|
>>> gen.next()
|
||||||
0
|
0
|
||||||
>>> gen.next()
|
>>> gen.next()
|
||||||
|
|
|
@ -184,7 +184,7 @@ For example::
|
||||||
class is similar to bags or multisets in other languages.
|
class is similar to bags or multisets in other languages.
|
||||||
|
|
||||||
Elements are counted from an *iterable* or initialized from another
|
Elements are counted from an *iterable* or initialized from another
|
||||||
*mapping* (or counter)::
|
*mapping* (or counter):
|
||||||
|
|
||||||
>>> c = Counter() # a new, empty counter
|
>>> c = Counter() # a new, empty counter
|
||||||
>>> c = Counter('gallahad') # a new counter from an iterable
|
>>> c = Counter('gallahad') # a new counter from an iterable
|
||||||
|
@ -192,7 +192,7 @@ For example::
|
||||||
>>> c = Counter(cats=4, dogs=8) # a new counter from keyword args
|
>>> c = Counter(cats=4, dogs=8) # a new counter from keyword args
|
||||||
|
|
||||||
Counter objects have a dictionary interface except that they return a zero
|
Counter objects have a dictionary interface except that they return a zero
|
||||||
count for missing items instead of raising a :exc:`KeyError`::
|
count for missing items instead of raising a :exc:`KeyError`:
|
||||||
|
|
||||||
>>> c = Counter(['eggs', 'ham'])
|
>>> c = Counter(['eggs', 'ham'])
|
||||||
>>> c['bacon'] # count of a missing element is zero
|
>>> c['bacon'] # count of a missing element is zero
|
||||||
|
@ -225,7 +225,7 @@ For example::
|
||||||
Return a list of the *n* most common elements and their counts from the
|
Return a list of the *n* most common elements and their counts from the
|
||||||
most common to the least. If *n* is not specified, :func:`most_common`
|
most common to the least. If *n* is not specified, :func:`most_common`
|
||||||
returns *all* elements in the counter. Elements with equal counts are
|
returns *all* elements in the counter. Elements with equal counts are
|
||||||
ordered arbitrarily::
|
ordered arbitrarily:
|
||||||
|
|
||||||
>>> Counter('abracadabra').most_common(3)
|
>>> Counter('abracadabra').most_common(3)
|
||||||
[('a', 5), ('r', 2), ('b', 2)]
|
[('a', 5), ('r', 2), ('b', 2)]
|
||||||
|
|
|
@ -1850,7 +1850,7 @@ the :const:`Inexact` trap is set, it is also useful for validation:
|
||||||
>>> Decimal('3.214').quantize(TWOPLACES, context=Context(traps=[Inexact]))
|
>>> Decimal('3.214').quantize(TWOPLACES, context=Context(traps=[Inexact]))
|
||||||
Traceback (most recent call last):
|
Traceback (most recent call last):
|
||||||
...
|
...
|
||||||
Inexact
|
Inexact: None
|
||||||
|
|
||||||
Q. Once I have valid two place inputs, how do I maintain that invariant
|
Q. Once I have valid two place inputs, how do I maintain that invariant
|
||||||
throughout an application?
|
throughout an application?
|
||||||
|
|
|
@ -181,13 +181,13 @@ This module also defines two shortcut functions:
|
||||||
:attr:`returncode`
|
:attr:`returncode`
|
||||||
attribute and output in the :attr:`output` attribute.
|
attribute and output in the :attr:`output` attribute.
|
||||||
|
|
||||||
The arguments are the same as for the :class:`Popen` constructor. Example:
|
The arguments are the same as for the :class:`Popen` constructor. Example::
|
||||||
|
|
||||||
>>> subprocess.check_output(["ls", "-l", "/dev/null"])
|
>>> subprocess.check_output(["ls", "-l", "/dev/null"])
|
||||||
'crw-rw-rw- 1 root root 1, 3 Oct 18 2007 /dev/null\n'
|
'crw-rw-rw- 1 root root 1, 3 Oct 18 2007 /dev/null\n'
|
||||||
|
|
||||||
The stdout argument is not allowed as it is used internally.
|
The stdout argument is not allowed as it is used internally.
|
||||||
To capture standard error in the result, use stderr=subprocess.STDOUT.
|
To capture standard error in the result, use ``stderr=subprocess.STDOUT``::
|
||||||
|
|
||||||
>>> subprocess.check_output(
|
>>> subprocess.check_output(
|
||||||
["/bin/sh", "-c", "ls non_existent_file ; exit 0"],
|
["/bin/sh", "-c", "ls non_existent_file ; exit 0"],
|
||||||
|
|
|
@ -220,10 +220,13 @@ changes, or look through the Subversion logs for all the details.
|
||||||
* New class: the :class:`Counter` class in the :mod:`collections` module is
|
* New class: the :class:`Counter` class in the :mod:`collections` module is
|
||||||
useful for tallying data. :class:`Counter` instances behave mostly
|
useful for tallying data. :class:`Counter` instances behave mostly
|
||||||
like dictionaries but return zero for missing keys instead of
|
like dictionaries but return zero for missing keys instead of
|
||||||
raising a :exc:`KeyError`::
|
raising a :exc:`KeyError`:
|
||||||
|
|
||||||
|
.. doctest::
|
||||||
|
:options: +NORMALIZE_WHITESPACE
|
||||||
|
|
||||||
>>> from collections import Counter
|
>>> from collections import Counter
|
||||||
>>> c=Counter()
|
>>> c = Counter()
|
||||||
>>> for letter in 'here is a sample of english text':
|
>>> for letter in 'here is a sample of english text':
|
||||||
... c[letter] += 1
|
... c[letter] += 1
|
||||||
...
|
...
|
||||||
|
@ -247,7 +250,7 @@ changes, or look through the Subversion logs for all the details.
|
||||||
'a', 'a', ' ', ' ', ' ', ' ', ' ', ' ',
|
'a', 'a', ' ', ' ', ' ', ' ', ' ', ' ',
|
||||||
'e', 'e', 'e', 'e', 'e', 'g', 'f', 'i', 'i',
|
'e', 'e', 'e', 'e', 'e', 'g', 'f', 'i', 'i',
|
||||||
'h', 'h', 'm', 'l', 'l', 'o', 'n', 'p', 's',
|
'h', 'h', 'm', 'l', 'l', 'o', 'n', 'p', 's',
|
||||||
's', 's', 'r', 't', 't', 'x']
|
's', 's', 'r', 't', 't', 'x'
|
||||||
|
|
||||||
Contributed by Raymond Hettinger; :issue:`1696199`.
|
Contributed by Raymond Hettinger; :issue:`1696199`.
|
||||||
|
|
||||||
|
@ -257,7 +260,8 @@ changes, or look through the Subversion logs for all the details.
|
||||||
renamed to legal names that are derived from the field's
|
renamed to legal names that are derived from the field's
|
||||||
position within the list of fields:
|
position within the list of fields:
|
||||||
|
|
||||||
>>> T=namedtuple('T', ['field1', '$illegal', 'for', 'field2'], rename=True)
|
>>> from collections import namedtuple
|
||||||
|
>>> T = namedtuple('T', ['field1', '$illegal', 'for', 'field2'], rename=True)
|
||||||
>>> T._fields
|
>>> T._fields
|
||||||
('field1', '_1', '_2', 'field2')
|
('field1', '_1', '_2', 'field2')
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue