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

---

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

| Версия: | 3.0 |
| --- | --- |
| Дата: | 14 февраля 2009 |

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

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

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

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

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

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

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

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

  - [Встраивание очень высокого уровня](https://python-all.ru/3.0/extending/embedding.html#very-high-level-embedding)
  - [За пределами встраивания очень высокого уровня: обзор](https://python-all.ru/3.0/extending/embedding.html#beyond-very-high-level-embedding-an-overview)
  - [Чистое встраивание](https://python-all.ru/3.0/extending/embedding.html#id1)
  - [Расширение встроенного Python](https://python-all.ru/3.0/extending/embedding.html#extending-embedded-python)
  - [Встраивание Python в C++](https://python-all.ru/3.0/extending/embedding.html#embedding-python-in-c)
  - [Требования к компоновке](https://python-all.ru/3.0/extending/embedding.html#linking-requirements)