[Python-checkins] bpo-34798: [doc] clearer presentation of pprint.PrettyPrinter constru… (GH-26967) (GH-26990)
iritkatriel
webhook-mailer at python.org
Fri Jul 2 06:08:08 EDT 2021
https://github.com/python/cpython/commit/42c26282a123d14591e1aa31107e566b302a19ac
commit: 42c26282a123d14591e1aa31107e566b302a19ac
branch: 3.10
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: iritkatriel <1055913+iritkatriel at users.noreply.github.com>
date: 2021-07-02T11:07:50+01:00
summary:
bpo-34798: [doc] clearer presentation of pprint.PrettyPrinter constru… (GH-26967) (GH-26990)
(cherry picked from commit 943e77d42d3f84b581f32c05f1fc8c05366b8ed3)
Co-authored-by: Irit Katriel <1055913+iritkatriel at users.noreply.github.com>
files:
A Misc/NEWS.d/next/Library/2021-06-30-13-29-49.bpo-34798.t7FCa0.rst
M Doc/library/pprint.rst
diff --git a/Doc/library/pprint.rst b/Doc/library/pprint.rst
index f45c66fd9f46f..8f374503725ad 100644
--- a/Doc/library/pprint.rst
+++ b/Doc/library/pprint.rst
@@ -42,24 +42,36 @@ The :mod:`pprint` module defines one class:
compact=False, sort_dicts=True, underscore_numbers=False)
Construct a :class:`PrettyPrinter` instance. This constructor understands
- several keyword parameters. An output stream may be set using the *stream*
- keyword; the only method used on the stream object is the file protocol's
- :meth:`write` method. If not specified, the :class:`PrettyPrinter` adopts
- ``sys.stdout``. The
- amount of indentation added for each recursive level is specified by *indent*;
- the default is one. Other values can cause output to look a little odd, but can
- make nesting easier to spot. The number of levels which may be printed is
- controlled by *depth*; if the data structure being printed is too deep, the next
- contained level is replaced by ``...``. By default, there is no constraint on
- the depth of the objects being formatted. The desired output width is
- constrained using the *width* parameter; the default is 80 characters. If a
- structure cannot be formatted within the constrained width, a best effort will
- be made. If *compact* is false (the default) each item of a long sequence
- will be formatted on a separate line. If *compact* is true, as many items
- as will fit within the *width* will be formatted on each output line. If
- *sort_dicts* is true (the default), dictionaries will be formatted with their
- keys sorted, otherwise they will display in insertion order. If
- *underscore_numbers* is true, integers will be formatted with the
+ several keyword parameters.
+
+ *stream* (default ``sys.stdout``) is a :term:`file-like object` to
+ which the output will be written by calling its :meth:`write` method.
+
+ Other values configure the manner in which nesting of complex data
+ structures is displayed.
+
+ *indent* (default 1) specifies the amount of indentation added for
+ each nesting level.
+
+ *depth* controls the number of nesting levels which may be printed; if
+ the data structure being printed is too deep, the next contained level
+ is replaced by ``...``. By default, there is no constraint on the
+ depth of the objects being formatted.
+
+ *width* (default 80) specifies the desired maximum number of characters per
+ line in the output. If a structure cannot be formatted within the width
+ constraint, a best effort will be made.
+
+ *compact* impacts the way that long sequences (lists, tuples, sets, etc)
+ are formatted. If *compact* is false (the default) then each item of a
+ sequence will be formatted on a separate line. If *compact* is true, as
+ many items as will fit within the *width* will be formatted on each output
+ line.
+
+ If *sort_dicts* is true (the default), dictionaries will be formatted with
+ their keys sorted, otherwise they will display in insertion order.
+
+ If *underscore_numbers* is true, integers will be formatted with the
``_`` character for a thousands separator, otherwise underscores are not
displayed (the default).
diff --git a/Misc/NEWS.d/next/Library/2021-06-30-13-29-49.bpo-34798.t7FCa0.rst b/Misc/NEWS.d/next/Library/2021-06-30-13-29-49.bpo-34798.t7FCa0.rst
new file mode 100644
index 0000000000000..ab9fd8e33799d
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2021-06-30-13-29-49.bpo-34798.t7FCa0.rst
@@ -0,0 +1 @@
+Break up paragraph about :class:`pprint.PrettyPrinter` construction parameters to make it easier to read.
\ No newline at end of file
More information about the Python-checkins
mailing list