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 cb1641b

Browse filesBrowse files
mattwang44mattwang44
committed
Deploying to gh-pages from @ e2bf6ce 🚀
1 parent 90722a8 commit cb1641b
Copy full SHA for cb1641b

File tree

598 files changed

+9931
-9135
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

598 files changed

+9931
-9135
lines changed

‎.buildinfo

Copy file name to clipboard
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# Sphinx build info version 1
22
# This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
3-
config: 6cf0775369be5d8a262285b94041e119
3+
config: d0f7e7491a617318ea66f31d3f61c0ee
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

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

Copy file name to clipboardExpand all lines: _sources/c-api/init.rst.txt
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1448,7 +1448,7 @@ All of the following functions must be called after :c:func:`Py_Initialize`.
14481448
14491449
.. c:function:: PyObject* PyUnstable_InterpreterState_GetMainModule(PyInterpreterState *interp)
14501450
1451-
Return a :term:`strong reference` to the ``__main__`` `module object <moduleobjects>`_
1451+
Return a :term:`strong reference` to the ``__main__`` :ref:`module object <moduleobjects>`
14521452
for the given interpreter.
14531453
14541454
The caller must hold the GIL.

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

Copy file name to clipboardExpand all lines: _sources/c-api/module.rst.txt
+4-3Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -523,9 +523,6 @@ state:
523523
524524
On success, return ``0``. On error, raise an exception and return ``-1``.
525525
526-
Return ``-1`` if *value* is ``NULL``. It must be called with an exception
527-
raised in this case.
528-
529526
Example usage::
530527
531528
static int
@@ -540,6 +537,10 @@ state:
540537
return res;
541538
}
542539
540+
To be convenient, the function accepts ``NULL`` *value* with an exception
541+
set. In this case, return ``-1`` and just leave the raised exception
542+
unchanged.
543+
543544
The example can also be written without checking explicitly if *obj* is
544545
``NULL``::
545546

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

Copy file name to clipboardExpand all lines: _sources/c-api/unicode.rst.txt
+9Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1054,6 +1054,15 @@ These are the UTF-8 codec APIs:
10541054
10551055
As :c:func:`PyUnicode_AsUTF8AndSize`, but does not store the size.
10561056
1057+
.. warning::
1058+
1059+
This function does not have any special behavior for
1060+
`null characters <https://en.wikipedia.org/wiki/Null_character>`_ embedded within
1061+
*unicode*. As a result, strings containing null characters will remain in the returned
1062+
string, which some C functions might interpret as the end of the string, leading to
1063+
truncation. If truncation is an issue, it is recommended to use :c:func:`PyUnicode_AsUTF8AndSize`
1064+
instead.
1065+
10571066
.. versionadded:: 3.3
10581067
10591068
.. versionchanged:: 3.7

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

Copy file name to clipboardExpand all lines: _sources/c-api/veryhigh.rst.txt
+15-3Lines changed: 15 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -348,8 +348,20 @@ the same library that the Python runtime is using.
348348
.. versionchanged:: 3.8
349349
Added *cf_feature_version* field.
350350
351+
The available compiler flags are accessible as macros:
351352
352-
.. c:var:: int CO_FUTURE_DIVISION
353+
.. c:namespace:: NULL
353354
354-
This bit can be set in *flags* to cause division operator ``/`` to be
355-
interpreted as "true division" according to :pep:`238`.
355+
.. c:macro:: PyCF_ALLOW_TOP_LEVEL_AWAIT
356+
PyCF_ONLY_AST
357+
PyCF_OPTIMIZED_AST
358+
PyCF_TYPE_COMMENTS
359+
360+
See :ref:`compiler flags <ast-compiler-flags>` in documentation of the
361+
:py:mod:`!ast` Python module, which exports these constants under
362+
the same names.
363+
364+
.. c:var:: int CO_FUTURE_DIVISION
365+
366+
This bit can be set in *flags* to cause division operator ``/`` to be
367+
interpreted as "true division" according to :pep:`238`.

‎_sources/faq/programming.rst.txt

Copy file name to clipboardExpand all lines: _sources/faq/programming.rst.txt
+18-16Lines changed: 18 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1906,28 +1906,30 @@ In the standard library code, you will see several common patterns for
19061906
correctly using identity tests:
19071907

19081908
1) As recommended by :pep:`8`, an identity test is the preferred way to check
1909-
for ``None``. This reads like plain English in code and avoids confusion with
1910-
other objects that may have boolean values that evaluate to false.
1909+
for ``None``. This reads like plain English in code and avoids confusion
1910+
with other objects that may have boolean values that evaluate to false.
19111911

19121912
2) Detecting optional arguments can be tricky when ``None`` is a valid input
1913-
value. In those situations, you can create a singleton sentinel object
1914-
guaranteed to be distinct from other objects. For example, here is how
1915-
to implement a method that behaves like :meth:`dict.pop`::
1913+
value. In those situations, you can create a singleton sentinel object
1914+
guaranteed to be distinct from other objects. For example, here is how
1915+
to implement a method that behaves like :meth:`dict.pop`:
19161916

1917-
_sentinel = object()
1917+
.. code-block:: python
19181918
1919-
def pop(self, key, default=_sentinel):
1920-
if key in self:
1921-
value = self[key]
1922-
del self[key]
1923-
return value
1924-
if default is _sentinel:
1925-
raise KeyError(key)
1926-
return default
1919+
_sentinel = object()
1920+
1921+
def pop(self, key, default=_sentinel):
1922+
if key in self:
1923+
value = self[key]
1924+
del self[key]
1925+
return value
1926+
if default is _sentinel:
1927+
raise KeyError(key)
1928+
return default
19271929
19281930
3) Container implementations sometimes need to augment equality tests with
1929-
identity tests. This prevents the code from being confused by objects such as
1930-
``float('NaN')`` that are not equal to themselves.
1931+
identity tests. This prevents the code from being confused by objects
1932+
such as ``float('NaN')`` that are not equal to themselves.
19311933

19321934
For example, here is the implementation of
19331935
:meth:`!collections.abc.Sequence.__contains__`::

‎_sources/glossary.rst.txt

Copy file name to clipboardExpand all lines: _sources/glossary.rst.txt
+7-5Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ Glossary
110110
:keyword:`yield` expression.
111111

112112
Each :keyword:`yield` temporarily suspends processing, remembering the
113-
location execution state (including local variables and pending
113+
execution state (including local variables and pending
114114
try-statements). When the *asynchronous generator iterator* effectively
115115
resumes with another awaitable returned by :meth:`~object.__anext__`, it
116116
picks up where it left off. See :pep:`492` and :pep:`525`.
@@ -554,7 +554,7 @@ Glossary
554554
An object created by a :term:`generator` function.
555555

556556
Each :keyword:`yield` temporarily suspends processing, remembering the
557-
location execution state (including local variables and pending
557+
execution state (including local variables and pending
558558
try-statements). When the *generator iterator* resumes, it picks up where
559559
it left off (in contrast to functions which start fresh on every
560560
invocation).
@@ -801,9 +801,11 @@ Glossary
801801
processed.
802802

803803
loader
804-
An object that loads a module. It must define a method named
805-
:meth:`load_module`. A loader is typically returned by a
806-
:term:`finder`. See also:
804+
An object that loads a module.
805+
It must define the :meth:`!exec_module` and :meth:`!create_module` methods
806+
to implement the :class:`~importlib.abc.Loader` interface.
807+
A loader is typically returned by a :term:`finder`.
808+
See also:
807809

808810
* :ref:`finders-and-loaders`
809811
* :class:`importlib.abc.Loader`

‎_sources/howto/free-threading-python.rst.txt

Copy file name to clipboardExpand all lines: _sources/howto/free-threading-python.rst.txt
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Identifying free-threaded Python
4343
================================
4444

4545
To check if the current interpreter supports free-threading, :option:`python -VV <-V>`
46-
and :attr:`sys.version` contain "experimental free-threading build".
46+
and :data:`sys.version` contain "experimental free-threading build".
4747
The new :func:`sys._is_gil_enabled` function can be used to check whether
4848
the GIL is actually disabled in the running process.
4949

‎_sources/howto/mro.rst.txt

Copy file name to clipboardExpand all lines: _sources/howto/mro.rst.txt
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -398,7 +398,7 @@ with inheritance diagram
398398
399399
We see that class G inherits from F and E, with F *before* E: therefore
400400
we would expect the attribute *G.remember2buy* to be inherited by
401-
*F.rembermer2buy* and not by *E.remember2buy*: nevertheless Python 2.2
401+
*F.remember2buy* and not by *E.remember2buy*: nevertheless Python 2.2
402402
gives
403403

404404
>>> G.remember2buy # doctest: +SKIP

‎_sources/library/datetime.rst.txt

Copy file name to clipboardExpand all lines: _sources/library/datetime.rst.txt
+3-3Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ The :mod:`!datetime` module exports the following constants:
9393
The largest year number allowed in a :class:`date` or :class:`.datetime` object.
9494
:const:`MAXYEAR` is 9999.
9595

96-
.. attribute:: UTC
96+
.. data:: UTC
9797

9898
Alias for the UTC time zone singleton :attr:`datetime.timezone.utc`.
9999

@@ -937,7 +937,7 @@ Other constructors, all class methods:
937937

938938
.. deprecated:: 3.12
939939

940-
Use :meth:`datetime.now` with :attr:`UTC` instead.
940+
Use :meth:`datetime.now` with :const:`UTC` instead.
941941

942942

943943
.. classmethod:: datetime.fromtimestamp(timestamp, tz=None)
@@ -1009,7 +1009,7 @@ Other constructors, all class methods:
10091009

10101010
.. deprecated:: 3.12
10111011

1012-
Use :meth:`datetime.fromtimestamp` with :attr:`UTC` instead.
1012+
Use :meth:`datetime.fromtimestamp` with :const:`UTC` instead.
10131013

10141014

10151015
.. classmethod:: datetime.fromordinal(ordinal)

‎_sources/library/decimal.rst.txt

Copy file name to clipboardExpand all lines: _sources/library/decimal.rst.txt
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2245,7 +2245,7 @@ value for :attr:`~Context.prec` as well [#]_::
22452245
Decimal('904625697166532776746648320380374280103671755200316906558262375061821325312')
22462246

22472247

2248-
For inexact results, :attr:`MAX_PREC` is far too large on 64-bit platforms and
2248+
For inexact results, :const:`MAX_PREC` is far too large on 64-bit platforms and
22492249
the available memory will be insufficient::
22502250

22512251
>>> Decimal(1) / 3

‎_sources/library/email.contentmanager.rst.txt

Copy file name to clipboardExpand all lines: _sources/library/email.contentmanager.rst.txt
+7-1Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -157,7 +157,13 @@ Currently the email package provides only one concrete content manager,
157157
:exc:`ValueError`.
158158

159159
* For ``str`` objects, if *cte* is not set use heuristics to
160-
determine the most compact encoding.
160+
determine the most compact encoding. Prior to encoding,
161+
:meth:`str.splitlines` is used to normalize all line boundaries,
162+
ensuring that each line of the payload is terminated by the
163+
current policy's :data:`~email.policy.Policy.linesep` property
164+
(even if the original string did not end with one).
165+
* For ``bytes`` objects, *cte* is taken to be base64 if not set,
166+
and the aforementioned newline translation is not performed.
161167
* For :class:`~email.message.EmailMessage`, per :rfc:`2046`, raise
162168
an error if a *cte* of ``quoted-printable`` or ``base64`` is
163169
requested for *subtype* ``rfc822``, and for any *cte* other than

‎_sources/library/errno.rst.txt

Copy file name to clipboardExpand all lines: _sources/library/errno.rst.txt
+165Lines changed: 165 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -665,6 +665,171 @@ defined by the module. The specific list of defined symbols is available as
665665

666666
.. versionadded:: 3.11
667667

668+
669+
.. data:: ENOMEDIUM
670+
671+
No medium found
672+
673+
674+
.. data:: EMEDIUMTYPE
675+
676+
Wrong medium type
677+
678+
679+
.. data:: ENOKEY
680+
681+
Required key not available
682+
683+
684+
.. data:: EKEYEXPIRED
685+
686+
Key has expired
687+
688+
689+
.. data:: EKEYREVOKED
690+
691+
Key has been revoked
692+
693+
694+
.. data:: EKEYREJECTED
695+
696+
Key was rejected by service
697+
698+
699+
.. data:: ERFKILL
700+
701+
Operation not possible due to RF-kill
702+
703+
704+
.. data:: ELOCKUNMAPPED
705+
706+
Locked lock was unmapped
707+
708+
709+
.. data:: ENOTACTIVE
710+
711+
Facility is not active
712+
713+
714+
.. data:: EAUTH
715+
716+
Authentication error
717+
718+
.. versionadded:: 3.2
719+
720+
721+
.. data:: EBADARCH
722+
723+
Bad CPU type in executable
724+
725+
.. versionadded:: 3.2
726+
727+
728+
.. data:: EBADEXEC
729+
730+
Bad executable (or shared library)
731+
732+
.. versionadded:: 3.2
733+
734+
735+
.. data:: EBADMACHO
736+
737+
Malformed Mach-o file
738+
739+
.. versionadded:: 3.2
740+
741+
742+
.. data:: EDEVERR
743+
744+
Device error
745+
746+
.. versionadded:: 3.2
747+
748+
749+
.. data:: EFTYPE
750+
751+
Inappropriate file type or format
752+
753+
.. versionadded:: 3.2
754+
755+
756+
.. data:: ENEEDAUTH
757+
758+
Need authenticator
759+
760+
.. versionadded:: 3.2
761+
762+
763+
.. data:: ENOATTR
764+
765+
Attribute not found
766+
767+
.. versionadded:: 3.2
768+
769+
770+
.. data:: ENOPOLICY
771+
772+
Policy not found
773+
774+
.. versionadded:: 3.2
775+
776+
777+
.. data:: EPROCLIM
778+
779+
Too many processes
780+
781+
.. versionadded:: 3.2
782+
783+
784+
.. data:: EPROCUNAVAIL
785+
786+
Bad procedure for program
787+
788+
.. versionadded:: 3.2
789+
790+
791+
.. data:: EPROGMISMATCH
792+
793+
Program version wrong
794+
795+
.. versionadded:: 3.2
796+
797+
798+
.. data:: EPROGUNAVAIL
799+
800+
RPC prog. not avail
801+
802+
.. versionadded:: 3.2
803+
804+
805+
.. data:: EPWROFF
806+
807+
Device power is off
808+
809+
.. versionadded:: 3.2
810+
811+
812+
.. data:: EBADRPC
813+
814+
RPC struct is bad
815+
816+
.. versionadded:: 3.2
817+
818+
819+
.. data:: ERPCMISMATCH
820+
821+
RPC version wrong
822+
823+
.. versionadded:: 3.2
824+
825+
826+
.. data:: ESHLIBVERS
827+
828+
Shared library version mismatch
829+
830+
.. versionadded:: 3.2
831+
832+
668833
.. data:: ENOTCAPABLE
669834

670835
Capabilities insufficient. This error is mapped to the exception

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.