Расширение и встраивание интерпретатора Python¶Extending and Embedding the Python Interpreter

В этом документе описывается, как писать модули на C или C++ для расширения интерпретатора Python новыми модулями. Такие модули могут определять новые функции, а также новые типы объектов и их методы. Документ также описывает, как встраивать интерпретатор Python в другое приложение для использования в качестве языка расширения. Наконец, показано, как компилировать и компоновать модули расширения, чтобы их можно было динамически загружать (во время выполнения) в интерпретатор, если базовая операционная система поддерживает эту возможность.

В этом документе предполагается базовое знание Python. Для неформального введения в язык, см. Руководство по Python. Справочник по языку Python дает более формальное определение языка. Стандартная библиотека Python документирует существующие типы объектов, функции и модули (как встроенные, так и написанные на Python), которые обеспечивают широкий спектр применения языка.

За подробным описанием всего Python/C API см. отдельное Справочное руководство по Python/C API.

• 1. Расширение Python с помощью C или C++Extending Python with C or C++
  • 1.1. Простой примерA Simple Example
  • 1.2. Интермеццо: ошибки и исключенияIntermezzo: Errors and Exceptions
  • 1.3. Возвращение к примеруBack to the Example
  • 1.4. Таблица методов модуля и функция инициализацииThe Module’s Method Table and Initialization Function
  • 1.5. Компиляция и компоновкаCompilation and Linkage
  • 1.6. Вызов функций Python из CCalling Python Functions from C
  • 1.7. Извлечение параметров в функциях расширенияExtracting Parameters in Extension Functions
  • 1.8. Именованные параметры для функций расширенияKeyword Parameters for Extension Functions
  • 1.9. Построение произвольных значенийBuilding Arbitrary Values
  • 1.10. Счетчики ссылокReference Counts
  • 1.11. Написание расширений на C++Writing Extensions in C++
  • 1.12. Предоставление C API для модуля расширенияProviding a C API for an Extension Module
• 2. Определение новых типовDefining New Types
  • 2.1. ОсновыThe Basics
  • 2.2. Методы типовType Methods
• 3. Сборка расширений на C и C++ с помощью distutilsBuilding C and C++ Extensions with distutils
  • 3.1. Распространение модулей расширенияDistributing your extension modules
• 4. Сборка расширений C и C++ в WindowsBuilding C and C++ Extensions on Windows
  • 4.1. Подход «Кулинарная книга»A Cookbook Approach
  • 4.2. Различия между Unix и WindowsDifferences Between Unix and Windows
  • 4.3. Использование DLL на практикеUsing DLLs in Practice
• 5. Встраивание Python в другое приложениеEmbedding Python in Another Application
  • 5.1. Встраивание на очень высоком уровнеVery High Level Embedding
  • 5.2. За пределами встраивания на очень высоком уровне: обзорBeyond Very High Level Embedding: An overview
  • 5.3. Чистое встраиваниеPure Embedding
  • 5.4. Расширение встроенного PythonExtending Embedded Python
  • 5.5. Встраивание Python в C++Embedding Python in C++
  • 5.6. Требования к компоновкеLinking Requirements