Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit bbfb2c1

Browse files
committed
Deploying to gh-pages from @ eb3a844 πŸš€
1 parent f22daef commit bbfb2c1

File tree

537 files changed

+1393
-1706
lines changed

Some content is hidden

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

537 files changed

+1393
-1706
lines changed

β€Ž.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 hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3-
config: cd98f4a4a27b073384e0ba0908df47e5
3+
config: 3e74a85fa9a90ad5fa42bbf36dea01ad
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

β€Ž_sources/c-api/exceptions.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -427,7 +427,7 @@ Querying the error indicator
427427
.. c:function:: PyObject *PyErr_GetRaisedException(void)
428428
429429
Return the exception currently being raised, clearing the error indicator at
430-
the same time.
430+
the same time. Return ``NULL`` if the error indicator is not set.
431431
432432
This function is used by code that needs to catch exceptions,
433433
or code that needs to save and restore the error indicator temporarily.

β€Ž_sources/library/configparser.rst.txt

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -208,7 +208,7 @@ converters and customize the provided ones. [1]_
208208
Fallback Values
209209
---------------
210210

211-
As with a dictionary, you can use a section's :meth:`get` method to
211+
As with a dictionary, you can use a section's :meth:`~ConfigParser.get` method to
212212
provide fallback values:
213213

214214
.. doctest::
@@ -232,7 +232,7 @@ even if we specify a fallback:
232232
>>> topsecret.get('CompressionLevel', '3')
233233
'9'
234234

235-
One more thing to be aware of is that the parser-level :meth:`get` method
235+
One more thing to be aware of is that the parser-level :meth:`~ConfigParser.get` method
236236
provides a custom, more complex interface, maintained for backwards
237237
compatibility. When using this method, a fallback value can be provided via
238238
the ``fallback`` keyword-only argument:
@@ -271,7 +271,7 @@ out. Values can also span multiple lines, as long as they are indented deeper
271271
than the first line of the value. Depending on the parser's mode, blank lines
272272
may be treated as parts of multiline values or ignored.
273273

274-
By default, a valid section name can be any string that does not contain '\\n' or ']'.
274+
By default, a valid section name can be any string that does not contain '\\n'.
275275
To change this, see :attr:`ConfigParser.SECTCRE`.
276276

277277
Configuration files may include comments, prefixed by specific
@@ -481,7 +481,7 @@ historical background and it's very likely that you will want to customize some
481481
of the features.
482482

483483
The most common way to change the way a specific config parser works is to use
484-
the :meth:`__init__` options:
484+
the :meth:`!__init__` options:
485485

486486
* *defaults*, default value: ``None``
487487

@@ -491,7 +491,7 @@ the :meth:`__init__` options:
491491
the documented default.
492492

493493
Hint: if you want to specify default values for a specific section, use
494-
:meth:`read_dict` before you read the actual file.
494+
:meth:`~ConfigParser.read_dict` before you read the actual file.
495495

496496
* *dict_type*, default value: :class:`dict`
497497

@@ -635,8 +635,8 @@ the :meth:`__init__` options:
635635
* *strict*, default value: ``True``
636636

637637
When set to ``True``, the parser will not allow for any section or option
638-
duplicates while reading from a single source (using :meth:`read_file`,
639-
:meth:`read_string` or :meth:`read_dict`). It is recommended to use strict
638+
duplicates while reading from a single source (using :meth:`~ConfigParser.read_file`,
639+
:meth:`~ConfigParser.read_string` or :meth:`~ConfigParser.read_dict`). It is recommended to use strict
640640
parsers in new applications.
641641

642642
.. versionchanged:: 3.2
@@ -697,7 +697,7 @@ the :meth:`__init__` options:
697697
desirable, users may define them in a subclass or pass a dictionary where each
698698
key is a name of the converter and each value is a callable implementing said
699699
conversion. For instance, passing ``{'decimal': decimal.Decimal}`` would add
700-
:meth:`getdecimal` on both the parser object and all section proxies. In
700+
:meth:`!getdecimal` on both the parser object and all section proxies. In
701701
other words, it will be possible to write both
702702
``parser_instance.getdecimal('section', 'key', fallback=0)`` and
703703
``parser_instance['section'].getdecimal('key', 0)``.
@@ -1062,11 +1062,11 @@ ConfigParser Objects
10621062
yielding Unicode strings (for example files opened in text mode).
10631063

10641064
Optional argument *source* specifies the name of the file being read. If
1065-
not given and *f* has a :attr:`name` attribute, that is used for
1065+
not given and *f* has a :attr:`!name` attribute, that is used for
10661066
*source*; the default is ``'<???>'``.
10671067

10681068
.. versionadded:: 3.2
1069-
Replaces :meth:`readfp`.
1069+
Replaces :meth:`!readfp`.
10701070

10711071
.. method:: read_string(string, source='<string>')
10721072

@@ -1214,7 +1214,7 @@ ConfigParser Objects
12141214

12151215
.. data:: MAX_INTERPOLATION_DEPTH
12161216

1217-
The maximum depth for recursive interpolation for :meth:`get` when the *raw*
1217+
The maximum depth for recursive interpolation for :meth:`~configparser.ConfigParser.get` when the *raw*
12181218
parameter is false. This is relevant only when the default *interpolation*
12191219
is used.
12201220

@@ -1287,13 +1287,13 @@ Exceptions
12871287

12881288
.. exception:: DuplicateSectionError
12891289

1290-
Exception raised if :meth:`add_section` is called with the name of a section
1290+
Exception raised if :meth:`~ConfigParser.add_section` is called with the name of a section
12911291
that is already present or in strict parsers when a section if found more
12921292
than once in a single input file, string or dictionary.
12931293

12941294
.. versionadded:: 3.2
12951295
Optional ``source`` and ``lineno`` attributes and arguments to
1296-
:meth:`__init__` were added.
1296+
:meth:`!__init__` were added.
12971297

12981298

12991299
.. exception:: DuplicateOptionError
@@ -1345,9 +1345,9 @@ Exceptions
13451345

13461346
Exception raised when errors occur attempting to parse a file.
13471347

1348-
.. versionchanged:: 3.12
1349-
The ``filename`` attribute and :meth:`__init__` constructor argument were
1350-
removed. They have been available using the name ``source`` since 3.2.
1348+
.. versionchanged:: 3.12
1349+
The ``filename`` attribute and :meth:`!__init__` constructor argument were
1350+
removed. They have been available using the name ``source`` since 3.2.
13511351

13521352
.. rubric:: Footnotes
13531353

β€Ž_sources/library/logging.config.rst.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -93,8 +93,8 @@ in :mod:`logging` itself) and defining handlers which are declared either in
9393

9494
:param fname: A filename, or a file-like object, or an instance derived
9595
from :class:`~configparser.RawConfigParser`. If a
96-
``RawConfigParser``-derived instance is passed, it is used as
97-
is. Otherwise, a :class:`~configparser.Configparser` is
96+
:class:`!RawConfigParser`-derived instance is passed, it is used as
97+
is. Otherwise, a :class:`~configparser.ConfigParser` is
9898
instantiated, and the configuration read by it from the
9999
object passed in ``fname``. If that has a :meth:`readline`
100100
method, it is assumed to be a file-like object and read using
@@ -103,7 +103,7 @@ in :mod:`logging` itself) and defining handlers which are declared either in
103103
:meth:`~configparser.ConfigParser.read`.
104104

105105

106-
:param defaults: Defaults to be passed to the ConfigParser can be specified
106+
:param defaults: Defaults to be passed to the :class:`!ConfigParser` can be specified
107107
in this argument.
108108

109109
:param disable_existing_loggers: If specified as ``False``, loggers which

β€Ž_sources/library/signal.rst.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -157,6 +157,8 @@ The variables defined in the :mod:`signal` module are:
157157

158158
Alias to :data:`SIGCHLD`.
159159

160+
.. availability:: not macOS.
161+
160162
.. data:: SIGCONT
161163

162164
Continue the process if it is currently stopped

β€Ž_sources/reference/compound_stmts.rst.txt

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1362,12 +1362,15 @@ access the local variables of the function containing the def. See section
13621362

13631363
:pep:`526` - Syntax for Variable Annotations
13641364
Ability to type hint variable declarations, including class
1365-
variables and instance variables
1365+
variables and instance variables.
13661366

13671367
:pep:`563` - Postponed Evaluation of Annotations
13681368
Support for forward references within annotations by preserving
13691369
annotations in a string form at runtime instead of eager evaluation.
13701370

1371+
:pep:`318` - Decorators for Functions and Methods
1372+
Function and method decorators were introduced.
1373+
Class decorators were introduced in :pep:`3129`.
13711374

13721375
.. _class:
13731376

β€Ž_sources/whatsnew/2.0.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1030,7 +1030,7 @@ Module changes
10301030

10311031
Lots of improvements and bugfixes were made to Python's extensive standard
10321032
library; some of the affected modules include :mod:`readline`,
1033-
:mod:`ConfigParser`, :mod:`cgi`, :mod:`calendar`, :mod:`posix`, :mod:`readline`,
1033+
:mod:`ConfigParser <configparser>`, :mod:`cgi`, :mod:`calendar`, :mod:`posix`, :mod:`readline`,
10341034
:mod:`xmllib`, :mod:`aifc`, :mod:`chunk, wave`, :mod:`random`, :mod:`shelve`,
10351035
and :mod:`nntplib`. Consult the CVS logs for the exact patch-by-patch details.
10361036

β€Ž_sources/whatsnew/2.4.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1052,9 +1052,9 @@ complete list of changes, or look through the CVS logs for all the details.
10521052
advantage of :class:`collections.deque` for improved performance. (Contributed
10531053
by Raymond Hettinger.)
10541054

1055-
* The :mod:`ConfigParser` classes have been enhanced slightly. The :meth:`read`
1055+
* The :mod:`ConfigParser <configparser>` classes have been enhanced slightly. The :meth:`~configparser.ConfigParser.read`
10561056
method now returns a list of the files that were successfully parsed, and the
1057-
:meth:`set` method raises :exc:`TypeError` if passed a *value* argument that
1057+
:meth:`~configparser.ConfigParser.set` method raises :exc:`TypeError` if passed a *value* argument that
10581058
isn't a string. (Contributed by John Belmonte and David Goodger.)
10591059

10601060
* The :mod:`curses` module now supports the ncurses extension

β€Ž_sources/whatsnew/2.7.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -287,7 +287,7 @@ remains O(1).
287287
The standard library now supports use of ordered dictionaries in several
288288
modules.
289289

290-
* The :mod:`ConfigParser` module uses them by default, meaning that
290+
* The :mod:`ConfigParser <configparser>` module uses them by default, meaning that
291291
configuration files can now be read, modified, and then written back
292292
in their original order.
293293

@@ -1134,7 +1134,7 @@ changes, or look through the Subversion logs for all the details.
11341134
another type that isn't a :class:`Mapping`.
11351135
(Fixed by Daniel Stutzbach; :issue:`8729`.)
11361136

1137-
* Constructors for the parsing classes in the :mod:`ConfigParser` module now
1137+
* Constructors for the parsing classes in the :mod:`ConfigParser <configparser>` module now
11381138
take an *allow_no_value* parameter, defaulting to false; if true,
11391139
options without values will be allowed. For example::
11401140

β€Ž_sources/whatsnew/3.11.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1773,7 +1773,7 @@ Standard Library
17731773

17741774
* the :class:`!configparser.SafeConfigParser` class
17751775
* the :attr:`!configparser.ParsingError.filename` property
1776-
* the :meth:`configparser.RawConfigParser.readfp` method
1776+
* the :meth:`!configparser.RawConfigParser.readfp` method
17771777

17781778
(Contributed by Hugo van Kemenade in :issue:`45173`.)
17791779

@@ -1860,7 +1860,7 @@ Standard Library
18601860

18611861
(Contributed by Erlend E. Aasland in :issue:`5846`.)
18621862

1863-
* :meth:`~!unittest.TestProgram.usageExit` is marked deprecated, to be removed
1863+
* :meth:`!unittest.TestProgram.usageExit` is marked deprecated, to be removed
18641864
in 3.13.
18651865
(Contributed by Carlos DamΓ‘zio in :gh:`67048`.)
18661866

β€Ž_sources/whatsnew/3.12.rst.txt

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -343,7 +343,9 @@ cores. This is currently only available through the C-API,
343343
though a Python API is :pep:`anticipated for 3.13 <554>`.
344344

345345
Use the new :c:func:`Py_NewInterpreterFromConfig` function to
346-
create an interpreter with its own GIL::
346+
create an interpreter with its own GIL:
347+
348+
.. code-block:: c
347349
348350
PyInterpreterConfig config = {
349351
.check_multi_interp_extensions = 1,

β€Ž_sources/whatsnew/3.2.rst.txt

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -183,7 +183,7 @@ PEP 391: Dictionary Based Configuration for Logging
183183

184184
The :mod:`logging` module provided two kinds of configuration, one style with
185185
function calls for each option or another style driven by an external file saved
186-
in a :mod:`ConfigParser` format. Those options did not provide the flexibility
186+
in a :mod:`configparser` format. Those options did not provide the flexibility
187187
to create configurations from JSON or YAML files, nor did they support
188188
incremental configuration, which is needed for specifying logger options from a
189189
command line.
@@ -2134,7 +2134,7 @@ configparser
21342134

21352135
The :mod:`configparser` module was modified to improve usability and
21362136
predictability of the default parser and its supported INI syntax. The old
2137-
:class:`ConfigParser` class was removed in favor of :class:`SafeConfigParser`
2137+
:class:`!ConfigParser` class was removed in favor of :class:`!SafeConfigParser`
21382138
which has in turn been renamed to :class:`~configparser.ConfigParser`. Support
21392139
for inline comments is now turned off by default and section or option
21402140
duplicates are not allowed in a single configuration source.
@@ -2414,7 +2414,7 @@ when one operand is much larger than the other (patch by Andress Bennetts in
24142414
(:issue:`1569291` by Alexander Belopolsky). The :class:`BaseHTTPRequestHandler`
24152415
has more efficient buffering (:issue:`3709` by Andrew Schaaf). The
24162416
:func:`operator.attrgetter` function has been sped-up (:issue:`10160` by
2417-
Christos Georgiou). And :class:`ConfigParser` loads multi-line arguments a bit
2417+
Christos Georgiou). And :class:`~configparser.ConfigParser` loads multi-line arguments a bit
24182418
faster (:issue:`7113` by Łukasz Langa).
24192419

24202420

@@ -2614,8 +2614,8 @@ This section lists previously described changes and other bugfixes that may
26142614
require changes to your code:
26152615

26162616
* The :mod:`configparser` module has a number of clean-ups. The major change is
2617-
to replace the old :class:`ConfigParser` class with long-standing preferred
2618-
alternative :class:`SafeConfigParser`. In addition there are a number of
2617+
to replace the old :class:`!ConfigParser` class with long-standing preferred
2618+
alternative :class:`!SafeConfigParser`. In addition there are a number of
26192619
smaller incompatibilities:
26202620

26212621
* The interpolation syntax is now validated on

β€Ž_sources/whatsnew/3.7.rst.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2004,15 +2004,15 @@ importlib
20042004
---------
20052005

20062006
Methods
2007-
:meth:`MetaPathFinder.find_module() <!importlib.abc.MetaPathFinder.find_module>`
2007+
:meth:`!MetaPathFinder.find_module()`
20082008
(replaced by
20092009
:meth:`MetaPathFinder.find_spec() <importlib.abc.MetaPathFinder.find_spec>`)
20102010
and
2011-
:meth:`PathEntryFinder.find_loader() <!importlib.abc.PathEntryFinder.find_loader>`
2011+
:meth:`!PathEntryFinder.find_loader()`
20122012
(replaced by
20132013
:meth:`PathEntryFinder.find_spec() <importlib.abc.PathEntryFinder.find_spec>`)
20142014
both deprecated in Python 3.4 now emit :exc:`DeprecationWarning`.
2015-
(Contributed by Matthias Bussonnier in :issue:`29576`)
2015+
(Contributed by Matthias Bussonnier in :issue:`29576`.)
20162016

20172017
The :class:`importlib.abc.ResourceLoader` ABC has been deprecated in
20182018
favour of :class:`importlib.abc.ResourceReader`.

β€Žabout.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -294,7 +294,7 @@ <h3>瀏覽</h3>
294294
</ul>
295295
</div>
296296
<div class="footer">
297-
&copy; <a href="copyright.html">η‰ˆζ¬Š</a> 2001-2023, Python Software Foundation.
297+
&copy; <a href="copyright.html">η‰ˆζ¬Š</a> 2001-2024, Python Software Foundation.
298298
<br />
299299
This page is licensed under the Python Software Foundation License Version 2.
300300
<br />
@@ -308,7 +308,7 @@ <h3>瀏覽</h3>
308308
<br />
309309
<br />
310310

311-
ζœ€εΎŒζ›΄ζ–°ζ–Ό Dec 30, 2023 (06:08 UTC)。
311+
ζœ€εΎŒζ›΄ζ–°ζ–Ό Jan 03, 2024 (05:34 UTC)。
312312
<a href="/bugs.html">Found a bug</a>?
313313
<br />
314314

β€Žbugs.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -330,7 +330,7 @@ <h3>瀏覽</h3>
330330
</ul>
331331
</div>
332332
<div class="footer">
333-
&copy; <a href="copyright.html">η‰ˆζ¬Š</a> 2001-2023, Python Software Foundation.
333+
&copy; <a href="copyright.html">η‰ˆζ¬Š</a> 2001-2024, Python Software Foundation.
334334
<br />
335335
This page is licensed under the Python Software Foundation License Version 2.
336336
<br />
@@ -344,7 +344,7 @@ <h3>瀏覽</h3>
344344
<br />
345345
<br />
346346

347-
ζœ€εΎŒζ›΄ζ–°ζ–Ό Dec 30, 2023 (06:08 UTC)。
347+
ζœ€εΎŒζ›΄ζ–°ζ–Ό Jan 03, 2024 (05:34 UTC)。
348348
<a href="/bugs.html">Found a bug</a>?
349349
<br />
350350

β€Žc-api/abstract.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -304,7 +304,7 @@ <h3>瀏覽</h3>
304304
</ul>
305305
</div>
306306
<div class="footer">
307-
&copy; <a href="../copyright.html">η‰ˆζ¬Š</a> 2001-2023, Python Software Foundation.
307+
&copy; <a href="../copyright.html">η‰ˆζ¬Š</a> 2001-2024, Python Software Foundation.
308308
<br />
309309
This page is licensed under the Python Software Foundation License Version 2.
310310
<br />
@@ -318,7 +318,7 @@ <h3>瀏覽</h3>
318318
<br />
319319
<br />
320320

321-
ζœ€εΎŒζ›΄ζ–°ζ–Ό Dec 30, 2023 (06:08 UTC)。
321+
ζœ€εΎŒζ›΄ζ–°ζ–Ό Jan 03, 2024 (05:34 UTC)。
322322
<a href="/bugs.html">Found a bug</a>?
323323
<br />
324324

β€Žc-api/allocation.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -318,7 +318,7 @@ <h3>瀏覽</h3>
318318
</ul>
319319
</div>
320320
<div class="footer">
321-
&copy; <a href="../copyright.html">η‰ˆζ¬Š</a> 2001-2023, Python Software Foundation.
321+
&copy; <a href="../copyright.html">η‰ˆζ¬Š</a> 2001-2024, Python Software Foundation.
322322
<br />
323323
This page is licensed under the Python Software Foundation License Version 2.
324324
<br />
@@ -332,7 +332,7 @@ <h3>瀏覽</h3>
332332
<br />
333333
<br />
334334

335-
ζœ€εΎŒζ›΄ζ–°ζ–Ό Dec 30, 2023 (06:08 UTC)。
335+
ζœ€εΎŒζ›΄ζ–°ζ–Ό Jan 03, 2024 (05:34 UTC)。
336336
<a href="/bugs.html">Found a bug</a>?
337337
<br />
338338

β€Žc-api/apiabiversion.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -350,7 +350,7 @@ <h3>瀏覽</h3>
350350
</ul>
351351
</div>
352352
<div class="footer">
353-
&copy; <a href="../copyright.html">η‰ˆζ¬Š</a> 2001-2023, Python Software Foundation.
353+
&copy; <a href="../copyright.html">η‰ˆζ¬Š</a> 2001-2024, Python Software Foundation.
354354
<br />
355355
This page is licensed under the Python Software Foundation License Version 2.
356356
<br />
@@ -364,7 +364,7 @@ <h3>瀏覽</h3>
364364
<br />
365365
<br />
366366

367-
ζœ€εΎŒζ›΄ζ–°ζ–Ό Dec 30, 2023 (06:08 UTC)。
367+
ζœ€εΎŒζ›΄ζ–°ζ–Ό Jan 03, 2024 (05:34 UTC)。
368368
<a href="/bugs.html">Found a bug</a>?
369369
<br />
370370

0 commit comments

Comments
Β (0)