Extending and Embedding the Python Interpreter

Previous: Front Matter Up: Extending and Embedding the Next: 1. Extending Python with

---

Contents

• Front Matter
• 1. Extending Python with C or C++
  • 1.1 A Simple Example
  • 1.2 Intermezzo: Errors and Exceptions
  • 1.3 Back to the Example
  • 1.4 The Module's Method Table and Initialization Function
  • 1.5 Compilation and Linkage
  • 1.6 Calling Python Functions from C
  • 1.7 Extracting Parameters in Extension Functions
  • 1.8 Keyword Parameters for Extension Functions
  • 1.9 Building Arbitrary Values
  • 1.10 Reference Counts
    • 1.10.1 Reference Counting in Python
    • 1.10.2 Ownership Rules
    • 1.10.3 Thin Ice
    • 1.10.4 NULL Pointers
  • 1.11 Writing Extensions in C++
  • 1.12 Providing a C API for an Extension Module
• 2. Defining New Types
  • 2.1 The Basics
  • 2.2 Type Methods
    • 2.2.1 Finalization and De-allocation
    • 2.2.2 Object Representation
    • 2.2.3 Attribute Management Functions
    • 2.2.4 Object Comparison
    • 2.2.5 Abstract Protocol Support
    • 2.2.6 More Suggestions
• 3. Building C and C++ Extensions on Unix
  • 3.1 Building Custom Interpreters
  • 3.2 Module Definition Options
  • 3.3 Example
  • 3.4 Distributing your extension modules
• 4. Building C and C++ Extensions on Windows
  • 4.1 A Cookbook Approach
  • 4.2 Differences Between Unix and Windows
  • 4.3 Using DLLs in Practice
• 5. Embedding Python in Another Application
  • 5.1 Very High Level Embedding
  • 5.2 Beyond Very High Level Embedding: An overview
  • 5.3 Pure Embedding
  • 5.4 Extending Embedded Python
  • 5.5 Embedding Python in C++
  • 5.6 Linking Requirements
• A. Reporting Bugs
• B. History and License
  • B.1 History of the software
  • B.2 Terms and conditions for accessing or otherwise using Python
• About this document ...

---

Extending and Embedding the Python Interpreter

Previous: Front Matter Up: Extending and Embedding the Next: 1. Extending Python with

---

Release 2.2, documentation updated on December 21, 2001.