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)