擴展和嵌入 Python 解釋器

本文檔描述了如何使用 C 或 C++ 編寫模塊以使用新模塊來擴展 Python 解釋器的功能。 這些模塊不僅可以定義新的函數，還可以定義新的對象類型及其方法。 該文檔還描述了如何將 Python 解釋器嵌入到另一個應用程序中，以用作擴展語言。 最后，它展示了如何編譯和鏈接擴展模塊，以便它們可以動態地（在運行時）加載到解釋器中，如果底層操作系統支持此特性的話。

本文檔假設你具備有關 Python 的基本知識。有關該語言的非正式介紹，請參閱 Python 教程 。 Python語言參考 給出了更正式的語言定義。 Python 標準庫 包含現有的對象類型、函數和模塊（內置和用 Python 編寫）的文檔，使語言具有廣泛的應用范圍。

關于整個 Python/C API 的詳細介紹，請參閱獨立的 Python/C API 參考手冊 。

推薦的第三方工具

本指南僅介紹了作為此 CPython 版本的一部分提供的創建擴展的基本工具。 第三方工具，如 、 、 和 提供了更簡單和更復雜的方法來為 Python 創建 C 和 C ++ 擴展。

參見

“ Python Packaging User Guide ”不僅涵蓋了幾個簡化二進制擴展創建的可用工具，還討論了為什么首先創建擴展模塊的各種原因。

不使用第三方工具創建擴展

本指南的這一部分包括在沒有第三方工具幫助的情況下創建 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. Adding data and methods to the Basic example
  • 2.3. Providing finer control over data attributes
  • 2.4. Supporting cyclic garbage collection
  • 2.5. Subclassing other types
• 3. 定義擴展類型：已分類主題
  • 3.1. 終結和內存釋放
  • 3.2. 對象展示
  • 3.3. 屬性管理
  • 3.4. Object Comparison
  • 3.5. Abstract Protocol Support
  • 3.6. Weak Reference Support
  • 3.7. 更多建議
• 4. 構建C/C++擴展
  • 4.1. 使用distutils構建C和C++擴展
  • 4.2. 發布你的擴展模塊
• 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 系統中編譯和鏈接