Skip to content

Commit f200b70

Browse files
mattwang44mattwang44
committed
Deploying to gh-pages from @ 6a2d4f6 🚀
1 parent fde43e2 commit f200b70

File tree

556 files changed

+946
-655
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

556 files changed

+946
-655
lines changed

‎_sources/library/codecs.rst.txt

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1384,7 +1384,11 @@ encodings.
13841384
| | | It is used in the Python |
13851385
| | | pickle protocol. |
13861386
+--------------------+---------+---------------------------+
1387-
| undefined | | Raise an exception for |
1387+
| undefined | | This Codec should only |
1388+
| | | be used for testing |
1389+
| | | purposes. |
1390+
| | | |
1391+
| | | Raise an exception for |
13881392
| | | all conversions, even |
13891393
| | | empty strings. The error |
13901394
| | | handler is ignored. |

‎_sources/library/functools.rst.txt

Lines changed: 21 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -199,12 +199,18 @@ The :mod:`functools` module defines the following functions:
199199
and *typed*. This is for information purposes only. Mutating the values
200200
has no effect.
201201

202+
.. method:: lru_cache.cache_info()
203+
:no-typesetting:
204+
202205
To help measure the effectiveness of the cache and tune the *maxsize*
203-
parameter, the wrapped function is instrumented with a :func:`cache_info`
206+
parameter, the wrapped function is instrumented with a :func:`!cache_info`
204207
function that returns a :term:`named tuple` showing *hits*, *misses*,
205208
*maxsize* and *currsize*.
206209

207-
The decorator also provides a :func:`cache_clear` function for clearing or
210+
.. method:: lru_cache.cache_clear()
211+
:no-typesetting:
212+
213+
The decorator also provides a :func:`!cache_clear` function for clearing or
208214
invalidating the cache.
209215

210216
The original underlying function is accessible through the
@@ -284,9 +290,9 @@ The :mod:`functools` module defines the following functions:
284290
class decorator supplies the rest. This simplifies the effort involved
285291
in specifying all of the possible rich comparison operations:
286292

287-
The class must define one of :meth:`__lt__`, :meth:`__le__`,
288-
:meth:`__gt__`, or :meth:`__ge__`.
289-
In addition, the class should supply an :meth:`__eq__` method.
293+
The class must define one of :meth:`~object.__lt__`, :meth:`~object.__le__`,
294+
:meth:`~object.__gt__`, or :meth:`~object.__ge__`.
295+
In addition, the class should supply an :meth:`~object.__eq__` method.
290296

291297
For example::
292298

@@ -369,7 +375,7 @@ The :mod:`functools` module defines the following functions:
369375
like normal functions, are handled as descriptors).
370376

371377
When *func* is a descriptor (such as a normal Python function,
372-
:func:`classmethod`, :func:`staticmethod`, :func:`abstractmethod` or
378+
:func:`classmethod`, :func:`staticmethod`, :func:`~abc.abstractmethod` or
373379
another instance of :class:`partialmethod`), calls to ``__get__`` are
374380
delegated to the underlying descriptor, and an appropriate
375381
:ref:`partial object<partial-objects>` returned as the result.
@@ -447,7 +453,10 @@ The :mod:`functools` module defines the following functions:
447453
... print("Let me just say,", end=" ")
448454
... print(arg)
449455

450-
To add overloaded implementations to the function, use the :func:`register`
456+
.. method:: singledispatch.register()
457+
:no-typesetting:
458+
459+
To add overloaded implementations to the function, use the :func:`!register`
451460
attribute of the generic function, which can be used as a decorator. For
452461
functions annotated with types, the decorator will infer the type of the
453462
first argument automatically::
@@ -513,14 +522,14 @@ The :mod:`functools` module defines the following functions:
513522
runtime impact.
514523

515524
To enable registering :term:`lambdas<lambda>` and pre-existing functions,
516-
the :func:`register` attribute can also be used in a functional form::
525+
the :func:`~singledispatch.register` attribute can also be used in a functional form::
517526

518527
>>> def nothing(arg, verbose=False):
519528
... print("Nothing.")
520529
...
521530
>>> fun.register(type(None), nothing)
522531

523-
The :func:`register` attribute returns the undecorated function. This
532+
The :func:`~singledispatch.register` attribute returns the undecorated function. This
524533
enables decorator stacking, :mod:`pickling<pickle>`, and the creation
525534
of unit tests for each variant independently::
526535

@@ -598,10 +607,10 @@ The :mod:`functools` module defines the following functions:
598607
.. versionadded:: 3.4
599608

600609
.. versionchanged:: 3.7
601-
The :func:`register` attribute now supports using type annotations.
610+
The :func:`~singledispatch.register` attribute now supports using type annotations.
602611

603612
.. versionchanged:: 3.11
604-
The :func:`register` attribute now supports :data:`types.UnionType`
613+
The :func:`~singledispatch.register` attribute now supports :data:`types.UnionType`
605614
and :data:`typing.Union` as type annotations.
606615

607616

@@ -731,7 +740,7 @@ The :mod:`functools` module defines the following functions:
731740
'Docstring'
732741

733742
Without the use of this decorator factory, the name of the example function
734-
would have been ``'wrapper'``, and the docstring of the original :func:`example`
743+
would have been ``'wrapper'``, and the docstring of the original :func:`!example`
735744
would have been lost.
736745

737746

‎_sources/library/venv.rst.txt

Lines changed: 43 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -102,36 +102,52 @@ The command, if run with ``-h``, will show the available options::
102102

103103
Creates virtual Python environments in one or more target directories.
104104

105-
positional arguments:
106-
ENV_DIR A directory to create the environment in.
107-
108-
options:
109-
-h, --help show this help message and exit
110-
--system-site-packages
111-
Give the virtual environment access to the system
112-
site-packages dir.
113-
--symlinks Try to use symlinks rather than copies, when
114-
symlinks are not the default for the platform.
115-
--copies Try to use copies rather than symlinks, even when
116-
symlinks are the default for the platform.
117-
--clear Delete the contents of the environment directory
118-
if it already exists, before environment creation.
119-
--upgrade Upgrade the environment directory to use this
120-
version of Python, assuming Python has been
121-
upgraded in-place.
122-
--without-pip Skips installing or upgrading pip in the virtual
123-
environment (pip is bootstrapped by default)
124-
--prompt PROMPT Provides an alternative prompt prefix for this
125-
environment.
126-
--upgrade-deps Upgrade core dependencies (pip) to the latest
127-
version in PyPI
128-
--without-scm-ignore-files
129-
Skips adding SCM ignore files to the environment
130-
directory (Git is supported by default).
131-
132105
Once an environment has been created, you may wish to activate it, e.g. by
133106
sourcing an activate script in its bin directory.
134107

108+
.. _venv-cli:
109+
.. program:: venv
110+
111+
.. option:: ENV_DIR
112+
113+
A required argument specifying the directory to create the environment in.
114+
115+
.. option:: --system-site-packages
116+
117+
Give the virtual environment access to the system site-packages directory.
118+
119+
.. option:: --symlinks
120+
121+
Try to use symlinks rather than copies, when symlinks are not the default for the platform.
122+
123+
.. option:: --copies
124+
125+
Try to use copies rather than symlinks, even when symlinks are the default for the platform.
126+
127+
.. option:: --clear
128+
129+
Delete the contents of the environment directory if it already exists, before environment creation.
130+
131+
.. option:: --upgrade
132+
133+
Upgrade the environment directory to use this version of Python, assuming Python has been upgraded in-place.
134+
135+
.. option:: --without-pip
136+
137+
Skips installing or upgrading pip in the virtual environment (pip is bootstrapped by default).
138+
139+
.. option:: --prompt <PROMPT>
140+
141+
Provides an alternative prompt prefix for this environment.
142+
143+
.. option:: --upgrade-deps
144+
145+
Upgrade core dependencies (pip) to the latest version in PyPI.
146+
147+
.. option:: --without-scm-ignore-files
148+
149+
Skips adding SCM ignore files to the environment directory (Git is supported by default).
150+
135151

136152
.. versionchanged:: 3.4
137153
Installs pip by default, added the ``--without-pip`` and ``--copies``

‎about.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -320,7 +320,7 @@ <h3>瀏覽</h3>
320320
<a href="https://www.python.org/psf/donations/">Please donate.</a>
321321
<br>
322322
<br>
323-
最後更新於 7月 11, 2025 (10:18 UTC)。
323+
最後更新於 7月 12, 2025 (08:28 UTC)。
324324

325325
<a href="/bugs.html">Found a bug</a>?
326326

‎bugs.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -359,7 +359,7 @@ <h3>瀏覽</h3>
359359
<a href="https://www.python.org/psf/donations/">Please donate.</a>
360360
<br>
361361
<br>
362-
最後更新於 7月 11, 2025 (10:18 UTC)。
362+
最後更新於 7月 12, 2025 (08:28 UTC)。
363363

364364
<a href="/bugs.html">Found a bug</a>?
365365

‎c-api/abstract.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -329,7 +329,7 @@ <h3>瀏覽</h3>
329329
<a href="https://www.python.org/psf/donations/">Please donate.</a>
330330
<br>
331331
<br>
332-
最後更新於 7月 11, 2025 (10:18 UTC)。
332+
最後更新於 7月 12, 2025 (08:28 UTC)。
333333

334334
<a href="/bugs.html">Found a bug</a>?
335335

‎c-api/allocation.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -350,7 +350,7 @@ <h3>瀏覽</h3>
350350
<a href="https://www.python.org/psf/donations/">Please donate.</a>
351351
<br>
352352
<br>
353-
最後更新於 7月 11, 2025 (10:18 UTC)。
353+
最後更新於 7月 12, 2025 (08:28 UTC)。
354354

355355
<a href="/bugs.html">Found a bug</a>?
356356

‎c-api/apiabiversion.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -376,7 +376,7 @@ <h3>瀏覽</h3>
376376
<a href="https://www.python.org/psf/donations/">Please donate.</a>
377377
<br>
378378
<br>
379-
最後更新於 7月 11, 2025 (10:18 UTC)。
379+
最後更新於 7月 12, 2025 (08:28 UTC)。
380380

381381
<a href="/bugs.html">Found a bug</a>?
382382

‎c-api/arg.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -931,7 +931,7 @@ <h3>瀏覽</h3>
931931
<a href="https://www.python.org/psf/donations/">Please donate.</a>
932932
<br>
933933
<br>
934-
最後更新於 7月 11, 2025 (10:18 UTC)。
934+
最後更新於 7月 12, 2025 (08:28 UTC)。
935935

936936
<a href="/bugs.html">Found a bug</a>?
937937

‎c-api/bool.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -341,7 +341,7 @@ <h3>瀏覽</h3>
341341
<a href="https://www.python.org/psf/donations/">Please donate.</a>
342342
<br>
343343
<br>
344-
最後更新於 7月 11, 2025 (10:18 UTC)。
344+
最後更新於 7月 12, 2025 (08:28 UTC)。
345345

346346
<a href="/bugs.html">Found a bug</a>?
347347

0 commit comments

Comments
 (0)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy