GeezerVison

Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,68 @@
		The Python C API
		================

		The C API is divided into three sections:

		1. ``Include/``
		2. ``Include/cpython/``
		3. ``Include/internal/``


		Include: Limited API
		====================

		``Include/``, excluding the ``cpython`` and ``internal`` subdirectories,
		contains the public Limited API (Application Programming Interface).
		The Limited API is a subset of the C API, designed to guarantee ABI
		stability across Python 3 versions, and is defined in :pep:`384`.

		Guidelines for expanding the Limited API:

		- Functions must not steal references
		- Functions must not return borrowed references
		- Functions returning references must return a strong reference
		- Macros should not expose implementation details
		- Please start a public discussion before expanding the API
		- Functions or macros with a ``_Py`` prefix do not belong in ``Include/``.

		It is possible to add a function or macro to the Limited API from a
		given Python version. For example, to add a function to the Limited API
		from Python 3.10 and onwards, wrap it with
		``#if !defined(Py_LIMITED_API) \|\| Py_LIMITED_API+0 >= 0x030A0000``.


		Include/cpython: CPython implementation details
		===============================================

		``Include/cpython/`` contains the public API that is excluded from the
		Limited API and the Stable ABI.

		Guidelines for expanding the public API:

		- Functions must not steal references
		- Functions must not return borrowed references
		- Functions returning references must return a strong reference


		Include/internal: The internal API
		==================================


		With PyAPI_FUNC or PyAPI_DATA
		-----------------------------

		Functions or structures in ``Include/internal/`` defined with
		``PyAPI_FUNC`` or ``PyAPI_DATA`` are internal functions which are
		exposed only for specific use cases like debuggers and profilers.


		With the extern keyword
		-----------------------

		Functions in ``Include/internal/`` defined with the ``extern`` keyword
		must not and can not be used outside the CPython code base. Only
		built-in stdlib extensions (built with the ``Py_BUILD_CORE_BUILTIN``
		macro defined) can use such functions.

		When in doubt, new internal C functions should be defined in
		``Include/internal`` using the ``extern`` keyword.

Add this suggestion to a batch that can be applied as a single commit. This suggestion is invalid because no changes were made to the code. Suggestions cannot be applied while the pull request is closed. Suggestions cannot be applied while viewing a subset of changes. Only one suggestion per line can be applied in a batch. Add this suggestion to a batch that can be applied as a single commit. Applying suggestions on deleted lines is not supported. You must change the existing code in this line in order to create a valid suggestion. Outdated suggestions cannot be applied. This suggestion has been applied or marked resolved. Suggestions cannot be applied from pending reviews. Suggestions cannot be applied on multi-line comments. Suggestions cannot be applied while the pull request is queued to merge. Suggestion cannot be applied right now. Please check back later.

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.