Справочник по API Python/C

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

• Введение
  • Стандарты кодирования
  • Файлы включаемых файлов
  • Полезные макросы
  • Объекты, типы и счётчики ссылок
  • Исключения
  • Встраивание Python
  • Отладочные сборки
• Стабильность API на C
  • Нестабильный C API
  • Стабильный интерфейс приложения для двоичных файлов
  • Платформенные соображения
  • Содержание ограниченного API
• Высокоуровневый слой
• Счётчик ссылок
• Обработка исключений
  • Вывод и очистка
  • Выбрасывание исключений
  • Выдача предупреждений
  • Запрос индикатора ошибки
  • Обработка сигналов
  • Классы исключений
  • Объекты исключений
  • Объекты исключений Unicode
  • Управление рекурсией
  • Стандартные исключения
  • Стандартные категории предупреждений
• Утилиты
  • Утилиты операционной системы
  • Функции системы
  • Управление процессами
  • Импорт модулей
  • Поддержка маппинга данных
  • Разбор аргументов и построение значений
  • Преобразование и форматирование строк
  • API PyHash
  • Рефлексия
  • Реестр кодеков и вспомогательные функции
  • Поддержка Perf Maps
• Абстрактный слой объектов
  • Протокол объектов
  • Протокол вызовов
  • Протокол чисел
  • Протокол последовательностей
  • Протокол отображений
  • Протокол итераторов
  • Протокол буфера
  • Старый протокол буфера
• Конкретный слой объектов
  • Основные объекты
  • Числовые объекты
  • Объекты последовательностей
  • Объекты контейнеров
  • Объекты функций
  • Другие объекты
• Инициализация, завершение и потоки
  • Перед инициализацией Python
  • Глобальные переменные конфигурации
  • Инициализация и завершение интерпретатора
  • Параметры, глобальные для процесса
  • Состояние потока и глобальная блокировка интерпретатора
  • Поддержка под-интерпретаторов
  • Асинхронные уведомления
  • Профилирование и трассировка
  • Расширенная поддержка отладчика
  • Поддержка локального хранилища потоков
• Конфигурация инициализации Python
  • Пример
  • PyWideStringList
  • PyStatus
  • PyPreConfig
  • Предварительная инициализация Python с PyPreConfig
  • PyConfig
  • Инициализация с PyConfig
  • Изолированная конфигурация
  • Конфигурация Python
  • Конфигурация пути к Python
  • Py_RunMain()
  • Py_GetArgcArgv()
  • Многофазная инициализация: приватный предварительный API
• Управление памятью
  • Обзор
  • Области выделения памяти
  • Интерфейс необработанной памяти
  • Интерфейс памяти
  • Выделение объектов
  • По умолчанию выделения памяти
  • Настройка выделения памяти
  • Отладочные хуки для выделения памяти Python
  • Выделение pymalloc
  • Tracemalloc C API
  • Примеры
• Поддержка реализации объектов
  • Выделение объектов в куче
  • Общие структуры объектов
  • Объекты типов
  • Структуры числовых объектов
  • Структуры объектов отображений
  • Структуры объектов последовательностей
  • Структуры объектов буфера
  • Структуры асинхронных объектов
  • Типовые typedef слотов
  • Примеры
  • Поддержка циклического сбора мусора

• Версионирование API и ABI