Skip to content

Commit 9a113d3

Browse files
josixjosix
committed
Deploying to gh-pages from @ d48b8ca 🚀
1 parent 389bffe commit 9a113d3

File tree

557 files changed

+732
-819
lines changed

Some content is hidden

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

557 files changed

+732
-819
lines changed

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

Lines changed: 0 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1271,17 +1271,6 @@ PyConfig
12711271
12721272
Default: ``1`` in Python config and ``0`` in isolated config.
12731273
1274-
.. c:member:: int use_system_logger
1275-
1276-
If non-zero, ``stdout`` and ``stderr`` will be redirected to the system
1277-
log.
1278-
1279-
Only available on macOS 10.12 and later, and on iOS.
1280-
1281-
Default: ``0`` (don't use system log).
1282-
1283-
.. versionadded:: 3.13.2
1284-
12851274
.. c:member:: int user_site_directory
12861275
12871276
If non-zero, add the user site directory to :data:`sys.path`.

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22

33
.. _type-structs:
44

5-
Type Objects
6-
============
5+
Type Object Structures
6+
======================
77

88
Perhaps one of the most important structures of the Python object system is the
99
structure that defines a new type: the :c:type:`PyTypeObject` structure. Type

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

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ Creating Subprocesses
6868
Create a subprocess.
6969

7070
The *limit* argument sets the buffer limit for :class:`StreamReader`
71-
wrappers for :attr:`Process.stdout` and :attr:`Process.stderr`
71+
wrappers for :attr:`~asyncio.subprocess.Process.stdout` and :attr:`~asyncio.subprocess.Process.stderr`
7272
(if :const:`subprocess.PIPE` is passed to *stdout* and *stderr* arguments).
7373

7474
Return a :class:`~asyncio.subprocess.Process` instance.
@@ -87,7 +87,7 @@ Creating Subprocesses
8787
Run the *cmd* shell command.
8888

8989
The *limit* argument sets the buffer limit for :class:`StreamReader`
90-
wrappers for :attr:`Process.stdout` and :attr:`Process.stderr`
90+
wrappers for :attr:`~asyncio.subprocess.Process.stdout` and :attr:`~asyncio.subprocess.Process.stderr`
9191
(if :const:`subprocess.PIPE` is passed to *stdout* and *stderr* arguments).
9292

9393
Return a :class:`~asyncio.subprocess.Process` instance.
@@ -132,12 +132,12 @@ Constants
132132

133133
If *PIPE* is passed to *stdin* argument, the
134134
:attr:`Process.stdin <asyncio.subprocess.Process.stdin>` attribute
135-
will point to a :class:`StreamWriter` instance.
135+
will point to a :class:`~asyncio.StreamWriter` instance.
136136

137137
If *PIPE* is passed to *stdout* or *stderr* arguments, the
138138
:attr:`Process.stdout <asyncio.subprocess.Process.stdout>` and
139139
:attr:`Process.stderr <asyncio.subprocess.Process.stderr>`
140-
attributes will point to :class:`StreamReader` instances.
140+
attributes will point to :class:`~asyncio.StreamReader` instances.
141141

142142
.. data:: asyncio.subprocess.STDOUT
143143
:module:
@@ -165,7 +165,7 @@ their completion.
165165
:module:
166166

167167
An object that wraps OS processes created by the
168-
:func:`create_subprocess_exec` and :func:`create_subprocess_shell`
168+
:func:`~asyncio.create_subprocess_exec` and :func:`~asyncio.create_subprocess_shell`
169169
functions.
170170

171171
This class is designed to have a similar API to the
@@ -263,24 +263,24 @@ their completion.
263263

264264
Kill the child process.
265265

266-
On POSIX systems this method sends :py:data:`SIGKILL` to the child
266+
On POSIX systems this method sends :py:data:`~signal.SIGKILL` to the child
267267
process.
268268

269269
On Windows this method is an alias for :meth:`terminate`.
270270

271271
.. attribute:: stdin
272272

273-
Standard input stream (:class:`StreamWriter`) or ``None``
273+
Standard input stream (:class:`~asyncio.StreamWriter`) or ``None``
274274
if the process was created with ``stdin=None``.
275275

276276
.. attribute:: stdout
277277

278-
Standard output stream (:class:`StreamReader`) or ``None``
278+
Standard output stream (:class:`~asyncio.StreamReader`) or ``None``
279279
if the process was created with ``stdout=None``.
280280

281281
.. attribute:: stderr
282282

283-
Standard error stream (:class:`StreamReader`) or ``None``
283+
Standard error stream (:class:`~asyncio.StreamReader`) or ``None``
284284
if the process was created with ``stderr=None``.
285285

286286
.. warning::
@@ -296,7 +296,7 @@ their completion.
296296

297297
Process identification number (PID).
298298

299-
Note that for processes created by the :func:`create_subprocess_shell`
299+
Note that for processes created by the :func:`~asyncio.create_subprocess_shell`
300300
function, this attribute is the PID of the spawned shell.
301301

302302
.. attribute:: returncode

‎_sources/library/typing.rst.txt

Lines changed: 33 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1368,47 +1368,37 @@ These can be used as types in annotations. They all support subscription using
13681368
T1 = Annotated[int, ValueRange(-10, 5)]
13691369
T2 = Annotated[T1, ValueRange(-20, 3)]
13701370

1371-
Details of the syntax:
1371+
The first argument to ``Annotated`` must be a valid type. Multiple metadata
1372+
elements can be supplied as ``Annotated`` supports variadic arguments. The
1373+
order of the metadata elements is preserved and matters for equality checks::
13721374

1373-
* The first argument to ``Annotated`` must be a valid type
1374-
1375-
* Multiple metadata elements can be supplied (``Annotated`` supports variadic
1376-
arguments)::
1377-
1378-
@dataclass
1379-
class ctype:
1380-
kind: str
1381-
1382-
Annotated[int, ValueRange(3, 10), ctype("char")]
1383-
1384-
It is up to the tool consuming the annotations to decide whether the
1385-
client is allowed to add multiple metadata elements to one annotation and how to
1386-
merge those annotations.
1375+
@dataclass
1376+
class ctype:
1377+
kind: str
13871378

1388-
* ``Annotated`` must be subscripted with at least two arguments (
1389-
``Annotated[int]`` is not valid)
1379+
a1 = Annotated[int, ValueRange(3, 10), ctype("char")]
1380+
a2 = Annotated[int, ctype("char"), ValueRange(3, 10)]
13901381

1391-
* The order of the metadata elements is preserved and matters for equality
1392-
checks::
1382+
assert a1 != a2 # Order matters
13931383

1394-
assert Annotated[int, ValueRange(3, 10), ctype("char")] != Annotated[
1395-
int, ctype("char"), ValueRange(3, 10)
1396-
]
1384+
It is up to the tool consuming the annotations to decide whether the
1385+
client is allowed to add multiple metadata elements to one annotation and how to
1386+
merge those annotations.
13971387

1398-
* Nested ``Annotated`` types are flattened. The order of the metadata elements
1399-
starts with the innermost annotation::
1388+
Nested ``Annotated`` types are flattened. The order of the metadata elements
1389+
starts with the innermost annotation::
14001390

1401-
assert Annotated[Annotated[int, ValueRange(3, 10)], ctype("char")] == Annotated[
1402-
int, ValueRange(3, 10), ctype("char")
1403-
]
1391+
assert Annotated[Annotated[int, ValueRange(3, 10)], ctype("char")] == Annotated[
1392+
int, ValueRange(3, 10), ctype("char")
1393+
]
14041394

1405-
* Duplicated metadata elements are not removed::
1395+
Duplicated metadata elements are not removed::
14061396

1407-
assert Annotated[int, ValueRange(3, 10)] != Annotated[
1408-
int, ValueRange(3, 10), ValueRange(3, 10)
1409-
]
1397+
assert Annotated[int, ValueRange(3, 10)] != Annotated[
1398+
int, ValueRange(3, 10), ValueRange(3, 10)
1399+
]
14101400

1411-
* ``Annotated`` can be used with nested and generic aliases:
1401+
``Annotated`` can be used with nested and generic aliases:
14121402

14131403
.. testcode::
14141404

@@ -1422,19 +1412,15 @@ These can be used as types in annotations. They all support subscription using
14221412
# ``Annotated[list[tuple[int, int]], MaxLen(10)]``:
14231413
type V = Vec[int]
14241414

1425-
* ``Annotated`` cannot be used with an unpacked :class:`TypeVarTuple`::
1426-
1427-
type Variadic[*Ts] = Annotated[*Ts, Ann1] # NOT valid
1428-
1429-
This would be equivalent to::
1415+
``Annotated`` cannot be used with an unpacked :class:`TypeVarTuple`::
14301416

1431-
Annotated[T1, T2, T3, ..., Ann1]
1417+
type Variadic[*Ts] = Annotated[*Ts, Ann1] = Annotated[T1, T2, T3, ..., Ann1] # NOT valid
14321418

1433-
where ``T1``, ``T2``, etc. are :class:`TypeVars <TypeVar>`. This would be
1434-
invalid: only one type should be passed to Annotated.
1419+
where ``T1``, ``T2``, ... are :class:`TypeVars <TypeVar>`. This is invalid as
1420+
only one type should be passed to Annotated.
14351421

1436-
* By default, :func:`get_type_hints` strips the metadata from annotations.
1437-
Pass ``include_extras=True`` to have the metadata preserved:
1422+
By default, :func:`get_type_hints` strips the metadata from annotations.
1423+
Pass ``include_extras=True`` to have the metadata preserved:
14381424

14391425
.. doctest::
14401426

@@ -1446,8 +1432,8 @@ These can be used as types in annotations. They all support subscription using
14461432
>>> get_type_hints(func, include_extras=True)
14471433
{'x': typing.Annotated[int, 'metadata'], 'return': <class 'NoneType'>}
14481434

1449-
* At runtime, the metadata associated with an ``Annotated`` type can be
1450-
retrieved via the :attr:`!__metadata__` attribute:
1435+
At runtime, the metadata associated with an ``Annotated`` type can be
1436+
retrieved via the :attr:`!__metadata__` attribute:
14511437

14521438
.. doctest::
14531439

@@ -1458,8 +1444,8 @@ These can be used as types in annotations. They all support subscription using
14581444
>>> X.__metadata__
14591445
('very', 'important', 'metadata')
14601446

1461-
* At runtime, if you want to retrieve the original
1462-
type wrapped by ``Annotated``, use the :attr:`!__origin__` attribute:
1447+
If you want to retrieve the original type wrapped by ``Annotated``, use the
1448+
:attr:`!__origin__` attribute:
14631449

14641450
.. doctest::
14651451

@@ -1468,7 +1454,7 @@ These can be used as types in annotations. They all support subscription using
14681454
>>> Password.__origin__
14691455
<class 'str'>
14701456

1471-
Note that using :func:`get_origin` will return ``Annotated`` itself:
1457+
Note that using :func:`get_origin` will return ``Annotated`` itself:
14721458

14731459
.. doctest::
14741460

‎_sources/using/ios.rst.txt

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -296,8 +296,6 @@ To add Python to an iOS Xcode project:
296296
* Buffered stdio (:c:member:`PyConfig.buffered_stdio`) is *disabled*;
297297
* Writing bytecode (:c:member:`PyConfig.write_bytecode`) is *disabled*;
298298
* Signal handlers (:c:member:`PyConfig.install_signal_handlers`) are *enabled*;
299-
* System logging (:c:member:`PyConfig.use_system_logger`) is *enabled*
300-
(optional, but strongly recommended);
301299
* ``PYTHONHOME`` for the interpreter is configured to point at the
302300
``python`` subfolder of your app's bundle; and
303301
* The ``PYTHONPATH`` for the interpreter includes:

‎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-
最後更新於 3月 11, 2025 (03:28 UTC)。
322+
最後更新於 3月 15, 2025 (05:47 UTC)。
323323

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

‎bugs.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -358,7 +358,7 @@ <h3>瀏覽</h3>
358358
<a href="https://www.python.org/psf/donations/">Please donate.</a>
359359
<br />
360360
<br />
361-
最後更新於 3月 11, 2025 (03:28 UTC)。
361+
最後更新於 3月 15, 2025 (05:47 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-
最後更新於 3月 11, 2025 (03:28 UTC)。
331+
最後更新於 3月 15, 2025 (05:47 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-
最後更新於 3月 11, 2025 (03:28 UTC)。
346+
最後更新於 3月 15, 2025 (05:47 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-
最後更新於 3月 11, 2025 (03:28 UTC)。
378+
最後更新於 3月 15, 2025 (05:47 UTC)。
379379

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

0 commit comments

Comments
 (0)