Merge pull request #502 from python/main

Sync Fork from Upstream Repo

Author: sthagen

Doc/library/numbers.rst

@@ -10,7 +10,7 @@
 
 The :mod:`numbers` module (:pep:`3141`) defines a hierarchy of numeric
 :term:`abstract base classes <abstract base class>` which progressively define
-more operations.  None of the types defined in this module can be instantiated.
+more operations.  None of the types defined in this module are intended to be instantiated.
 
 
 .. class:: Number

Doc/library/os.rst

@@ -4635,7 +4635,7 @@ operating system.
 
 .. function:: sched_setparam(pid, param)
 
-   Set a scheduling parameters for the process with PID *pid*. A *pid* of 0 means
+   Set the scheduling parameters for the process with PID *pid*. A *pid* of 0 means
    the calling process. *param* is a :class:`sched_param` instance.
 
 

Doc/library/statistics.rst

@@ -631,25 +631,25 @@ However, for reading convenience, most of the examples show sorted sequences.
    Return the intercept and slope of `simple linear regression
    <https://en.wikipedia.org/wiki/Simple_linear_regression>`_
    parameters estimated using ordinary least squares. Simple linear
-   regression describes relationship between *regressor* and
-   *dependent variable* in terms of linear function:
+   regression describes the relationship between *regressor* and
+   *dependent variable* in terms of this linear function:
 
       *dependent_variable = intercept + slope \* regressor + noise*
 
    where ``intercept`` and ``slope`` are the regression parameters that are
-   estimated, and noise term is an unobserved random variable, for the
+   estimated, and noise represents the
    variability of the data that was not explained by the linear regression
-   (it is equal to the difference between prediction and the actual values
+   (it is equal to the difference between predicted and actual values
    of dependent variable).
 
    Both inputs must be of the same length (no less than two), and regressor
-   needs not to be constant, otherwise :exc:`StatisticsError` is raised.
+   needs not to be constant; otherwise :exc:`StatisticsError` is raised.
 
-   For example, if we took the data on the data on `release dates of the Monty
+   For example, we can use the `release dates of the Monty
    Python films <https://en.wikipedia.org/wiki/Monty_Python#Films>`_, and used
-   it to predict the cumulative number of Monty Python films produced, we could
-   predict what would be the number of films they could have made till year
-   2019, assuming that they kept the pace.
+   it to predict the cumulative number of Monty Python films
+   that would have been produced by 2019
+   assuming that they kept the pace.
 
    .. doctest::
 
@@ -659,14 +659,6 @@ However, for reading convenience, most of the examples show sorted sequences.
       >>> round(intercept + slope * 2019)
       16
 
-   We could also use it to "predict" how many Monty Python films existed when
-   Brian Cohen was born.
-
-   .. doctest::
-
-      >>> round(intercept + slope * 1)
-      -610
-
    .. versionadded:: 3.10
 
 

Doc/whatsnew/3.10.rst

@@ -215,9 +215,9 @@ have been incorporated. Some of the most notable ones:
 
     .. code-block:: python
 
-        >>> {x,y for x,y in range(100)}
+        >>> {x,y for x,y in zip('abcd', '1234')}
           File "<stdin>", line 1
-            {x,y for x,y in range(100)}
+            {x,y for x,y in zip('abcd', '1234')}
              ^
         SyntaxError: did you forget parentheses around the comprehension target?
 

Include/opcode.h

@@ -640,7 +640,8 @@ class Param(expr_context):
 class _Precedence:
     """Precedence table that originated from python grammar."""
 
-    TUPLE = auto()
+    NAMED_EXPR = auto()      # <target> := <expr1>
+    TUPLE = auto()           # <expr1>, <expr2>
     YIELD = auto()           # 'yield', 'yield from'
     TEST = auto()            # 'if'-'else', 'lambda'
     OR = auto()              # 'or'
@@ -716,9 +717,9 @@ def fill(self, text=""):
         self.maybe_newline()
         self.write("    " * self._indent + text)
 
-    def write(self, text):
-        """Append a piece of text"""
-        self._source.append(text)
+    def write(self, *text):
+        """Add new source parts"""
+        self._source.extend(text)
 
     @contextmanager
     def buffered(self, buffer = None):
@@ -838,7 +839,7 @@ def visit_Expr(self, node):
         self.traverse(node.value)
 
     def visit_NamedExpr(self, node):
-        with self.require_parens(_Precedence.TUPLE, node):
+        with self.require_parens(_Precedence.NAMED_EXPR, node):
             self.set_precedence(_Precedence.ATOM, node.target, node.value)
             self.traverse(node.target)
             self.write(" := ")
@@ -859,6 +860,7 @@ def visit_ImportFrom(self, node):
     def visit_Assign(self, node):
         self.fill()
         for target in node.targets:
+            self.set_precedence(_Precedence.TUPLE, target)
             self.traverse(target)
             self.write(" = ")
         self.traverse(node.value)
@@ -1030,6 +1032,7 @@ def visit_AsyncFor(self, node):
 
     def _for_helper(self, fill, node):
         self.fill(fill)
+        self.set_precedence(_Precedence.TUPLE, node.target)
         self.traverse(node.target)
         self.write(" in ")
         self.traverse(node.iter)
@@ -1315,7 +1318,7 @@ def write_item(item):
             )
 
     def visit_Tuple(self, node):
-        with self.delimit("(", ")"):
+        with self.require_parens(_Precedence.TUPLE, node):
             self.items_view(self.traverse, node.elts)
 
     unop = {"Invert": "~", "Not": "not", "UAdd": "+", "USub": "-"}
@@ -1566,8 +1569,11 @@ def visit_keyword(self, node):
 
     def visit_Lambda(self, node):
         with self.require_parens(_Precedence.TEST, node):
-            self.write("lambda ")
-            self.traverse(node.args)
+            self.write("lambda")
+            with self.buffered() as buffer:
+                self.traverse(node.args)
+            if buffer:
+                self.write(" ", *buffer)
             self.write(": ")
             self.set_precedence(_Precedence.TEST, node.body)
             self.traverse(node.body)

Lib/ast.py

@@ -119,7 +119,7 @@ def dispatch_call(self, frame, arg):
         """Invoke user function and return trace function for call event.
 
         If the debugger stops on this function call, invoke
-        self.user_call(). Raise BbdQuit if self.quitting is set.
+        self.user_call(). Raise BdbQuit if self.quitting is set.
         Return self.trace_dispatch to continue tracing in this scope.
         """
         # XXX 'arg' is no longer used

Lib/bdb.py

@@ -735,7 +735,7 @@ def __bool__(a):
     # support for pickling, copy, and deepcopy
 
     def __reduce__(self):
-        return (self.__class__, (str(self),))
+        return (self.__class__, (self._numerator, self._denominator))
 
     def __copy__(self):
         if type(self) == Fraction:

Lib/fractions.py

@@ -521,7 +521,7 @@ def _add_read_data(self, data):
 
     def _read_eof(self):
         # We've read to the end of the file
-        # We check the that the computed CRC and size of the
+        # We check that the computed CRC and size of the
         # uncompressed data matches the stored values.  Note that the size
         # stored is the true file size mod 2**32.
         crc32, isize = struct.unpack("<II", self._read_exact(8))

Lib/gzip.py

@@ -353,6 +353,7 @@ def _write_atomic(path, data, mode=0o666):
 #     Python 3.10b1 3438 Safer line number table handling.
 #     Python 3.10b1 3439 (Add ROT_N)
 #     Python 3.11a1 3450 Use exception table for unwinding ("zero cost" exception handling)
+#     Python 3.11a1 3451 (Add CALL_METHOD_KW)
 
 #
 # MAGIC must change whenever the bytecode emitted by the compiler may no
@@ -362,7 +363,7 @@ def _write_atomic(path, data, mode=0o666):
 # Whenever MAGIC_NUMBER is changed, the ranges in the magic_values array
 # in PC/launcher.c must also be updated.
 
-MAGIC_NUMBER = (3450).to_bytes(2, 'little') + b'\r\n'
+MAGIC_NUMBER = (3451).to_bytes(2, 'little') + b'\r\n'
 _RAW_MAGIC_NUMBER = int.from_bytes(MAGIC_NUMBER, 'little')  # For import.c
 
 _PYCACHE = '__pycache__'