Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit b2275c6

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

File tree

571 files changed

+5018
-4867
lines changed
Filter options

Some content is hidden

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

571 files changed

+5018
-4867
lines changed

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

Copy file name to clipboardExpand all lines: _sources/c-api/init.rst.txt
+4-4Lines 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

Copy file name to clipboardExpand all lines: _sources/c-api/typeobj.rst.txt
+1-1Lines 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

Copy file name to clipboardExpand all lines: _sources/c-api/unicode.rst.txt
+7Lines 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

Copy file name to clipboardExpand all lines: _sources/deprecations/pending-removal-in-3.15.rst.txt
+4Lines 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

Copy file name to clipboardExpand all lines: _sources/deprecations/pending-removal-in-future.rst.txt
-1Lines 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

Copy file name to clipboardExpand all lines: _sources/glossary.rst.txt
+7-2Lines 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

Copy file name to clipboardExpand all lines: _sources/library/asyncio-eventloop.rst.txt
+2-2Lines 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

Copy file name to clipboardExpand all lines: _sources/library/dbm.rst.txt
+1-1Lines 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

Copy file name to clipboardExpand all lines: _sources/library/idle.rst.txt
+7-4Lines 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 <guido@python.org>
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

Copy file name to clipboardExpand all lines: _sources/library/importlib.rst.txt
+6-6Lines 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

Copy file name to clipboardExpand all lines: _sources/library/logging.rst.txt
+6-4Lines 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

Copy file name to clipboardExpand all lines: _sources/library/plistlib.rst.txt
+1-1Lines 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

Copy file name to clipboardExpand all lines: _sources/library/smtplib.rst.txt
+1-1Lines 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

Copy file name to clipboardExpand all lines: _sources/library/socketserver.rst.txt
+5-2Lines 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

Copy file name to clipboardExpand all lines: _sources/library/unittest.mock.rst.txt
+1-1Lines 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

Copy file name to clipboardExpand all lines: _sources/reference/import.rst.txt
+2Lines 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

Copy file name to clipboardExpand all lines: _sources/using/editors.rst.txt
+13Lines 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

Copy file name to clipboardExpand all lines: _sources/using/unix.rst.txt
+25Lines 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

Copy file name to clipboardExpand all lines: _static/glossary.json
+1-1Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

‎about.html

Copy file name to clipboardExpand all lines: about.html
+1-1Lines 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

Copy file name to clipboardExpand all lines: bugs.html
+2-2Lines 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

Copy file name to clipboardExpand all lines: c-api/abstract.html
+1-1Lines 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

Copy file name to clipboardExpand all lines: c-api/allocation.html
+1-1Lines 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

Copy file name to clipboardExpand all lines: c-api/apiabiversion.html
+1-1Lines 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

Copy file name to clipboardExpand all lines: c-api/arg.html
+1-1Lines 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

Copy file name to clipboardExpand all lines: c-api/bool.html
+1-1Lines 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 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.