Movatterモバイル変換

[0]ホーム
URL:

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

 Sign up
Appearance settings

Commit97b57b0

Browse files
Deploy preview for PR 1148 🛫
1 parent5b95c2b commit97b57b0

File tree

608 files changed

+8928
-8046
lines changed

Some content is hidden

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

608 files changed

+8928
-8046
lines changed

‎pr-preview/pr-1148/.buildinfo‎

Lines 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:573547f937c6d24d0af6108c021fcf4f
3+
config:027112e6b110a6ec310dc8c74832cccb
44
tags: 645f666f9bcd5a90fca523b33c5a78b7
-42.9 KB
Loading
-25 KB
Loading
-4.56 KB
Loading

‎pr-preview/pr-1148/_sources/c-api/unicode.rst.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -731,7 +731,7 @@ APIs:
731731
Return ``0`` on success, ``-1`` on error with an exception set.
732732
733733
This function checks that *unicode* is a Unicode object, that the index is
734-
not out of bounds, and that the object's reference count is one).
734+
not out of bounds, and that the object's reference count is one.
735735
See:c:func:`PyUnicode_WRITE` for a version that skips these checks,
736736
making them your responsibility.
737737

‎pr-preview/pr-1148/_sources/c-api/veryhigh.rst.txt‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -183,7 +183,8 @@ the same library that the Python runtime is using.
183183
objects *globals* and *locals* with the compiler flags specified by
184184
*flags*. *globals* must be a dictionary; *locals* can be any object
185185
that implements the mapping protocol. The parameter *start* specifies
186-
the start token that should be used to parse the source code.
186+
the start symbol and must one of the following:
187+
:c:data:`Py_eval_input`,:c:data:`Py_file_input`, or:c:data:`Py_single_input`.
187188
188189
Returns the result of executing the code as a Python object, or ``NULL`` if an
189190
exception was raised.
@@ -231,7 +232,7 @@ the same library that the Python runtime is using.
231232
..c:function:: PyObject*Py_CompileStringObject(const char *str, PyObject *filename, int start, PyCompilerFlags *flags, int optimize)
232233
233234
Parse and compile the Python source code in *str*, returning the resulting code
234-
object. The starttoken is given by *start*; this can be used to constrain the
235+
object. The startsymbol is given by *start*; this can be used to constrain the
235236
code which can be compiled and should be:c:data:`Py_eval_input`,
236237
:c:data:`Py_file_input`, or:c:data:`Py_single_input`. The filename specified by
237238
*filename* is used to construct the code object and may appear in tracebacks or

‎pr-preview/pr-1148/_sources/extending/extending.rst.txt‎

Lines changed: 31 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -75,12 +75,37 @@ the module and a copyright notice if you like).
7575
See:ref:`arg-parsing-string-and-buffers` for a description of this macro.
7676

7777
All user-visible symbols defined by:file:`Python.h` have a prefix of ``Py`` or
78-
``PY``, except those defined in standard header files. For convenience, and
79-
since they are used extensively by the Python interpreter, ``"Python.h"``
80-
includes a few standard header files: ``<stdio.h>``, ``<string.h>``,
81-
``<errno.h>``, and ``<stdlib.h>``. If the latter header file does not exist on
82-
your system, it declares the functions:c:func:`malloc`,:c:func:`free` and
83-
:c:func:`realloc` directly.
78+
``PY``, except those defined in standard header files.
79+
80+
..tip::
81+
82+
For backward compatibility,:file:`Python.h` includes several standard header files.
83+
C extensions should include the standard headers that they use,
84+
and should not rely on these implicit includes.
85+
If using the limited C API version 3.13 or newer, the implicit includes are:
86+
87+
* ``<assert.h>``
88+
* ``<intrin.h>`` (on Windows)
89+
* ``<inttypes.h>``
90+
* ``<limits.h>``
91+
* ``<math.h>``
92+
* ``<stdarg.h>``
93+
* ``<wchar.h>``
94+
* ``<sys/types.h>`` (if present)
95+
96+
If:c:macro:`Py_LIMITED_API` is not defined, or is set to version 3.12 or older,
97+
the headers below are also included:
98+
99+
* ``<ctype.h>``
100+
* ``<unistd.h>`` (on POSIX)
101+
102+
If:c:macro:`Py_LIMITED_API` is not defined, or is set to version 3.10 or older,
103+
the headers below are also included:
104+
105+
* ``<errno.h>``
106+
* ``<stdio.h>``
107+
* ``<stdlib.h>``
108+
* ``<string.h>``
84109

85110
The next thing we add to our module file is the C function that will be called
86111
when the Python expression ``spam.system(string)`` is evaluated (we'll see

‎pr-preview/pr-1148/_sources/library/asyncio-queue.rst.txt‎

Lines changed: 24 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -102,17 +102,33 @@ Queue
102102

103103
..method::shutdown(immediate=False)
104104

105-
Shut down the queue, making:meth:`~Queue.get` and:meth:`~Queue.put`
105+
Put a:class:`Queue` instance into a shutdown mode.
106+
107+
The queue can no longer grow.
108+
Future calls to:meth:`~Queue.put` raise:exc:`QueueShutDown`.
109+
Currently blocked callers of:meth:`~Queue.put` will be unblocked
110+
and will raise:exc:`QueueShutDown` in the formerly blocked thread.
111+
112+
If *immediate* is false (the default), the queue can be wound
113+
down normally with:meth:`~Queue.get` calls to extract tasks
114+
that have already been loaded.
115+
116+
And if:meth:`~Queue.task_done` is called for each remaining task, a
117+
pending:meth:`~Queue.join` will be unblocked normally.
118+
119+
Once the queue is empty, future calls to:meth:`~Queue.get` will
106120
raise:exc:`QueueShutDown`.
107121

108-
By default,:meth:`~Queue.get` on a shut down queue will only
109-
raise once the queue is empty. Set *immediate* to true to make
110-
:meth:`~Queue.get` raise immediately instead.
122+
If *immediate* is true, the queue is terminated immediately.
123+
The queue is drained to be completely empty. All callers of
124+
:meth:`~Queue.join` are unblocked regardless of the number
125+
of unfinished tasks. Blocked callers of:meth:`~Queue.get`
126+
are unblocked and will raise:exc:`QueueShutDown` because the
127+
queue is empty.
111128

112-
All blocked callers of:meth:`~Queue.put` and:meth:`~Queue.get`
113-
will be unblocked. If *immediate* is true, a task will be marked
114-
as done for each remaining item in the queue, which may unblock
115-
callers of:meth:`~Queue.join`.
129+
Use caution when using:meth:`~Queue.join` with *immediate* set
130+
to true. This unblocks the join even when no work has been done
131+
on the tasks, violating the usual invariant for joining a queue.
116132

117133
..versionadded::3.13
118134

@@ -129,9 +145,6 @@ Queue
129145
call was received for every item that had been:meth:`~Queue.put`
130146
into the queue).
131147

132-
``shutdown(immediate=True)`` calls:meth:`task_done` for each
133-
remaining item in the queue.
134-
135148
Raises:exc:`ValueError` if called more times than there were
136149
items placed in the queue.
137150

‎pr-preview/pr-1148/_sources/library/codecs.rst.txt‎

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1251,7 +1251,7 @@ particular, the following variants typically exist:
12511251
+-----------------+--------------------------------+--------------------------------+
12521252
| iso8859_3| iso-8859-3, latin3, L3| Esperanto, Maltese|
12531253
+-----------------+--------------------------------+--------------------------------+
1254-
| iso8859_4| iso-8859-4, latin4, L4|Baltic languages|
1254+
| iso8859_4| iso-8859-4, latin4, L4|Northern Europe|
12551255
+-----------------+--------------------------------+--------------------------------+
12561256
| iso8859_5| iso-8859-5, cyrillic| Belarusian, Bulgarian,|
12571257
||| Macedonian, Russian, Serbian|
@@ -1483,6 +1483,36 @@ to :class:`bytes` mappings. They are not supported by :meth:`bytes.decode`
14831483
Restoration of the aliases for the binary transforms.
14841484

14851485

1486+
.. _standalone-codec-functions:
1487+
1488+
Standalone Codec Functions
1489+
^^^^^^^^^^^^^^^^^^^^^^^^^^
1490+
1491+
The following functions provide encoding and decoding functionality similar to codecs,
1492+
but are not available as named codecs through:func:`codecs.encode` or:func:`codecs.decode`.
1493+
They are used internally (for example, by:mod:`pickle`) and behave similarly to the
1494+
``string_escape`` codec that was removed in Python 3.
1495+
1496+
..function::codecs.escape_encode(input, errors=None)
1497+
1498+
Encode *input* using escape sequences. Similar to how:func:`repr` on bytes
1499+
produces escaped byte values.
1500+
1501+
*input* must be a:class:`bytes` object.
1502+
1503+
Returns a tuple ``(output, length)`` where *output* is a:class:`bytes`
1504+
object and *length* is the number of bytes consumed.
1505+
1506+
..function::codecs.escape_decode(input, errors=None)
1507+
1508+
Decode *input* from escape sequences back to the original bytes.
1509+
1510+
*input* must be a:term:`bytes-like object`.
1511+
1512+
Returns a tuple ``(output, length)`` where *output* is a:class:`bytes`
1513+
object and *length* is the number of bytes consumed.
1514+
1515+
14861516
.. _text-transforms:
14871517

14881518
Text Transforms

‎pr-preview/pr-1148/_sources/library/collections.abc.rst.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -336,7 +336,7 @@ Collections Abstract Base Classes -- Detailed Descriptions
336336

337337
..note::
338338
In CPython, generator-based coroutines (:term:`generators <generator>`
339-
decorated with:func:`@types.coroutine <types.coroutine>`) are
339+
decorated with:deco:`types.coroutine`) are
340340
*awaitables*, even though they do not have an:meth:`~object.__await__` method.
341341
Using ``isinstance(gencoro, Awaitable)`` for them will return ``False``.
342342
Use:func:`inspect.isawaitable` to detect them.
@@ -354,7 +354,7 @@ Collections Abstract Base Classes -- Detailed Descriptions
354354

355355
..note::
356356
In CPython, generator-based coroutines (:term:`generators <generator>`
357-
decorated with:func:`@types.coroutine <types.coroutine>`) are
357+
decorated with:deco:`types.coroutine`) are
358358
*awaitables*, even though they do not have an:meth:`~object.__await__` method.
359359
Using ``isinstance(gencoro, Coroutine)`` for them will return ``False``.
360360
Use:func:`inspect.isawaitable` to detect them.

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp