擴充套件和嵌入 Python 直譯器

本文件描述瞭如何使用 C 或 C++ 編寫模組來使用新模組擴充套件 Python 直譯器。 這些模組不僅可以定義新函式，還可以定義新的物件型別及其方法。 本文件還描述瞭如何將 Python 直譯器嵌入到另一個應用程式中，用作擴充套件語言。 最後，它展示瞭如何編譯和連結擴充套件模組，以便如果底層作業系統支援此功能，它們可以在執行時動態載入到直譯器中。

本文件假設您對 Python 有基本瞭解。 有關該語言的非正式介紹，請參閱 Python 教程。Python 語言參考 給出了該語言的更正式的定義。Python 標準庫 記錄了現有的物件型別、函式和模組（內建的和用 Python 編寫的），這些使該語言具有廣泛的應用範圍。

有關整個 Python/C API 的詳細描述，請參閱單獨的 Python/C API 參考手冊。

推薦的第三方工具

本指南僅涵蓋作為此版本 CPython 一部分提供的用於建立擴充套件的基本工具。 諸如 Cython、 cffi、SWIG 和 Numba 等第三方工具提供了更簡單和更復雜的方法來為 Python 建立 C 和 C++ 擴充套件。

另請參閱

Python 打包使用者指南：二進位制擴充套件

Python 打包使用者指南不僅涵蓋了簡化二進位制擴充套件建立的幾種可用工具，還討論了首先建立擴充套件模組的各種原因。

在不使用第三方工具的情況下建立擴充套件

本指南的這一部分介紹了在沒有第三方工具幫助的情況下建立 C 和 C++ 擴充套件。 它主要用於這些工具的建立者，而不是建立您自己的 C 擴充套件的推薦方法。

• 1. 使用 C 或 C++ 擴充套件 Python
  • 1.1. 一個簡單的例子
  • 1.2. 插曲：錯誤和異常
  • 1.3. 回到示例
  • 1.4. 模組的方法表和初始化函式
  • 1.5. 編譯和連結
  • 1.6. 從 C 呼叫 Python 函式
  • 1.7. 在擴充套件函式中提取引數
  • 1.8. 擴充套件函式的關鍵字引數
  • 1.9. 構建任意值
  • 1.10. 引用計數
  • 1.11. 用 C++ 編寫擴充套件
  • 1.12. 為擴充套件模組提供 C API
• 2. 定義擴充套件型別：教程
  • 2.1. 基本概念
  • 2.2. 向基本示例新增資料和方法
  • 2.3. 提供對資料屬性的更精細的控制
  • 2.4. 支援迴圈垃圾回收
  • 2.5. 子類化其他型別
• 3. 定義擴充套件型別：雜項主題
  • 3.1. 終結和取消分配
  • 3.2. 物件呈現
  • 3.3. 屬性管理
  • 3.4. 物件比較
  • 3.5. 抽象協議支援
  • 3.6. 弱引用支援
  • 3.7. 更多建議
• 4. 構建 C 和 C++ 擴充套件
  • 4.1. 使用 setuptools 構建 C 和 C++ 擴充套件
• 5. 在 Windows 上構建 C 和 C++ 擴充套件
  • 5.1. 食譜方法
  • 5.2. Unix 和 Windows 之間的差異
  • 5.3. 在實踐中使用 DLL

將 CPython 執行時嵌入到更大的應用程式中

有時，與其建立在 Python 直譯器內部作為主應用程式執行的擴充套件，不如將 CPython 執行時嵌入到更大的應用程式中。 本節介紹成功執行此操作所涉及的一些詳細資訊。

• 1. 將 Python 嵌入到另一個應用程式中
  • 1.1. 非常高層次的嵌入
  • 1.2. 超越非常高層次的嵌入：概述
  • 1.3. 純嵌入
  • 1.4. 擴充套件嵌入式 Python
  • 1.5. 在 C++ 中嵌入 Python
  • 1.6. 在類 Unix 系統下編譯和連結