RustPython · youknowone · Sep 7, 2025 · Aug 11, 2025 · Aug 11, 2025 · Aug 11, 2025
diff --git a/Lib/argparse.py b/Lib/argparse.py
@@ -1,3 +1,4 @@
+# upstream_version: v3.13.7
 # Author: Steven J. Bethard <[email protected]>.
 # New maintainer as of 29 August 2019:  Raymond Hettinger <[email protected]>
 

diff --git a/Lib/ast.py b/Lib/ast.py
@@ -1,3 +1,4 @@
+# upstream_version: v3.13.7
 """
 The `ast` module helps Python applications to process trees of the Python
 abstract syntax grammar.  The abstract syntax itself might change with

diff --git a/Lib/decimal.py b/Lib/decimal.py
@@ -1,3 +1,4 @@
+# upstream_version: v3.13.7
 """Decimal fixed-point and floating-point arithmetic.
 
 This is an implementation of decimal floating-point arithmetic based on

diff --git a/Lib/heapq.py b/Lib/heapq.py
@@ -1,3 +1,4 @@
+# upstream_version: v3.13.7
 """Heap queue algorithm (a.k.a. priority queue).
 
 Heaps are arrays for which a[k] <= a[2*k+1] and a[k] <= a[2*k+2] for

diff --git a/Lib/ipaddress.py b/Lib/ipaddress.py
@@ -1,3 +1,4 @@
+# upstream_version: v3.13.7
 # Copyright 2007 Google Inc.
 #  Licensed to PSF under a Contributor Agreement.
 

diff --git a/Lib/numbers.py b/Lib/numbers.py
@@ -1,3 +1,4 @@
+# upstream_version: v3.13.7
 # Copyright 2007 Google, Inc. All Rights Reserved.
 # Licensed to PSF under a Contributor Agreement.
 
@@ -290,18 +291,27 @@ def conjugate(self):
 
 
 class Rational(Real):
-    """.numerator and .denominator should be in lowest terms."""
+    """To Real, Rational adds numerator and denominator properties.
+
+    The numerator and denominator values should be in lowest terms,
+    with a positive denominator.
+    """
 
     __slots__ = ()
 
     @property
     @abstractmethod
     def numerator(self):
+        """The numerator of a rational number in lowest terms."""
         raise NotImplementedError
 
     @property
     @abstractmethod
     def denominator(self):
+        """The denominator of a rational number in lowest terms.
+
+        This denominator should be positive.
+        """
         raise NotImplementedError
 
     # Concrete implementation of Real's conversion to float.

diff --git a/Lib/os.py b/Lib/os.py
@@ -1,3 +1,4 @@
+# upstream_version: v3.13.7
 r"""OS routines for NT or Posix depending on what system we're on.
 
 This exports:
@@ -10,7 +11,7 @@
   - os.extsep is the extension separator (always '.')
   - os.altsep is the alternate pathname separator (None or '/')
   - os.pathsep is the component separator used in $PATH etc
-  - os.linesep is the line separator in text files ('\r' or '\n' or '\r\n')
+  - os.linesep is the line separator in text files ('\n' or '\r\n')
   - os.defpath is the default search path for executables
   - os.devnull is the file path of the null device ('/dev/null', etc.)
 

diff --git a/Lib/pprint.py b/Lib/pprint.py
@@ -1,3 +1,4 @@
+# upstream_version: v3.13.7
 #  Author:      Fred L. Drake, Jr.
 #               [email protected]
 #

diff --git a/Lib/queue.py b/Lib/queue.py
@@ -1,3 +1,4 @@
+# upstream_version: v3.13.7
 '''A multi-producer, multi-consumer queue.'''
 
 import threading
@@ -80,9 +81,6 @@ def task_done(self):
         have been processed (meaning that a task_done() call was received
         for every item that had been put() into the queue).
 
-        shutdown(immediate=True) calls task_done() for each remaining item in
-        the queue.
-
         Raises a ValueError if called more times than there were items
         placed in the queue.
         '''
@@ -239,9 +237,11 @@ def shutdown(self, immediate=False):
         By default, gets will only raise once the queue is empty. Set
         'immediate' to True to make gets raise immediately instead.
 
-        All blocked callers of put() and get() will be unblocked. If
-        'immediate', a task is marked as done for each item remaining in
-        the queue, which may unblock callers of join().
+        All blocked callers of put() and get() will be unblocked.
+
+        If 'immediate', the queue is drained and unfinished tasks
+        is reduced by the number of drained tasks.  If unfinished tasks
+        is reduced to zero, callers of Queue.join are unblocked.
         '''
         with self.mutex:
             self.is_shutdown = True