Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit b2275c6

Browse files
mattwang44mattwang44
committed
Deploying to gh-pages from @ 06b05d9 🚀
1 parent 28bee76 commit b2275c6

File tree

571 files changed

+5018
-4867
lines changed

Some content is hidden

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

571 files changed

+5018
-4867
lines changed

‎_sources/c-api/init.rst.txt

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -594,7 +594,7 @@ Process-wide parameters
594594
interpreter will change the contents of this storage.
595595
596596
Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a
597-
:c:expr:`wchar_*` string.
597+
:c:expr:`wchar_t*` string.
598598
599599
.. deprecated:: 3.11
600600
@@ -836,7 +836,7 @@ Process-wide parameters
836836
directory (``"."``).
837837
838838
Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a
839-
:c:expr:`wchar_*` string.
839+
:c:expr:`wchar_t*` string.
840840
841841
See also :c:member:`PyConfig.orig_argv` and :c:member:`PyConfig.argv`
842842
members of the :ref:`Python Initialization Configuration <init-config>`.
@@ -872,7 +872,7 @@ Process-wide parameters
872872
:option:`-I`.
873873
874874
Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a
875-
:c:expr:`wchar_*` string.
875+
:c:expr:`wchar_t*` string.
876876
877877
See also :c:member:`PyConfig.orig_argv` and :c:member:`PyConfig.argv`
878878
members of the :ref:`Python Initialization Configuration <init-config>`.
@@ -898,7 +898,7 @@ Process-wide parameters
898898
this storage.
899899
900900
Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a
901-
:c:expr:`wchar_*` string.
901+
:c:expr:`wchar_t*` string.
902902
903903
.. deprecated:: 3.11
904904

‎_sources/c-api/typeobj.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1829,7 +1829,7 @@ and :c:data:`PyType_Type` effectively act as defaults.)
18291829
dictionary, so it is may be more efficient to call :c:func:`PyObject_GetAttr`
18301830
when accessing an attribute on the object.
18311831

1832-
It is an error to set both the :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` bit and
1832+
It is an error to set both the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit and
18331833
:c:member:`~PyTypeObject.tp_dictoffset`.
18341834

18351835
**Inheritance:**

‎_sources/c-api/unicode.rst.txt

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1352,6 +1352,13 @@ the user settings on the machine running the codec.
13521352
in *consumed*.
13531353
13541354
1355+
.. c:function:: PyObject* PyUnicode_DecodeCodePageStateful(int code_page, const char *str, \
1356+
Py_ssize_t size, const char *errors, Py_ssize_t *consumed)
1357+
1358+
Similar to :c:func:`PyUnicode_DecodeMBCSStateful`, except uses the code page
1359+
specified by *code_page*.
1360+
1361+
13551362
.. c:function:: PyObject* PyUnicode_AsMBCSString(PyObject *unicode)
13561363
13571364
Encode a Unicode object using MBCS and return the result as Python bytes

‎_sources/deprecations/pending-removal-in-3.15.rst.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,10 @@ Pending Removal in Python 3.15
2929
* The :option:`!--cgi` flag to the :program:`python -m http.server`
3030
command-line interface has been deprecated since Python 3.13.
3131

32+
* :mod:`importlib`:
33+
34+
* ``load_module()`` method: use ``exec_module()`` instead.
35+
3236
* :class:`locale`:
3337

3438
* The :func:`~locale.getdefaultlocale` function

‎_sources/deprecations/pending-removal-in-future.rst.txt

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,6 @@ although there is currently no date scheduled for their removal.
5757

5858
* :mod:`importlib`:
5959

60-
* ``load_module()`` method: use ``exec_module()`` instead.
6160
* :func:`~importlib.util.cache_from_source` *debug_override* parameter is
6261
deprecated: use the *optimization* parameter instead.
6362

‎_sources/glossary.rst.txt

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -926,11 +926,16 @@ Glossary
926926
modules, respectively.
927927

928928
namespace package
929-
A :pep:`420` :term:`package` which serves only as a container for
930-
subpackages. Namespace packages may have no physical representation,
929+
A :term:`package` which serves only as a container for subpackages.
930+
Namespace packages may have no physical representation,
931931
and specifically are not like a :term:`regular package` because they
932932
have no ``__init__.py`` file.
933933

934+
Namespace packages allow several individually installable packages to have a common parent package.
935+
Otherwise, it is recommended to use a :term:`regular package`.
936+
937+
For more information, see :pep:`420` and :ref:`reference-namespace-package`.
938+
934939
See also :term:`module`.
935940

936941
nested scope

‎_sources/library/asyncio-eventloop.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -382,9 +382,9 @@ Creating Futures and Tasks
382382

383383
If *factory* is ``None`` the default task factory will be set.
384384
Otherwise, *factory* must be a *callable* with the signature matching
385-
``(loop, coro, context=None)``, where *loop* is a reference to the active
385+
``(loop, coro, **kwargs)``, where *loop* is a reference to the active
386386
event loop, and *coro* is a coroutine object. The callable
387-
must return a :class:`asyncio.Future`-compatible object.
387+
must pass on all *kwargs*, and return a :class:`asyncio.Task`-compatible object.
388388

389389
.. method:: loop.get_task_factory()
390390

‎_sources/library/dbm.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -455,7 +455,7 @@ The :mod:`!dbm.dumb` module defines the following:
455455
.. method:: dumbdbm.sync()
456456

457457
Synchronize the on-disk directory and data files. This method is called
458-
by the :meth:`Shelve.sync` method.
458+
by the :meth:`shelve.Shelf.sync` method.
459459

460460
.. method:: dumbdbm.close()
461461

‎_sources/library/idle.rst.txt

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
.. _idle:
22

3-
IDLE
4-
====
3+
IDLE --- Python editor and shell
4+
================================
55

66
.. moduleauthor:: Guido van Rossum <[email protected]>
77

@@ -12,6 +12,9 @@ IDLE
1212
single: Python Editor
1313
single: Integrated Development Environment
1414

15+
..
16+
Remember to update Lib/idlelib/help.html with idlelib.help.copy_source() when modifying this file.
17+
1518
--------------
1619

1720
IDLE is Python's Integrated Development and Learning Environment.
@@ -971,8 +974,8 @@ information. The only current default extension is zzdummy, an example
971974
also used for testing.
972975

973976

974-
idlelib
975-
-------
977+
idlelib --- implementation of IDLE application
978+
----------------------------------------------
976979

977980
.. module:: idlelib
978981
:synopsis: Implementation package for the IDLE shell/editor.

‎_sources/library/importlib.rst.txt

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -370,7 +370,7 @@ ABC hierarchy::
370370
:exc:`NotImplementedError`. Functionality provided when
371371
:meth:`exec_module` is available.
372372

373-
.. deprecated:: 3.4
373+
.. deprecated-removed:: 3.4 3.15
374374
The recommended API for loading a module is :meth:`exec_module`
375375
(and :meth:`create_module`). Loaders should implement it instead of
376376
:meth:`load_module`. The import machinery takes care of all the
@@ -474,7 +474,7 @@ ABC hierarchy::
474474

475475
Implementation of :meth:`Loader.load_module`.
476476

477-
.. deprecated:: 3.4
477+
.. deprecated-removed:: 3.4 3.15
478478
use :meth:`exec_module` instead.
479479

480480

@@ -521,7 +521,7 @@ ABC hierarchy::
521521

522522
Calls super's ``load_module()``.
523523

524-
.. deprecated:: 3.4
524+
.. deprecated-removed:: 3.4 3.15
525525
Use :meth:`Loader.exec_module` instead.
526526

527527
.. abstractmethod:: get_filename(fullname)
@@ -610,7 +610,7 @@ ABC hierarchy::
610610

611611
Concrete implementation of :meth:`Loader.load_module`.
612612

613-
.. deprecated:: 3.4
613+
.. deprecated-removed:: 3.4 3.15
614614
Use :meth:`exec_module` instead.
615615

616616
.. method:: get_source(fullname)
@@ -1020,7 +1020,7 @@ find and load modules.
10201020
Concrete implementation of :meth:`importlib.abc.Loader.load_module` where
10211021
specifying the name of the module to load is optional.
10221022

1023-
.. deprecated:: 3.6
1023+
.. deprecated-removed:: 3.6 3.15
10241024

10251025
Use :meth:`importlib.abc.Loader.exec_module` instead.
10261026

@@ -1063,7 +1063,7 @@ find and load modules.
10631063
Concrete implementation of :meth:`importlib.abc.Loader.load_module` where
10641064
specifying the name of the module to load is optional.
10651065

1066-
.. deprecated:: 3.6
1066+
.. deprecated-removed:: 3.6 3.15
10671067

10681068
Use :meth:`importlib.abc.Loader.exec_module` instead.
10691069

‎_sources/library/logging.rst.txt

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -592,10 +592,12 @@ subclasses. However, the :meth:`!__init__` method in subclasses needs to call
592592

593593
.. method:: Handler.close()
594594

595-
Tidy up any resources used by the handler. This version does no output but
596-
removes the handler from an internal list of handlers which is closed when
597-
:func:`shutdown` is called. Subclasses should ensure that this gets called
598-
from overridden :meth:`close` methods.
595+
Tidy up any resources used by the handler. This version does no output
596+
but removes the handler from an internal map of handlers, which is used
597+
for handler lookup by name.
598+
599+
Subclasses should ensure that this gets called from overridden :meth:`close`
600+
methods.
599601

600602

601603
.. method:: Handler.handle(record)

‎_sources/library/plistlib.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ This module defines the following functions:
9999

100100
.. function:: dump(value, fp, *, fmt=FMT_XML, sort_keys=True, skipkeys=False, aware_datetime=False)
101101

102-
Write *value* to a plist file. *Fp* should be a writable, binary
102+
Write *value* to a plist file. *fp* should be a writable, binary
103103
file object.
104104

105105
The *fmt* argument specifies the format of the plist file and can be

‎_sources/library/smtplib.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -524,7 +524,7 @@ An :class:`SMTP` instance has the following methods:
524524
:mailheader:`Bcc` or :mailheader:`Resent-Bcc` headers that may appear
525525
in *msg*. If any of the addresses in *from_addr* and *to_addrs* contain
526526
non-ASCII characters and the server does not advertise ``SMTPUTF8`` support,
527-
an :exc:`SMTPNotSupported` error is raised. Otherwise the ``Message`` is
527+
an :exc:`SMTPNotSupportedError` is raised. Otherwise the ``Message`` is
528528
serialized with a clone of its :mod:`~email.policy` with the
529529
:attr:`~email.policy.EmailPolicy.utf8` attribute set to ``True``, and
530530
``SMTPUTF8`` and ``BODY=8BITMIME`` are added to *mail_options*.

‎_sources/library/socketserver.rst.txt

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -260,8 +260,11 @@ Server Objects
260260

261261
.. attribute:: address_family
262262

263-
The family of protocols to which the server's socket belongs.
264-
Common examples are :const:`socket.AF_INET` and :const:`socket.AF_UNIX`.
263+
The family of protocols to which the server's socket belongs. Common
264+
examples are :const:`socket.AF_INET`, :const:`socket.AF_INET6`, and
265+
:const:`socket.AF_UNIX`. Subclass the TCP or UDP server classes in this
266+
module with class attribute ``address_family = AF_INET6`` set if you
267+
want IPv6 server classes.
265268

266269

267270
.. attribute:: RequestHandlerClass

‎_sources/library/unittest.mock.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1984,7 +1984,7 @@ Imagine we have a project that we want to test with the following structure::
19841984

19851985
Now we want to test ``some_function`` but we want to mock out ``SomeClass`` using
19861986
:func:`patch`. The problem is that when we import module b, which we will have to
1987-
do then it imports ``SomeClass`` from module a. If we use :func:`patch` to mock out
1987+
do when it imports ``SomeClass`` from module a. If we use :func:`patch` to mock out
19881988
``a.SomeClass`` then it will have no effect on our test; module b already has a
19891989
reference to the *real* ``SomeClass`` and it looks like our patching had no
19901990
effect.

‎_sources/reference/import.rst.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -123,6 +123,8 @@ Importing ``parent.one`` will implicitly execute ``parent/__init__.py`` and
123123
``parent/three/__init__.py`` respectively.
124124

125125

126+
.. _reference-namespace-package:
127+
126128
Namespace packages
127129
------------------
128130

‎_sources/using/editors.rst.txt

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,19 @@
99
There are a number of IDEs that support Python programming language.
1010
Many editors and IDEs provide syntax highlighting, debugging tools, and :pep:`8` checks.
1111

12+
13+
IDLE --- Python editor and shell
14+
================================
15+
16+
IDLE is Python’s Integrated Development and Learning Environment and is generally bundled with Python installs.
17+
If you are on Linux and do not have IDLE installed see :ref:`Installing IDLE on Linux <installing_idle_on_linux>`.
18+
For more information see the :ref:`IDLE docs <idle>`.
19+
20+
21+
Other Editors and IDEs
22+
======================
23+
24+
Python's community wiki has information submitted by the community on Editors and IDEs.
1225
Please go to `Python Editors <https://wiki.python.org/moin/PythonEditors>`_ and
1326
`Integrated Development Environments <https://wiki.python.org/moin/IntegratedDevelopmentEnvironments>`_
1427
for a comprehensive list.

‎_sources/using/unix.rst.txt

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,31 @@ look at the following links:
3535
https://slackbook.org/html/package-management-making-packages.html
3636
for Slackware users
3737

38+
.. _installing_idle_on_linux:
39+
40+
Installing IDLE
41+
~~~~~~~~~~~~~~~
42+
43+
In some cases, IDLE might not be included in your Python installation.
44+
45+
* For Debian and Ubuntu users::
46+
47+
sudo apt update
48+
sudo apt install idle
49+
50+
* For Fedora, RHEL, and CentOS users::
51+
52+
sudo dnf install python3-idle
53+
54+
* For SUSE and OpenSUSE users::
55+
56+
sudo zypper in python3-idle
57+
58+
* For Alpine Linux users::
59+
60+
sudo apk add python3-idle
61+
62+
3863

3964
On FreeBSD and OpenBSD
4065
----------------------

‎_static/glossary.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

‎about.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -319,7 +319,7 @@ <h3>瀏覽</h3>
319319
<a href="https://www.python.org/psf/donations/">Please donate.</a>
320320
<br />
321321
<br />
322-
最後更新於 2月 08, 2025 (17:17 UTC)。
322+
最後更新於 2月 15, 2025 (16:38 UTC)。
323323

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

‎bugs.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -230,7 +230,7 @@ <h2>說明文件的錯誤<a class="headerlink" href="#documentation-bugs" title=
230230
</section>
231231
<section id="getting-started-contributing-to-python-yourself">
232232
<span id="contributing-to-python"></span><h2>開始讓自己貢獻 Python<a class="headerlink" href="#getting-started-contributing-to-python-yourself" title="連結到這個標頭"></a></h2>
233-
<p>除了只是回報你所發現的錯誤之外，同樣也歡迎你提交修正它們的修補程式 (patch)。你可以在 <a class="reference external" href="https://mail.python.org/mailman3/lists/core-mentorship.python.org/">Python 開發者指南</a>中找到如何開始修補 Python 的更多資訊。如果你有任何問題，<a class="reference external" href="https://devguide.python.org/">核心導師郵寄清單</a>是一個友善的地方，你可以在那裡得到，關於 Python 修正錯誤的過程中，所有問題的答案。</p>
233+
<p>除了只是回報你所發現的錯誤之外，同樣也歡迎你提交修正它們的修補程式 (patch)。你可以在 <a class="reference external" href="https://devguide.python.org/">Python 開發者指南</a>中找到如何開始修補 Python 的更多資訊。如果你有任何問題，<a class="reference external" href="https://mail.python.org/mailman3/lists/core-mentorship.python.org/">核心導師郵寄清單</a>是一個友善的地方，你可以在那裡得到，關於 Python 修正錯誤的過程中，所有問題的答案。</p>
234234
</section>
235235
</section>
236236

@@ -358,7 +358,7 @@ <h3>瀏覽</h3>
358358
<a href="https://www.python.org/psf/donations/">Please donate.</a>
359359
<br />
360360
<br />
361-
最後更新於 2月 08, 2025 (17:17 UTC)。
361+
最後更新於 2月 15, 2025 (16:38 UTC)。
362362

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

‎c-api/abstract.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -328,7 +328,7 @@ <h3>瀏覽</h3>
328328
<a href="https://www.python.org/psf/donations/">Please donate.</a>
329329
<br />
330330
<br />
331-
最後更新於 2月 08, 2025 (17:17 UTC)。
331+
最後更新於 2月 15, 2025 (16:38 UTC)。
332332

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

‎c-api/allocation.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -343,7 +343,7 @@ <h3>瀏覽</h3>
343343
<a href="https://www.python.org/psf/donations/">Please donate.</a>
344344
<br />
345345
<br />
346-
最後更新於 2月 08, 2025 (17:17 UTC)。
346+
最後更新於 2月 15, 2025 (16:38 UTC)。
347347

348348
<a href="/bugs.html">Found a bug</a>?
349349

‎c-api/apiabiversion.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -375,7 +375,7 @@ <h3>瀏覽</h3>
375375
<a href="https://www.python.org/psf/donations/">Please donate.</a>
376376
<br />
377377
<br />
378-
最後更新於 2月 08, 2025 (17:17 UTC)。
378+
最後更新於 2月 15, 2025 (16:38 UTC)。
379379

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

‎c-api/arg.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -928,7 +928,7 @@ <h3>瀏覽</h3>
928928
<a href="https://www.python.org/psf/donations/">Please donate.</a>
929929
<br />
930930
<br />
931-
最後更新於 2月 08, 2025 (17:17 UTC)。
931+
最後更新於 2月 15, 2025 (16:38 UTC)。
932932

933933
<a href="/bugs.html">Found a bug</a>?
934934

‎c-api/bool.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -340,7 +340,7 @@ <h3>瀏覽</h3>
340340
<a href="https://www.python.org/psf/donations/">Please donate.</a>
341341
<br />
342342
<br />
343-
最後更新於 2月 08, 2025 (17:17 UTC)。
343+
最後更新於 2月 15, 2025 (16:38 UTC)。
344344

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

0 commit comments

Comments
 (0)