> **Источник:** https://python-all.ru/2.7/extending/index.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# Расширение и встраивание интерпретатора Python

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

В этом документе предполагается базовое знание Python. Для неформального введения в язык, см. [Руководство по Python](https://python-all.ru/2.7/tutorial/index.html#tutorial-index). [Справочник по языку Python](https://python-all.ru/2.7/reference/index.html#reference-index) дает более формальное определение языка. [Стандартная библиотека Python](https://python-all.ru/2.7/library/index.html#library-index) документирует существующие типы объектов, функции и модули (как встроенные, так и написанные на Python), которые обеспечивают широкий спектр применения языка.

За подробным описанием всего Python/C API см. отдельное [Справочное руководство по Python/C API](https://python-all.ru/2.7/c-api/index.html#c-api-index).

> **Примечание**
>
> Это руководство охватывает только базовые инструменты для создания расширений, предоставляемые в этой версии CPython. Сторонние инструменты могут предлагать более простые альтернативы. Обратитесь к разделу [двоичных расширений](https://python-all.ru/2.7/extending/index.html) в Руководстве пользователя по упаковке Python для получения дополнительной информации.

- [1. Расширение Python с помощью C или C++](https://python-all.ru/2.7/extending/extending.html)

  - [1.1. Простой пример](https://python-all.ru/2.7/extending/extending.html#a-simple-example)
  - [1.2. Интермеццо: ошибки и исключения](https://python-all.ru/2.7/extending/extending.html#intermezzo-errors-and-exceptions)
  - [1.3. Возвращение к примеру](https://python-all.ru/2.7/extending/extending.html#back-to-the-example)
  - [1.4. Таблица методов модуля и функция инициализации](https://python-all.ru/2.7/extending/extending.html#the-module-s-method-table-and-initialization-function)
  - [1.5. Компиляция и компоновка](https://python-all.ru/2.7/extending/extending.html#compilation-and-linkage)
  - [1.6. Вызов функций Python из C](https://python-all.ru/2.7/extending/extending.html#calling-python-functions-from-c)
  - [1.7. Извлечение параметров в функциях расширения](https://python-all.ru/2.7/extending/extending.html#extracting-parameters-in-extension-functions)
  - [1.8. Именованные параметры для функций расширения](https://python-all.ru/2.7/extending/extending.html#keyword-parameters-for-extension-functions)
  - [1.9. Построение произвольных значений](https://python-all.ru/2.7/extending/extending.html#building-arbitrary-values)
  - [1.10. Счетчики ссылок](https://python-all.ru/2.7/extending/extending.html#reference-counts)
  - [1.11. Написание расширений на C++](https://python-all.ru/2.7/extending/extending.html#writing-extensions-in-c)
  - [1.12. Предоставление C API для модуля расширения](https://python-all.ru/2.7/extending/extending.html#providing-a-c-api-for-an-extension-module)
- [2. Определение новых типов](https://python-all.ru/2.7/extending/newtypes.html)

  - [2.1. Основы](https://python-all.ru/2.7/extending/newtypes.html#the-basics)
  - [2.2. Методы типов](https://python-all.ru/2.7/extending/newtypes.html#type-methods)
- [3. Сборка расширений на C и C++ с помощью distutils](https://python-all.ru/2.7/extending/building.html)

  - [3.1. Распространение модулей расширения](https://python-all.ru/2.7/extending/building.html#distributing-your-extension-modules)
- [4. Сборка расширений C и C++ в Windows](https://python-all.ru/2.7/extending/windows.html)

  - [4.1. Подход «Кулинарная книга»](https://python-all.ru/2.7/extending/windows.html#a-cookbook-approach)
  - [4.2. Различия между Unix и Windows](https://python-all.ru/2.7/extending/windows.html#differences-between-unix-and-windows)
  - [4.3. Использование DLL на практике](https://python-all.ru/2.7/extending/windows.html#using-dlls-in-practice)
- [5. Встраивание Python в другое приложение](https://python-all.ru/2.7/extending/embedding.html)

  - [5.1. Встраивание на очень высоком уровне](https://python-all.ru/2.7/extending/embedding.html#very-high-level-embedding)
  - [5.2. За пределами встраивания на очень высоком уровне: обзор](https://python-all.ru/2.7/extending/embedding.html#beyond-very-high-level-embedding-an-overview)
  - [5.3. Чистое встраивание](https://python-all.ru/2.7/extending/embedding.html#pure-embedding)
  - [5.4. Расширение встроенного Python](https://python-all.ru/2.7/extending/embedding.html#extending-embedded-python)
  - [5.5. Встраивание Python в C++](https://python-all.ru/2.7/extending/embedding.html#embedding-python-in-c)
  - [5.6. Компиляция и компоновка в системах семейства Unix](https://python-all.ru/2.7/extending/embedding.html#compiling-and-linking-under-unix-like-systems)