index.md
1> **Источник:** https://python-all.ru/3/extending/index.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Расширение и встраивание интерпретатора Python89В этом документе описывается, как писать модули на C или C++ для расширения Python интерпретатора новыми модулями. Такие модули могут не только определять новые функции но и новые типы объектов и их методы. В документе также описывается, как встроить интерпретатор Python в другое приложение для использования в качестве языка расширения. Наконец, показано, как компилировать и компоновать модули расширения, чтобы их можно было динамически загружать (во время выполнения) в интерпретатор, если базовая операционная система поддерживает эту возможность.1011В этом документе предполагается базовое знание Python. Для неформального введения в язык, см. [Руководство по Python](https://python-all.ru/3/tutorial/index.html#tutorial-index). [Справочник по языку Python](https://python-all.ru/3/reference/index.html#reference-index) дает более формальное определение языка. [Стандартная библиотека Python](https://python-all.ru/3/library/index.html#library-index) документирует существующие типы объектов, функции и модули (как встроенные, так и написанные на Python), которые обеспечивают широкий спектр применения языка.1213Подробное описание всего Python/C API см. в отдельном [справочном руководстве по Python/C API](https://python-all.ru/3/c-api/index.html#c-api-index).1415## Рекомендуемые сторонние инструменты1617Это руководство охватывает только базовые инструменты для создания расширений, предоставляемые в составе этой версии CPython. Некоторые [сторонние инструменты](https://python-all.ru/3/c-api/intro.html#c-api-tools) предлагают как более простые, так и более сложные подходы к созданию расширений C и C++ для Python.1819## Создание расширений без сторонних инструментов2021Этот раздел руководства охватывает создание C- и C++-расширений без использования сторонних инструментов. Он предназначен в первую очередь для создателей таких инструментов, а не как рекомендуемый способ создания собственных C-расширений.2223> **См. также**24>25> [**PEP 489**](https://python-all.ru/3/extending/index.html) – Многофазная инициализация модуля расширения2627- [1. Расширение Python с помощью C или C++](https://python-all.ru/3/extending/extending.html)2829 - [1.1. Простой пример](https://python-all.ru/3/extending/extending.html#a-simple-example)30 - [1.2. Интермеццо: ошибки и исключения](https://python-all.ru/3/extending/extending.html#intermezzo-errors-and-exceptions)31 - [1.3. Возвращение к примеру](https://python-all.ru/3/extending/extending.html#back-to-the-example)32 - [1.4. Таблица методов модуля и функция инициализации](https://python-all.ru/3/extending/extending.html#the-module-s-method-table-and-initialization-function)33 - [1.5. Компиляция и компоновка](https://python-all.ru/3/extending/extending.html#compilation-and-linkage)34 - [1.6. Вызов функций Python из C](https://python-all.ru/3/extending/extending.html#calling-python-functions-from-c)35 - [1.7. Извлечение параметров в функциях расширения](https://python-all.ru/3/extending/extending.html#extracting-parameters-in-extension-functions)36 - [1.8. Именованные параметры для функций расширения](https://python-all.ru/3/extending/extending.html#keyword-parameters-for-extension-functions)37 - [1.9. Построение произвольных значений](https://python-all.ru/3/extending/extending.html#building-arbitrary-values)38 - [1.10. Счетчики ссылок](https://python-all.ru/3/extending/extending.html#reference-counts)39 - [1.11. Написание расширений на C++](https://python-all.ru/3/extending/extending.html#writing-extensions-in-c)40 - [1.12. Предоставление C API для модуля расширения](https://python-all.ru/3/extending/extending.html#providing-a-c-api-for-an-extension-module)41- [2. Определение типов расширения: учебное пособие](https://python-all.ru/3/extending/newtypes_tutorial.html)4243 - [2.1. Основы](https://python-all.ru/3/extending/newtypes_tutorial.html#the-basics)44 - [2.2. Добавление данных и методов в базовый пример](https://python-all.ru/3/extending/newtypes_tutorial.html#adding-data-and-methods-to-the-basic-example)45 - [2.3. Предоставление более точного контроля над атрибутами данных](https://python-all.ru/3/extending/newtypes_tutorial.html#providing-finer-control-over-data-attributes)46 - [2.4. Поддержка циклической сборки мусора](https://python-all.ru/3/extending/newtypes_tutorial.html#supporting-cyclic-garbage-collection)47 - [2.5. Наследование от других типов](https://python-all.ru/3/extending/newtypes_tutorial.html#subclassing-other-types)48- [3. Определение типов расширения: разные темы](https://python-all.ru/3/extending/newtypes.html)4950 - [3.1. Финализация и освобождение памяти](https://python-all.ru/3/extending/newtypes.html#finalization-and-de-allocation)51 - [3.2. Представление объектов](https://python-all.ru/3/extending/newtypes.html#object-presentation)52 - [3.3. Управление атрибутами](https://python-all.ru/3/extending/newtypes.html#attribute-management)53 - [3.4. Сравнение объектов](https://python-all.ru/3/extending/newtypes.html#object-comparison)54 - [3.5. Поддержка абстрактных протоколов](https://python-all.ru/3/extending/newtypes.html#abstract-protocol-support)55 - [3.6. Поддержка слабых ссылок](https://python-all.ru/3/extending/newtypes.html#weak-reference-support)56 - [3.7. Дополнительные предложения](https://python-all.ru/3/extending/newtypes.html#more-suggestions)57- [4. Сборка расширений на C и C++](https://python-all.ru/3/extending/building.html)5859 - [4.1. Сборка расширений на C и C++ с помощью setuptools](https://python-all.ru/3/extending/building.html#building-c-and-c-extensions-with-setuptools)60- [5. Сборка расширений на C и C++ в Windows](https://python-all.ru/3/extending/windows.html)6162 - [5.1. Рецептурный подход](https://python-all.ru/3/extending/windows.html#a-cookbook-approach)63 - [5.2. Различия между Unix и Windows](https://python-all.ru/3/extending/windows.html#differences-between-unix-and-windows)64 - [5.3. Использование DLL на практике](https://python-all.ru/3/extending/windows.html#using-dlls-in-practice)6566## Встраивание среды выполнения CPython в более крупное приложение6768Иногда вместо создания расширения, работающего внутри интерпретатора Python как основного приложения, желательно встроить среду выполнения CPython в более крупное приложение. В этом разделе рассматриваются некоторые детали, необходимые для успешного выполнения этой задачи.6970- [1. Встраивание Python в другое приложение](https://python-all.ru/3/extending/embedding.html)7172 - [1.1. Встраивание на очень высоком уровне](https://python-all.ru/3/extending/embedding.html#very-high-level-embedding)73 - [1.2. За пределами встраивания на очень высоком уровне: обзор](https://python-all.ru/3/extending/embedding.html#beyond-very-high-level-embedding-an-overview)74 - [1.3. Чистое встраивание](https://python-all.ru/3/extending/embedding.html#pure-embedding)75 - [1.4. Расширение встроенного Python](https://python-all.ru/3/extending/embedding.html#extending-embedded-python)76 - [1.5. Встраивание Python в C++](https://python-all.ru/3/extending/embedding.html#embedding-python-in-c)77 - [1.6. Компиляция и компоновка в Unix-подобных системах](https://python-all.ru/3/extending/embedding.html#compiling-and-linking-under-unix-like-systems)78