> **Источник:** https://python-all.ru/3.4/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/3.4/tutorial/index.html#tutorial-index). [*Справочник по языку Python*](https://python-all.ru/3.4/reference/index.html#reference-index) дает более формальное определение языка. [*Стандартная библиотека Python*](https://python-all.ru/3.4/library/index.html#library-index) документирует существующие типы объектов, функции и модули (как встроенные, так и написанные на Python), которые обеспечивают широкий спектр применения языка. За подробным описанием всего Python/C API см. отдельное [*Справочное руководство по Python/C API*](https://python-all.ru/3.4/c-api/index.html#c-api-index). ## Рекомендуемые сторонние инструменты Руководство охватывает только основные инструменты для создания расширений, поставляемые в составе этой версии CPython. Сторонние инструменты, такие как Cython, `cffi`, SWIG и Numba, предлагают как более простые, так и более сложные подходы к созданию C и C++ расширений для Python. > **См. также** > > **[Руководство пользователя по упаковке Python: Бинарные расширения](https://python-all.ru/3.4/extending/index.html)** > > Руководство пользователя по упаковке Python (Python Packaging User Guide) не только охватывает несколько доступных инструментов, упрощающих создание двоичных расширений, но и обсуждает различные причины, по которым создание модуля расширения может быть желательным в первую очередь. ## Создание расширений без сторонних инструментов Этот раздел руководства охватывает создание C- и C++-расширений без использования сторонних инструментов. Он предназначен в первую очередь для создателей таких инструментов, а не как рекомендуемый способ создания собственных C-расширений. - [1. Расширение Python с помощью C или C++](https://python-all.ru/3.4/extending/extending.html) - [1.1. Простой пример](https://python-all.ru/3.4/extending/extending.html#a-simple-example) - [1.2. Интермеццо: ошибки и исключения](https://python-all.ru/3.4/extending/extending.html#intermezzo-errors-and-exceptions) - [1.3. Возвращение к примеру](https://python-all.ru/3.4/extending/extending.html#back-to-the-example) - [1.4. Таблица методов модуля и функция инициализации](https://python-all.ru/3.4/extending/extending.html#the-module-s-method-table-and-initialization-function) - [1.5. Компиляция и компоновка](https://python-all.ru/3.4/extending/extending.html#compilation-and-linkage) - [1.6. Вызов функций Python из C](https://python-all.ru/3.4/extending/extending.html#calling-python-functions-from-c) - [1.7. Извлечение параметров в функциях расширения](https://python-all.ru/3.4/extending/extending.html#extracting-parameters-in-extension-functions) - [1.8. Именованные параметры для функций расширения](https://python-all.ru/3.4/extending/extending.html#keyword-parameters-for-extension-functions) - [1.9. Построение произвольных значений](https://python-all.ru/3.4/extending/extending.html#building-arbitrary-values) - [1.10. Счетчики ссылок](https://python-all.ru/3.4/extending/extending.html#reference-counts) - [1.11. Написание расширений на C++](https://python-all.ru/3.4/extending/extending.html#writing-extensions-in-c) - [1.12. Предоставление C API для модуля расширения](https://python-all.ru/3.4/extending/extending.html#providing-a-c-api-for-an-extension-module) - [2. Определение новых типов](https://python-all.ru/3.4/extending/newtypes.html) - [2.1. Основы](https://python-all.ru/3.4/extending/newtypes.html#the-basics) - [2.2. Методы типов](https://python-all.ru/3.4/extending/newtypes.html#type-methods) - [3. Сборка расширений на C и C++ с помощью distutils](https://python-all.ru/3.4/extending/building.html) - [3.1. Распространение модулей расширения](https://python-all.ru/3.4/extending/building.html#distributing-your-extension-modules) - [4. Сборка расширений C и C++ в Windows](https://python-all.ru/3.4/extending/windows.html) - [4.1. Подход «Кулинарная книга»](https://python-all.ru/3.4/extending/windows.html#a-cookbook-approach) - [4.2. Различия между Unix и Windows](https://python-all.ru/3.4/extending/windows.html#differences-between-unix-and-windows) - [4.3. Использование DLL на практике](https://python-all.ru/3.4/extending/windows.html#using-dlls-in-practice) ## Встраивание среды выполнения CPython в более крупное приложение Иногда вместо создания расширения, работающего внутри интерпретатора Python как основного приложения, желательно встроить среду выполнения CPython в более крупное приложение. В этом разделе рассматриваются некоторые детали, необходимые для успешного выполнения этой задачи. - [1. Встраивание Python в другое приложение](https://python-all.ru/3.4/extending/embedding.html) - [1.1. Встраивание на очень высоком уровне](https://python-all.ru/3.4/extending/embedding.html#very-high-level-embedding) - [1.2. За пределами встраивания на очень высоком уровне: обзор](https://python-all.ru/3.4/extending/embedding.html#beyond-very-high-level-embedding-an-overview) - [1.3. Чистое встраивание](https://python-all.ru/3.4/extending/embedding.html#pure-embedding) - [1.4. Расширение встроенного Python](https://python-all.ru/3.4/extending/embedding.html#extending-embedded-python) - [1.5. Встраивание Python в C++](https://python-all.ru/3.4/extending/embedding.html#embedding-python-in-c) - [1.6. Компиляция и компоновка в Unix-подобных системах](https://python-all.ru/3.4/extending/embedding.html#compiling-and-linking-under-unix-like-systems)