Utöka och bädda in Pythons tolkprogram

Detta dokument beskriver hur man skriver moduler i C eller C++ för att utöka Python-tolken med nya moduler. Dessa moduler kan inte bara definiera nya funktioner utan även nya objekttyper och deras metoder. Dokumentet beskriver också hur man bäddar in Python-tolken i en annan applikation, för användning som ett tilläggsspråk. Slutligen visas hur man kompilerar och länkar tilläggsmoduler så att de kan laddas dynamiskt (vid körning) i tolken, om det underliggande operativsystemet stöder denna funktion.

Detta dokument förutsätter grundläggande kunskaper om Python. För en informell introduktion till språket, se Python-guiden. Referens till Python-språket ger en mer formell definition av språket. Pythons standardbibliotek dokumenterar de befintliga objekttyper, funktioner och moduler (både inbyggda och skrivna i Python) som ger språket dess breda användningsområde.

För en detaljerad beskrivning av hela Python/C API, se den separata Python/C API Referensmanual.

Rekommenderade verktyg från tredje part

Denna guide täcker endast de grundläggande verktygen för att skapa tillägg som tillhandahålls som en del av denna version av CPython. Vissa verktyg från tredje part erbjuder både enklare och mer sofistikerade metoder för att skapa C- och C++-tillägg för Python.

Skapa tillägg utan verktyg från tredje part

Det här avsnittet i handboken handlar om att skapa C- och C++-tillägg utan hjälp av verktyg från tredje part. Det är främst avsett för skapare av dessa verktyg, snarare än att vara ett rekommenderat sätt att skapa dina egna C-tillägg.

Se även

PEP 489 – Initialisering av flerfasig tilläggsmodul

• 1. Utöka Python med C eller C++
  • 1.1. Ett enkelt exempel
  • 1.2. Intermezzo: Fel och undantag
  • 1.3. Tillbaka till exemplet
  • 1.4. Modulens metodtabell och initialiseringsfunktion
  • 1.5. Sammanställning och länkning
  • 1.6. Anropa Python-funktioner från C
  • 1.7. Extrahera parametrar i tilläggsfunktioner
  • 1.8. Nyckelordsparametrar för tilläggsfunktioner
  • 1.9. Att bygga godtyckliga värden
  • 1.10. Referensräkningar
  • 1.11. Skriva tillägg i C++
  • 1.12. Tillhandahålla ett C API för en tilläggsmodul
• 2. Definiera typer av tillägg: Handledning
  • 2.1. Grunderna
  • 2.2. Lägga till data och metoder i Basic-exemplet
  • 2.3. Tillhandahåller finare kontroll över dataattribut
  • 2.4. Stöd för cyklisk skräpinsamling
  • 2.5. Underklassificering av andra typer
• 3. Definiera utökningstyper: Blandade ämnen
  • 3.1. Slutförande och avyttring
  • 3.2. Presentation av objekt
  • 3.3. Hantering av attribut
  • 3.4. Jämförelse av objekt
  • 3.5. Stöd för abstrakta protokoll
  • 3.6. Svagt referensstöd
  • 3.7. Fler förslag
• 4. Bygga C- och C++-tillägg
  • 4.1. Bygga C- och C++-tillägg med setuptools
• 5. Bygga C- och C++-tillägg i Windows
  • 5.1. Ett tillvägagångssätt med kokbok
  • 5.2. Skillnader mellan Unix och Windows
  • 5.3. Användning av DLL:er i praktiken

Inbäddning av CPython-körtiden i en större applikation

Ibland är det önskvärt att istället för att skapa ett tillägg som körs i Python-tolken som huvudapplikationen, istället bädda in CPython-körtiden i en större applikation. I detta avsnitt beskrivs några av de detaljer som krävs för att göra det på ett framgångsrikt sätt.

• 1. Bädda in Python i en annan applikation
  • 1.1. Inbäddning på mycket hög nivå
  • 1.2. Bortom inbäddning på mycket hög nivå: En översikt
  • 1.3. Ren inbäddning
  • 1.4. Utökning av inbäddad Python
  • 1.5. Inbäddning av Python i C++
  • 1.6. Kompilering och länkning under Unix-liknande system