Deploying to gh-pages from @ 1a30c43 🚀

python · Jun 2, 2024 · 30f72ee · 30f72ee
1 parent c698d13
commit 30f72ee
Show file tree

Hide file tree

Showing 529 changed files with 559 additions and 542 deletions.
diff --git a/.buildinfo b/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 245d3ca516eb8b760ee179bdc9c9e27a
+config: b5f2ce9acaa5f47f79bb65a7af64d2e7
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/_sources/library/itertools.rst.txt b/_sources/library/itertools.rst.txt
@@ -849,15 +849,15 @@ and :term:`generators <generator>` which incur interpreter overhead.
        return len(take(2, groupby(iterable, key))) <= 1
 
    def unique_justseen(iterable, key=None):
-       "List unique elements, preserving order. Remember only the element just seen."
+       "Yield unique elements, preserving order. Remember only the element just seen."
        # unique_justseen('AAAABBBCCDAABBB') → A B C D A B
        # unique_justseen('ABBcCAD', str.casefold) → A B c A D
        if key is None:
            return map(operator.itemgetter(0), groupby(iterable))
        return map(next, map(operator.itemgetter(1), groupby(iterable, key)))
 
    def unique_everseen(iterable, key=None):
-       "List unique elements, preserving order. Remember all elements ever seen."
+       "Yield unique elements, preserving order. Remember all elements ever seen."
        # unique_everseen('AAAABBBCCDAABBB') → A B C D
        # unique_everseen('ABBcCAD', str.casefold) → A B c D
        seen = set()
@@ -872,6 +872,11 @@ and :term:`generators <generator>` which incur interpreter overhead.
                    seen.add(k)
                    yield element
 
+   def unique(iterable, key=None, reverse=False):
+      "Yield unique elements in sorted order. Supports unhashable inputs."
+      # unique([[1, 2], [3, 4], [1, 2]]) → [1, 2] [3, 4]
+      return unique_justseen(sorted(iterable, key=key, reverse=reverse), key=key)
+
    def sliding_window(iterable, n):
        "Collect data into overlapping fixed-length chunks or blocks."
        # sliding_window('ABCDEFG', 4) → ABCD BCDE CDEF DEFG
@@ -1593,6 +1598,13 @@ The following recipes have a more mathematical flavor:
     >>> ''.join(input_iterator)
     'AAABBBCCDAABBB'
 
+    >>> list(unique([[1, 2], [3, 4], [1, 2]]))
+    [[1, 2], [3, 4]]
+    >>> list(unique('ABBcCAD', str.casefold))
+    ['A', 'B', 'c', 'D']
+    >>> list(unique('ABBcCAD', str.casefold, reverse=True))
+    ['D', 'c', 'B', 'A']
+
     >>> d = dict(a=1, b=2, c=3)
     >>> it = iter_except(d.popitem, KeyError)
     >>> d['d'] = 4

diff --git a/_sources/tutorial/classes.rst.txt b/_sources/tutorial/classes.rst.txt
@@ -338,11 +338,7 @@ code will print the value ``16``, without leaving a trace::
    del x.counter
 
 The other kind of instance attribute reference is a *method*. A method is a
-function that "belongs to" an object.  (In Python, the term method is not unique
-to class instances: other object types can have methods as well.  For example,
-list objects have methods called append, insert, remove, sort, and so on.
-However, in the following discussion, we'll use the term method exclusively to
-mean methods of class instance objects, unless explicitly stated otherwise.)
+function that "belongs to" an object.
 
 .. index:: pair: object; method
 

diff --git a/about.html b/about.html
@@ -401,7 +401,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/bugs.html b/bugs.html
@@ -440,7 +440,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/abstract.html b/c-api/abstract.html
@@ -411,7 +411,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/allocation.html b/c-api/allocation.html
@@ -425,7 +425,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/apiabiversion.html b/c-api/apiabiversion.html
@@ -457,7 +457,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/arg.html b/c-api/arg.html
@@ -968,7 +968,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/bool.html b/c-api/bool.html
@@ -422,7 +422,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/buffer.html b/c-api/buffer.html
@@ -1095,7 +1095,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/bytearray.html b/c-api/bytearray.html
@@ -478,7 +478,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/bytes.html b/c-api/bytes.html
@@ -602,7 +602,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/call.html b/c-api/call.html
@@ -737,7 +737,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/capsule.html b/c-api/capsule.html
@@ -522,7 +522,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/cell.html b/c-api/cell.html
@@ -421,7 +421,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/code.html b/c-api/code.html
@@ -677,7 +677,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/codec.html b/c-api/codec.html
@@ -526,7 +526,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/complex.html b/c-api/complex.html
@@ -510,7 +510,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/concrete.html b/c-api/concrete.html
@@ -545,7 +545,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/contextvars.html b/c-api/contextvars.html
@@ -532,7 +532,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/conversion.html b/c-api/conversion.html
@@ -471,7 +471,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/coro.html b/c-api/coro.html
@@ -400,7 +400,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/datetime.html b/c-api/datetime.html
@@ -711,7 +711,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/descriptor.html b/c-api/descriptor.html
@@ -415,7 +415,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/dict.html b/c-api/dict.html
@@ -724,7 +724,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/exceptions.html b/c-api/exceptions.html
@@ -1771,7 +1771,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/file.html b/c-api/file.html
@@ -447,7 +447,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/float.html b/c-api/float.html
@@ -570,7 +570,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/frame.html b/c-api/frame.html
@@ -581,7 +581,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/function.html b/c-api/function.html
@@ -549,7 +549,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/gcsupport.html b/c-api/gcsupport.html
@@ -692,7 +692,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/gen.html b/c-api/gen.html
@@ -409,7 +409,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/hash.html b/c-api/hash.html
@@ -431,7 +431,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/import.html b/c-api/import.html
@@ -700,7 +700,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/index.html b/c-api/index.html
@@ -498,7 +498,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/init.html b/c-api/init.html
@@ -2556,7 +2556,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/init_config.html b/c-api/init_config.html
@@ -2006,7 +2006,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/intro.html b/c-api/intro.html
@@ -839,7 +839,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/iter.html b/c-api/iter.html
@@ -442,7 +442,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Jun 01, 2024 (08:45 UTC)。
+      最後更新於 Jun 02, 2024 (14:44 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?