Справочное руководство по API Python/C

В этом руководстве документирован API, используемый программистами на C и C++, которые хотят писать модули расширения или встраивать Python. Это дополнение к документу Расширение и встраивание интерпретатора Python, в котором описаны общие принципы создания расширений, но функции API не документированы подробно.

• Введение
  • Совместимость версий языка
  • Стандарты кодирования
  • Файлы включения
  • Полезные макросы
  • Объекты, типы и счётчики ссылок
  • Исключения
  • Встраивание Python
  • Отладочные сборки
  • Рекомендуемые сторонние инструменты
• Стабильность C API
  • Нестабильный C API
  • Стабильный двоичный интерфейс приложений
  • Особенности платформ
  • Состав Limited API
• Слой очень высокого уровня
  • Доступные начальные символы
  • Эффекты для стека
• Подсчёт ссылок
• Обработка исключений
  • Вывод и сброс
  • Возбуждение исключений
  • Выдача предупреждений
  • Проверка индикатора ошибки
  • Обработка сигналов
  • Классы исключений
  • Объекты исключений
  • Объекты исключений Unicode
  • Управление рекурсией
  • Типы исключений и предупреждений
  • Трассировки стека
• Определение модулей расширения
  • Несколько экземпляров модуля
  • Функция инициализации
  • Многоэтапная инициализация
  • Устаревшая одноэтапная инициализация
• Утилиты
  • Утилиты операционной системы
  • Системные функции
  • Управление процессами
  • Импорт модулей
  • Поддержка сериализации данных
  • Разбор аргументов и создание значений
  • Преобразование и форматирование строк
  • Классификация и преобразование символов
  • API PyHash
  • Рефлексия
  • Реестр кодеков и вспомогательные функции
  • C API PyTime
  • Поддержка Perf Maps
• Слой абстрактных объектов
  • Протокол объектов
  • Протокол вызова
  • Числовой протокол
  • Протокол последовательностей
  • Протокол отображений
  • Протокол итератора
  • Протокол буфера
• Слой конкретных объектов
  • Основные объекты
  • Числовые объекты
  • Объекты-последовательности
  • Объекты-контейнеры
  • Объекты-функции
  • Другие объекты
  • C API для модулей расширения
• Инициализация и завершение работы интерпретатора
  • До инициализации Python
  • Глобальные переменные конфигурации
  • Инициализация и завершение работы интерпретатора
  • Предупреждения о завершении работы среды выполнения
  • Параметры уровня процесса
• Состояния потоков и глобальная блокировка интерпретатора
  • Отсоединение состояния потока от кода расширения
  • Потоки, созданные не Python
  • Устаревший API
  • Предупреждения о fork()
  • Высокоуровневые API
  • API состояния GIL
  • Низкоуровневые API
• Асинхронные уведомления
• API потоков операционной системы
• Примитивы синхронизации
  • API критических секций Python
  • Устаревшие API блокировок
• Поддержка локального хранилища потоков
  • API хранилища для отдельных потоков
  • Динамическое выделение памяти
  • Методы
  • Устаревшие API
• Несколько интерпретаторов в процессе Python
  • Отдельный GIL для каждого интерпретатора
  • Ошибки и предостережения
  • Высокоуровневые API
  • Низкоуровневые API
  • Расширенная поддержка отладчика
• Профилирование и трассировка
• Трассировка ссылок
• Конфигурация инициализации Python
  • C API PyInitConfig
  • Параметры конфигурации
  • API конфигурации Python во время выполнения
  • C API PyConfig
  • Py_GetArgcArgv()
  • Отложенный запуск главного модуля
• Управление памятью
  • Обзор
  • Домены распределителей памяти
  • Интерфейс работы с необработанной памятью
  • Интерфейс работы с памятью
  • Распределители памяти объектов
  • Распределители памяти по умолчанию
  • Настройка распределителей памяти
  • Отладочные перехватчики распределителей памяти Python
  • Распределитель pymalloc
  • Распределитель mimalloc
  • C API tracemalloc
  • Примеры
• Поддержка реализации объектов
  • Выделение памяти для объектов в куче
  • Жизненный цикл объекта
  • Общие структуры объектов
  • Структуры объектов типов
  • Поддержка циклического сборщика мусора
• Версионирование API и ABI
  • Константы версии на этапе сборки
  • Версия во время выполнения
  • Макросы упаковки битов
• C API мониторинга
• Генерация событий выполнения
  • Управление состоянием мониторинга