From a592f84f50d4cf9b3621f76259c0e10981b27195 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Wed, 21 Sep 2022 06:11:48 -0700 Subject: [PATCH] gh-81039: Add small example of f-string's "=}" to tutorial (gh-92291) (gh-96989) (cherry picked from commit 4b81139aac3fa11779f6eedb6e621bde29e64b30) Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com> Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com> --- Doc/tutorial/inputoutput.rst | 12 +++++++++++- Doc/whatsnew/3.8.rst | 1 + 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/Doc/tutorial/inputoutput.rst b/Doc/tutorial/inputoutput.rst index d3414005a534..de84ab7fac8f 100644 --- a/Doc/tutorial/inputoutput.rst +++ b/Doc/tutorial/inputoutput.rst @@ -133,7 +133,17 @@ applies :func:`repr`:: >>> print(f'My hovercraft is full of {animals!r}.') My hovercraft is full of 'eels'. -For a reference on these format specifications, see +The ``=`` specifier can be used to expand an expression to the text of the +expression, an equal sign, then the representation of the evaluated expression: + + >>> bugs = 'roaches' + >>> count = 13 + >>> area = 'living room' + >>> print(f'Debugging {bugs=} {count=} {area=}') + Debugging bugs='roaches' count=13 area='living room' + +See :ref:`self-documenting expressions ` for more information +on the ``=`` specifier. For a reference on these format specifications, see the reference guide for the :ref:`formatspec`. .. _tut-string-format: diff --git a/Doc/whatsnew/3.8.rst b/Doc/whatsnew/3.8.rst index 7f3083b84123..7f85ff3ffa91 100644 --- a/Doc/whatsnew/3.8.rst +++ b/Doc/whatsnew/3.8.rst @@ -250,6 +250,7 @@ Android and Cygwin, whose cases are handled by the script); this change is backward incompatible on purpose. (Contributed by Victor Stinner in :issue:`36721`.) +.. _bpo-36817-whatsnew: f-strings support ``=`` for self-documenting expressions and debugging ---------------------------------------------------------------------- -- 2.47.3