iSharkFly-Open
/
python-peps
mirror of https://github.com/python/peps.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Clarify PEP 384 (GH-610)

This commit is contained in:
jdemeyer 2019-02-05 16:46:56 +01:00 committed by Petr Viktorin
parent c1b361f770
commit acc0d461d1
1 changed files with 12 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
pep-0384.txt
View File

@ -211,13 +211,9 @@ of a Unicode string can convert it to wchar_t.
Functions and function-like Macros
----------------------------------
All functions starting with _Py are not available to applications
(see exceptions below).
Also, all functions that expect parameter types that are unavailable
to applications are excluded from the ABI, such as PyAST_FromNode
(which expects a ``node*``).
All other functions are available, unless excluded below.
By default, all functions are available, unless they are excluded
below.
Whether a function is documented or not does not matter.
Function-like macros (in particular, field access macros) remain
available to applications, but get replaced by function calls
@ -232,12 +228,17 @@ redirect calls to the new function when the applications is
recompiled.
If continued provision of the old function is not possible, it may get
deprecated, then removed, in accordance with PEP 7, causing
deprecated, then removed, causing
applications that use that function to break.
Excluded Functions
------------------
All functions starting with _Py are not available to applications.
Also, all functions that expect parameter types that are unavailable
to applications are excluded from the ABI, such as PyAST_FromNode
(which expects a ``node*``).
Functions declared in the following header files are not part
of the ABI:
@ -266,11 +267,9 @@ In addition, functions expecting ``FILE*`` are not part of
the ABI, to avoid depending on a specific version of the
Microsoft C runtime DLL on Windows.
Module and type initalizer functions are not available
(PyByteArray_Init, PyByteArray_Fini, PyBytes_Fini,
PyCFunction_Fini, PyDict_Fini, PyFloat_ClearFreeList,
PyFloat_Fini, PyFrame_Fini, PyList_Fini, PyMethod_Fini,
PyOS_FiniInterrupts, PySet_Fini, PyTuple_Fini).
Module and type initializer and finalizer functions are not available
(PyByteArray_Init, PyOS_FiniInterrupts
and all functions ending in _Fini or _ClearFreeList).
Several functions dealing with interpreter implementation
details are not available: