Gecko [ satitravel.com ]

Name	Size	Permission	Date
abstract.rst.txt	715 B	-rw-r--r--	2018-10-20 05:24
allocation.rst.txt	2.59 KB	-rw-r--r--	2018-10-20 05:24
apiabiversion.rst.txt	2.19 KB	-rw-r--r--	2018-10-20 05:24
arg.rst.txt	29.93 KB	-rw-r--r--	2018-10-20 05:24
bool.rst.txt	1.17 KB	-rw-r--r--	2018-10-20 05:24
buffer.rst.txt	21.75 KB	-rw-r--r--	2018-10-20 05:24
bytearray.rst.txt	2.2 KB	-rw-r--r--	2018-10-20 05:24
bytes.rst.txt	9 KB	-rw-r--r--	2018-10-20 05:24
capsule.rst.txt	5.61 KB	-rw-r--r--	2018-10-20 05:24
cell.rst.txt	1.89 KB	-rw-r--r--	2018-10-20 05:24
code.rst.txt	1.63 KB	-rw-r--r--	2018-10-20 05:24
codec.rst.txt	4.69 KB	-rw-r--r--	2018-10-20 05:24
complex.rst.txt	3.85 KB	-rw-r--r--	2018-10-20 05:24
concrete.rst.txt	2 KB	-rw-r--r--	2018-10-20 05:24
conversion.rst.txt	5.39 KB	-rw-r--r--	2018-10-20 05:24
coro.rst.txt	820 B	-rw-r--r--	2018-10-20 05:24
datetime.rst.txt	6.26 KB	-rw-r--r--	2018-10-20 05:24
descriptor.rst.txt	1.08 KB	-rw-r--r--	2018-10-20 05:24
dict.rst.txt	7.77 KB	-rw-r--r--	2018-10-20 05:24
exceptions.rst.txt	46.69 KB	-rw-r--r--	2018-10-20 05:24
file.rst.txt	3.17 KB	-rw-r--r--	2018-10-20 05:24
float.rst.txt	2.19 KB	-rw-r--r--	2018-10-20 05:24
function.rst.txt	3.27 KB	-rw-r--r--	2018-10-20 05:24
gcsupport.rst.txt	5.92 KB	-rw-r--r--	2018-10-20 05:24
gen.rst.txt	1.27 KB	-rw-r--r--	2018-10-20 05:24
import.rst.txt	12.52 KB	-rw-r--r--	2018-10-20 05:24
index.rst.txt	613 B	-rw-r--r--	2018-10-20 05:24
init.rst.txt	51.16 KB	-rw-r--r--	2018-10-20 05:24
intro.rst.txt	28.08 KB	-rw-r--r--	2018-10-20 05:24
iter.rst.txt	1.1 KB	-rw-r--r--	2018-10-20 05:24
iterator.rst.txt	1.6 KB	-rw-r--r--	2018-10-20 05:24
list.rst.txt	4.62 KB	-rw-r--r--	2018-10-20 05:24
long.rst.txt	10.19 KB	-rw-r--r--	2018-10-20 05:24
mapping.rst.txt	2.8 KB	-rw-r--r--	2018-10-20 05:24
marshal.rst.txt	3.48 KB	-rw-r--r--	2018-10-20 05:24
memory.rst.txt	20.87 KB	-rw-r--r--	2018-10-20 05:24
memoryview.rst.txt	2.29 KB	-rw-r--r--	2018-10-20 05:24
method.rst.txt	2.75 KB	-rw-r--r--	2018-10-20 05:24
module.rst.txt	17.84 KB	-rw-r--r--	2018-10-20 05:24
none.rst.txt	740 B	-rw-r--r--	2018-10-20 05:24
number.rst.txt	10.33 KB	-rw-r--r--	2018-10-20 05:24
objbuffer.rst.txt	2.15 KB	-rw-r--r--	2018-10-20 05:24
object.rst.txt	17.01 KB	-rw-r--r--	2018-10-20 05:24
objimpl.rst.txt	304 B	-rw-r--r--	2018-10-20 05:24
refcounting.rst.txt	2.84 KB	-rw-r--r--	2018-10-20 05:24
reflection.rst.txt	1.38 KB	-rw-r--r--	2018-10-20 05:24
sequence.rst.txt	6.39 KB	-rw-r--r--	2018-10-20 05:24
set.rst.txt	6 KB	-rw-r--r--	2018-10-20 05:24
slice.rst.txt	2.35 KB	-rw-r--r--	2018-10-20 05:24
stable.rst.txt	1.92 KB	-rw-r--r--	2018-10-20 05:24
structures.rst.txt	13.46 KB	-rw-r--r--	2018-10-20 05:24
sys.rst.txt	9.71 KB	-rw-r--r--	2018-10-20 05:24
tuple.rst.txt	7.84 KB	-rw-r--r--	2018-10-20 05:24
type.rst.txt	3.87 KB	-rw-r--r--	2018-10-20 05:24
typeobj.rst.txt	58.77 KB	-rw-r--r--	2018-10-20 05:24
unicode.rst.txt	66.48 KB	-rw-r--r--	2018-10-20 05:24
utilities.rst.txt	414 B	-rw-r--r--	2018-10-20 05:24
veryhigh.rst.txt	16.26 KB	-rw-r--r--	2018-10-20 05:24
weakref.rst.txt	2.57 KB	-rw-r--r--	2018-10-20 05:24

Rename

.. highlightlang:: c

.. _stable:

***********************************
Stable Application Binary Interface
***********************************

Traditionally, the C API of Python will change with every release.  Most changes
will be source-compatible, typically by only adding API, rather than changing
existing API or removing API (although some interfaces do get removed after
being deprecated first).

Unfortunately, the API compatibility does not extend to binary compatibility
(the ABI). The reason is primarily the evolution of struct definitions, where
addition of a new field, or changing the type of a field, might not break the
API, but can break the ABI.  As a consequence, extension modules need to be
recompiled for every Python release (although an exception is possible on Unix
when none of the affected interfaces are used). In addition, on Windows,
extension modules link with a specific pythonXY.dll and need to be recompiled to
link with a newer one.

Since Python 3.2, a subset of the API has been declared to guarantee a stable
ABI. Extension modules wishing to use this API (called "limited API") need to
define ``Py_LIMITED_API``. A number of interpreter details then become hidden
from the extension module; in return, a module is built that works on any 3.x
version (x>=2) without recompilation.

In some cases, the stable ABI needs to be extended with new functions.
Extension modules wishing to use these new APIs need to set ``Py_LIMITED_API``
to the ``PY_VERSION_HEX`` value (see :ref:`apiabiversion`) of the minimum Python
version they want to support (e.g. ``0x03030000`` for Python 3.3). Such modules
will work on all subsequent Python releases, but fail to load (because of
missing symbols) on the older releases.

As of Python 3.2, the set of functions available to the limited API is
documented in :pep:`384`.  In the C API documentation, API elements that are not
part of the limited API are marked as "Not part of the limited API."