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 c9868d7

Browse filesBrowse files
mattwang44mattwang44
committed
Deploying to gh-pages from @ f8ef476 🚀
1 parent 55bf6da commit c9868d7
Copy full SHA for c9868d7

File tree

Expand file treeCollapse file tree

570 files changed

+8243
-8055
lines changed
Open diff view settings
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
Expand file treeCollapse file tree

570 files changed

+8243
-8055
lines changed
Open diff view settings
Collapse file

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

Copy file name to clipboardExpand all lines: _sources/c-api/code.rst.txt
+1-1Lines changed: 1 addition & 1 deletion
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -182,7 +182,7 @@ bound into a function.
182182
Type of a code object watcher callback function.
183183
184184
If *event* is ``PY_CODE_EVENT_CREATE``, then the callback is invoked
185-
after `co` has been fully initialized. Otherwise, the callback is invoked
185+
after *co* has been fully initialized. Otherwise, the callback is invoked
186186
before the destruction of *co* takes place, so the prior state of *co*
187187
can be inspected.
188188
Collapse file

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

Copy file name to clipboardExpand all lines: _sources/c-api/function.rst.txt
+1-1Lines changed: 1 addition & 1 deletion
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -169,7 +169,7 @@ There are a few functions specific to Python functions.
169169
unpredictable effects, including infinite recursion.
170170
171171
If *event* is ``PyFunction_EVENT_CREATE``, then the callback is invoked
172-
after `func` has been fully initialized. Otherwise, the callback is invoked
172+
after *func* has been fully initialized. Otherwise, the callback is invoked
173173
before the modification to *func* takes place, so the prior state of *func*
174174
can be inspected. The runtime is permitted to optimize away the creation of
175175
function objects when possible. In such cases no event will be emitted.
Collapse file

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

Copy file name to clipboardExpand all lines: _sources/c-api/typeobj.rst.txt
+5-4Lines changed: 5 additions & 4 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ Quick Reference
7979
| :c:member:`~PyTypeObject.tp_setattro` | :c:type:`setattrofunc` | __setattr__, | X | X | | G |
8080
| | | __delattr__ | | | | |
8181
+------------------------------------------------+-----------------------------------+-------------------+---+---+---+---+
82-
| :c:member:`~PyTypeObject.tp_as_buffer` | :c:type:`PyBufferProcs` * | | | | | % |
82+
| :c:member:`~PyTypeObject.tp_as_buffer` | :c:type:`PyBufferProcs` * | :ref:`sub-slots` | | | | % |
8383
+------------------------------------------------+-----------------------------------+-------------------+---+---+---+---+
8484
| :c:member:`~PyTypeObject.tp_flags` | unsigned long | | X | X | | ? |
8585
+------------------------------------------------+-----------------------------------+-------------------+---+---+---+---+
@@ -325,9 +325,10 @@ sub-slots
325325
+---------------------------------------------------------+-----------------------------------+---------------+
326326
| |
327327
+---------------------------------------------------------+-----------------------------------+---------------+
328-
| :c:member:`~PyBufferProcs.bf_getbuffer` | :c:func:`getbufferproc` | |
328+
| :c:member:`~PyBufferProcs.bf_getbuffer` | :c:func:`getbufferproc` | __buffer__ |
329329
+---------------------------------------------------------+-----------------------------------+---------------+
330-
| :c:member:`~PyBufferProcs.bf_releasebuffer` | :c:func:`releasebufferproc` | |
330+
| :c:member:`~PyBufferProcs.bf_releasebuffer` | :c:func:`releasebufferproc` | __release_\ |
331+
| | | buffer\__ |
331332
+---------------------------------------------------------+-----------------------------------+---------------+
332333

333334
.. _slot-typedefs-table:
@@ -1186,7 +1187,7 @@ and :c:data:`PyType_Type` effectively act as defaults.)
11861187

11871188
.. c:macro:: Py_TPFLAGS_MANAGED_DICT
11881189
1189-
This bit indicates that instances of the class have a `~object.__dict__`
1190+
This bit indicates that instances of the class have a :attr:`~object.__dict__`
11901191
attribute, and that the space for the dictionary is managed by the VM.
11911192

11921193
If this flag is set, :c:macro:`Py_TPFLAGS_HAVE_GC` should also be set.
Collapse file

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

Copy file name to clipboardExpand all lines: _sources/howto/free-threading-extensions.rst.txt
+1-1Lines changed: 1 addition & 1 deletion
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -249,7 +249,7 @@ The wheels, shared libraries, and binaries are indicated by a ``t`` suffix.
249249
free-threaded build, with the ``t`` suffix, such as ``python3.13t``.
250250
* `pypa/cibuildwheel <https://github.com/pypa/cibuildwheel>`_ supports the
251251
free-threaded build if you set
252-
`CIBW_FREE_THREADED_SUPPORT <https://cibuildwheel.pypa.io/en/stable/options/#free-threaded-support>`_.
252+
`CIBW_ENABLE to cpython-freethreading <https://cibuildwheel.pypa.io/en/stable/options/#enable>`_.
253253

254254
Limited C API and Stable ABI
255255
............................
Collapse file

‎_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
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ optionally support installing free-threaded Python binaries. The installers
3232
are available at https://www.python.org/downloads/.
3333

3434
For information on other platforms, see the `Installing a Free-Threaded Python
35-
<https://py-free-threading.github.io/installing_cpython/>`_, a
35+
<https://py-free-threading.github.io/installing-cpython/>`_, a
3636
community-maintained installation guide for installing free-threaded Python.
3737

3838
When building CPython from source, the :option:`--disable-gil` configure option
Collapse file

‎_sources/howto/isolating-extensions.rst.txt‎

Copy file name to clipboardExpand all lines: _sources/howto/isolating-extensions.rst.txt
+15Lines changed: 15 additions & 0 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -215,21 +215,36 @@ multiple interpreters correctly. If this is not yet the case for your
215215
module, you can explicitly make your module loadable only once per
216216
process. For example::
217217

218+
// A process-wide flag
218219
static int loaded = 0;
219220

221+
// Mutex to provide thread safety (only needed for free-threaded Python)
222+
static PyMutex modinit_mutex = {0};
223+
220224
static int
221225
exec_module(PyObject* module)
222226
{
227+
PyMutex_Lock(&modinit_mutex);
223228
if (loaded) {
229+
PyMutex_Unlock(&modinit_mutex);
224230
PyErr_SetString(PyExc_ImportError,
225231
"cannot load module more than once per process");
226232
return -1;
227233
}
228234
loaded = 1;
235+
PyMutex_Unlock(&modinit_mutex);
229236
// ... rest of initialization
230237
}
231238

232239

240+
If your module's :c:member:`PyModuleDef.m_clear` function is able to prepare
241+
for future re-initialization, it should clear the ``loaded`` flag.
242+
In this case, your module won't support multiple instances existing
243+
*concurrently*, but it will, for example, support being loaded after
244+
Python runtime shutdown (:c:func:`Py_FinalizeEx`) and re-initialization
245+
(:c:func:`Py_Initialize`).
246+
247+
233248
Module State Access from Functions
234249
----------------------------------
235250

Collapse file

‎_sources/library/code.rst.txt‎

Copy file name to clipboardExpand all lines: _sources/library/code.rst.txt
+6Lines changed: 6 additions & 0 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,12 @@ build applications which provide an interactive interpreter prompt.
2222
it defaults to a newly created dictionary with key ``'__name__'`` set to
2323
``'__console__'`` and key ``'__doc__'`` set to ``None``.
2424

25+
Note that functions and classes objects created under an
26+
:class:`!InteractiveInterpreter` instance will belong to the namespace
27+
specified by *locals*.
28+
They are only pickleable if *locals* is the namespace of an existing
29+
module.
30+
2531

2632
.. class:: InteractiveConsole(locals=None, filename="<console>", local_exit=False)
2733

Collapse file

‎_sources/library/decimal.rst.txt‎

Copy file name to clipboardExpand all lines: _sources/library/decimal.rst.txt
+42-30Lines changed: 42 additions & 30 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
=====================================================================
33

44
.. module:: decimal
5-
:synopsis: Implementation of the General Decimal Arithmetic Specification.
5+
:synopsis: Implementation of the General Decimal Arithmetic Specification.
66

77
.. moduleauthor:: Eric Price <eprice at tjhsst.edu>
88
.. moduleauthor:: Facundo Batista <facundo at taniquetil.com.ar>
@@ -121,7 +121,7 @@ reset them before monitoring a calculation.
121121
122122
.. _decimal-tutorial:
123123

124-
Quick-start Tutorial
124+
Quick-start tutorial
125125
--------------------
126126

127127
The usual start to using decimals is importing the module, viewing the current
@@ -1071,40 +1071,52 @@ In addition to the three supplied contexts, new contexts can be created with the
10711071
default values are copied from the :const:`DefaultContext`. If the *flags*
10721072
field is not specified or is :const:`None`, all flags are cleared.
10731073

1074-
*prec* is an integer in the range [``1``, :const:`MAX_PREC`] that sets
1075-
the precision for arithmetic operations in the context.
1074+
.. attribute:: prec
10761075

1077-
The *rounding* option is one of the constants listed in the section
1078-
`Rounding Modes`_.
1076+
An integer in the range [``1``, :const:`MAX_PREC`] that sets
1077+
the precision for arithmetic operations in the context.
10791078

1080-
The *traps* and *flags* fields list any signals to be set. Generally, new
1081-
contexts should only set traps and leave the flags clear.
1079+
.. attribute:: rounding
10821080

1083-
The *Emin* and *Emax* fields are integers specifying the outer limits allowable
1084-
for exponents. *Emin* must be in the range [:const:`MIN_EMIN`, ``0``],
1085-
*Emax* in the range [``0``, :const:`MAX_EMAX`].
1081+
One of the constants listed in the section `Rounding Modes`_.
10861082

1087-
The *capitals* field is either ``0`` or ``1`` (the default). If set to
1088-
``1``, exponents are printed with a capital ``E``; otherwise, a
1089-
lowercase ``e`` is used: ``Decimal('6.02e+23')``.
1083+
.. attribute:: traps
1084+
flags
10901085

1091-
The *clamp* field is either ``0`` (the default) or ``1``.
1092-
If set to ``1``, the exponent ``e`` of a :class:`Decimal`
1093-
instance representable in this context is strictly limited to the
1094-
range ``Emin - prec + 1 <= e <= Emax - prec + 1``. If *clamp* is
1095-
``0`` then a weaker condition holds: the adjusted exponent of
1096-
the :class:`Decimal` instance is at most :attr:`~Context.Emax`. When *clamp* is
1097-
``1``, a large normal number will, where possible, have its
1098-
exponent reduced and a corresponding number of zeros added to its
1099-
coefficient, in order to fit the exponent constraints; this
1100-
preserves the value of the number but loses information about
1101-
significant trailing zeros. For example::
1086+
Lists of any signals to be set. Generally, new contexts should only set
1087+
traps and leave the flags clear.
11021088

1103-
>>> Context(prec=6, Emax=999, clamp=1).create_decimal('1.23e999')
1104-
Decimal('1.23000E+999')
1089+
.. attribute:: Emin
1090+
Emax
11051091

1106-
A *clamp* value of ``1`` allows compatibility with the
1107-
fixed-width decimal interchange formats specified in IEEE 754.
1092+
Integers specifying the outer limits allowable for exponents. *Emin* must
1093+
be in the range [:const:`MIN_EMIN`, ``0``], *Emax* in the range
1094+
[``0``, :const:`MAX_EMAX`].
1095+
1096+
.. attribute:: capitals
1097+
1098+
Either ``0`` or ``1`` (the default). If set to
1099+
``1``, exponents are printed with a capital ``E``; otherwise, a
1100+
lowercase ``e`` is used: ``Decimal('6.02e+23')``.
1101+
1102+
.. attribute:: clamp
1103+
1104+
Either ``0`` (the default) or ``1``. If set to ``1``, the exponent ``e``
1105+
of a :class:`Decimal` instance representable in this context is strictly
1106+
limited to the range ``Emin - prec + 1 <= e <= Emax - prec + 1``.
1107+
If *clamp* is ``0`` then a weaker condition holds: the adjusted exponent of
1108+
the :class:`Decimal` instance is at most :attr:`~Context.Emax`. When *clamp* is
1109+
``1``, a large normal number will, where possible, have its
1110+
exponent reduced and a corresponding number of zeros added to its
1111+
coefficient, in order to fit the exponent constraints; this
1112+
preserves the value of the number but loses information about
1113+
significant trailing zeros. For example::
1114+
1115+
>>> Context(prec=6, Emax=999, clamp=1).create_decimal('1.23e999')
1116+
Decimal('1.23000E+999')
1117+
1118+
A *clamp* value of ``1`` allows compatibility with the
1119+
fixed-width decimal interchange formats specified in IEEE 754.
11081120

11091121
The :class:`Context` class defines several general purpose methods as well as
11101122
a large number of methods for doing arithmetic directly in a given context.
@@ -1743,7 +1755,7 @@ The following table summarizes the hierarchy of signals::
17431755
17441756
.. _decimal-notes:
17451757

1746-
Floating-Point Notes
1758+
Floating-point notes
17471759
--------------------
17481760

17491761

Collapse file

‎_sources/library/functions.rst.txt‎

Copy file name to clipboardExpand all lines: _sources/library/functions.rst.txt
+38-38Lines changed: 38 additions & 38 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -1147,44 +1147,44 @@ are always available. They are listed here in alphabetical order.
11471147

11481148
.. function:: locals()
11491149

1150-
Return a mapping object representing the current local symbol table, with
1151-
variable names as the keys, and their currently bound references as the
1152-
values.
1153-
1154-
At module scope, as well as when using :func:`exec` or :func:`eval` with
1155-
a single namespace, this function returns the same namespace as
1156-
:func:`globals`.
1157-
1158-
At class scope, it returns the namespace that will be passed to the
1159-
metaclass constructor.
1160-
1161-
When using ``exec()`` or ``eval()`` with separate local and global
1162-
arguments, it returns the local namespace passed in to the function call.
1163-
1164-
In all of the above cases, each call to ``locals()`` in a given frame of
1165-
execution will return the *same* mapping object. Changes made through
1166-
the mapping object returned from ``locals()`` will be visible as assigned,
1167-
reassigned, or deleted local variables, and assigning, reassigning, or
1168-
deleting local variables will immediately affect the contents of the
1169-
returned mapping object.
1170-
1171-
In an :term:`optimized scope` (including functions, generators, and
1172-
coroutines), each call to ``locals()`` instead returns a fresh dictionary
1173-
containing the current bindings of the function's local variables and any
1174-
nonlocal cell references. In this case, name binding changes made via the
1175-
returned dict are *not* written back to the corresponding local variables
1176-
or nonlocal cell references, and assigning, reassigning, or deleting local
1177-
variables and nonlocal cell references does *not* affect the contents
1178-
of previously returned dictionaries.
1179-
1180-
Calling ``locals()`` as part of a comprehension in a function, generator, or
1181-
coroutine is equivalent to calling it in the containing scope, except that
1182-
the comprehension's initialised iteration variables will be included. In
1183-
other scopes, it behaves as if the comprehension were running as a nested
1184-
function.
1185-
1186-
Calling ``locals()`` as part of a generator expression is equivalent to
1187-
calling it in a nested generator function.
1150+
Return a mapping object representing the current local symbol table, with
1151+
variable names as the keys, and their currently bound references as the
1152+
values.
1153+
1154+
At module scope, as well as when using :func:`exec` or :func:`eval` with
1155+
a single namespace, this function returns the same namespace as
1156+
:func:`globals`.
1157+
1158+
At class scope, it returns the namespace that will be passed to the
1159+
metaclass constructor.
1160+
1161+
When using ``exec()`` or ``eval()`` with separate local and global
1162+
arguments, it returns the local namespace passed in to the function call.
1163+
1164+
In all of the above cases, each call to ``locals()`` in a given frame of
1165+
execution will return the *same* mapping object. Changes made through
1166+
the mapping object returned from ``locals()`` will be visible as assigned,
1167+
reassigned, or deleted local variables, and assigning, reassigning, or
1168+
deleting local variables will immediately affect the contents of the
1169+
returned mapping object.
1170+
1171+
In an :term:`optimized scope` (including functions, generators, and
1172+
coroutines), each call to ``locals()`` instead returns a fresh dictionary
1173+
containing the current bindings of the function's local variables and any
1174+
nonlocal cell references. In this case, name binding changes made via the
1175+
returned dict are *not* written back to the corresponding local variables
1176+
or nonlocal cell references, and assigning, reassigning, or deleting local
1177+
variables and nonlocal cell references does *not* affect the contents
1178+
of previously returned dictionaries.
1179+
1180+
Calling ``locals()`` as part of a comprehension in a function, generator, or
1181+
coroutine is equivalent to calling it in the containing scope, except that
1182+
the comprehension's initialised iteration variables will be included. In
1183+
other scopes, it behaves as if the comprehension were running as a nested
1184+
function.
1185+
1186+
Calling ``locals()`` as part of a generator expression is equivalent to
1187+
calling it in a nested generator function.
11881188

11891189
.. versionchanged:: 3.12
11901190
The behaviour of ``locals()`` in a comprehension has been updated as
Collapse file

‎_sources/library/hashlib.rst.txt‎

Copy file name to clipboardExpand all lines: _sources/library/hashlib.rst.txt
+1-1Lines changed: 1 addition & 1 deletion
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -284,7 +284,7 @@ a file or file-like object.
284284
Example:
285285

286286
>>> import io, hashlib, hmac
287-
>>> with open(hashlib.__file__, "rb") as f:
287+
>>> with open("library/hashlib.rst", "rb") as f:
288288
... digest = hashlib.file_digest(f, "sha256")
289289
...
290290
>>> digest.hexdigest() # doctest: +ELLIPSIS

0 commit comments

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