Commit9a113d3

committed

Deploying to gh-pages from @d48b8ca 🚀

1 parent389bffe commit9a113d3Copy full SHA for 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 number	Diff line number	Diff line change
`@@ -1271,17 +1271,6 @@ PyConfig`
`1271`	`1271`
`1272`	`1272`	Default: ``1`` in Python config and ``0`` in isolated config.
`1273`	`1273`
`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`		`-`
`1285`	`1274`	`.. c:member:: int user_site_directory`
`1286`	`1275`
`1287`	`1276`	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 number	Diff line number	Diff line change
`@@ -2,8 +2,8 @@`
`2`	`2`
`3`	`3`	`.. _type-structs:`
`4`	`4`
`5`		`-TypeObjects`
`6`		`-============`
	`5`	`+TypeObject Structures`
	`6`	`+======================`
`7`	`7`
`8`	`8`	`Perhaps one of the most important structures of the Python object system is the`
`9`	`9`	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 number	Diff line number	Diff line change
`@@ -68,7 +68,7 @@ Creating Subprocesses`
`68`	`68`	`Create a subprocess.`
`69`	`69`
`70`	`70`	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`
`72`	`72`	(if:const:`subprocess.PIPE` is passed to stdout and stderr arguments).
`73`	`73`
`74`	`74`	Return a:class:`~asyncio.subprocess.Process` instance.
`@@ -87,7 +87,7 @@ Creating Subprocesses`
`87`	`87`	`Run the cmd shell command.`
`88`	`88`
`89`	`89`	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`
`91`	`91`	(if:const:`subprocess.PIPE` is passed to stdout and stderr arguments).
`92`	`92`
`93`	`93`	Return a:class:`~asyncio.subprocess.Process` instance.
`@@ -132,12 +132,12 @@ Constants`
`132`	`132`
`133`	`133`	`If PIPE is passed to stdin argument, the`
`134`	`134`	: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.
`136`	`136`
`137`	`137`	`If PIPE is passed to stdout or stderr arguments, the`
`138`	`138`	:attr:`Process.stdout <asyncio.subprocess.Process.stdout>` and
`139`	`139`	:attr:`Process.stderr <asyncio.subprocess.Process.stderr>`
`140`		- attributes will point to:class:`StreamReader` instances.
	`140`	+ attributes will point to:class:`~asyncio.StreamReader` instances.
`141`	`141`
`142`	`142`	`..data::asyncio.subprocess.STDOUT`
`143`	`143`	`:module:`
`@@ -165,7 +165,7 @@ their completion.`
`165`	`165`	`:module:`
`166`	`166`
`167`	`167`	`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`
`169`	`169`	`functions.`
`170`	`170`
`171`	`171`	`This class is designed to have a similar API to the`
`@@ -263,24 +263,24 @@ their completion.`
`263`	`263`
`264`	`264`	`Kill the child process.`
`265`	`265`
`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
`267`	`267`	`process.`
`268`	`268`
`269`	`269`	On Windows this method is an alias for:meth:`terminate`.
`270`	`270`
`271`	`271`	`..attribute::stdin`
`272`	`272`
`273`		- Standard input stream (:class:`StreamWriter`) or ``None``
	`273`	+ Standard input stream (:class:`~asyncio.StreamWriter`) or ``None``
`274`	`274`	if the process was created with ``stdin=None``.
`275`	`275`
`276`	`276`	`..attribute::stdout`
`277`	`277`
`278`		- Standard output stream (:class:`StreamReader`) or ``None``
	`278`	+ Standard output stream (:class:`~asyncio.StreamReader`) or ``None``
`279`	`279`	if the process was created with ``stdout=None``.
`280`	`280`
`281`	`281`	`..attribute::stderr`
`282`	`282`
`283`		- Standard error stream (:class:`StreamReader`) or ``None``
	`283`	+ Standard error stream (:class:`~asyncio.StreamReader`) or ``None``
`284`	`284`	if the process was created with ``stderr=None``.
`285`	`285`
`286`	`286`	`..warning::`
`@@ -296,7 +296,7 @@ their completion.`
`296`	`296`
`297`	`297`	`Process identification number (PID).`
`298`	`298`
`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`
`300`	`300`	`function, this attribute is the PID of the spawned shell.`
`301`	`301`
`302`	`302`	`..attribute::returncode`

`‎_sources/library/typing.rst.txt`

Lines changed: 33 additions & 47 deletions

Original file line number	Diff line number	Diff line change
`@@ -1368,47 +1368,37 @@ These can be used as types in annotations. They all support subscription using`
`1368`	`1368`	`T1 = Annotated[int, ValueRange(-10, 5)]`
`1369`	`1369`	`T2 = Annotated[T1, ValueRange(-20, 3)]`
`1370`	`1370`
`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::`
`1372`	`1374`
`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`
`1387`	`1378`
`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)]`
`1390`	`1381`
`1391`		`- * The order of the metadata elements is preserved and matters for equality`
`1392`		`- checks::`
	`1382`	`+ assert a1 != a2 # Order matters`
`1393`	`1383`
`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.`
`1397`	`1387`
`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::`
`1400`	`1390`
`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`	`+ ]`
`1404`	`1394`
`1405`		`-*Duplicated metadata elements are not removed::`
	`1395`	`+ Duplicated metadata elements are not removed::`
`1406`	`1396`
`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`	`+ ]`
`1410`	`1400`
`1411`		-*``Annotated`` can be used with nested and generic aliases:
	`1401`	+ ``Annotated`` can be used with nested and generic aliases:
`1412`	`1402`
`1413`	`1403`	`..testcode::`
`1414`	`1404`
`@@ -1422,19 +1412,15 @@ These can be used as types in annotations. They all support subscription using`
`1422`	`1412`	# ``Annotated[list[tuple[int, int]], MaxLen(10)]``:
`1423`	`1413`	`type V = Vec[int]`
`1424`	`1414`
`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`::
`1430`	`1416`
`1431`		`- Annotated[T1, T2, T3, ..., Ann1]`
	`1417`	`+type Variadic[Ts] =Annotated[Ts, Ann1] = Annotated[T1, T2, T3, ..., Ann1] # NOT valid`
`1432`	`1418`
`1433`		-where ``T1``, ``T2``,etc. are :class:`TypeVars <TypeVar>`. Thiswould be
`1434`		`- invalid:only one type should be passed to Annotated.`
	`1419`	+ where ``T1``, ``T2``,... are:class:`TypeVars <TypeVar>`. Thisis invalid as
	`1420`	`+ only one type should be passed to Annotated.`
`1435`	`1421`
`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:
`1438`	`1424`
`1439`	`1425`	`..doctest::`
`1440`	`1426`
`@@ -1446,8 +1432,8 @@ These can be used as types in annotations. They all support subscription using`
`1446`	`1432`	`>>>get_type_hints(func,include_extras=True)`
`1447`	`1433`	`{'x': typing.Annotated[int, 'metadata'], 'return': <class 'NoneType'>}`
`1448`	`1434`
`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:
`1451`	`1437`
`1452`	`1438`	`..doctest::`
`1453`	`1439`
`@@ -1458,8 +1444,8 @@ These can be used as types in annotations. They all support subscription using`
`1458`	`1444`	`>>>X.__metadata__`
`1459`	`1445`	`('very', 'important', 'metadata')`
`1460`	`1446`
`1461`		`-* At runtime, ifyou want to retrieve the original`
`1462`		- type wrapped by ``Annotated``, use the:attr:`!__origin__` attribute:
	`1447`	+Ifyou want to retrieve the original type wrapped by ``Annotated``, use the
	`1448`	+:attr:`!__origin__` attribute:
`1463`	`1449`
`1464`	`1450`	`..doctest::`
`1465`	`1451`
`@@ -1468,7 +1454,7 @@ These can be used as types in annotations. They all support subscription using`
`1468`	`1454`	`>>>Password.__origin__`
`1469`	`1455`	`<class 'str'>`
`1470`	`1456`
`1471`		-Note that using:func:`get_origin` will return ``Annotated`` itself:
	`1457`	+ Note that using:func:`get_origin` will return ``Annotated`` itself:
`1472`	`1458`
`1473`	`1459`	`..doctest::`
`1474`	`1460`