Estendendo e incorporando o interpretador Python

Neste documento descreveremos o desenvolvimento de módulos com C ou C++ para adicionar recursos ao interpretador Python criando novos módulos. Esses módulos podem não somente definir novas funções, mas também novos tipos de objetos e seu conjunto de métodos. O documento também descreve como incorporar o interpretador Python em outro aplicativo, de forma a utilizá-lo como sendo uma extensão da linguagem. Por fim, estudaremos como podemos compilar e fazer a vinculação dos módulos de extensão para que estes possam ser carregados dinamicamente (em tempo de execução) pelo interpretador, caso o sistema operacional subjacente suportar esse recurso.

This document assumes basic knowledge about C and Python. For an informal introduction to Python, see O tutorial do Python. A Referência da Linguagem Python gives a more formal definition of the language. Referência da bibliotecas embutidas do Python documents the built-in functions and object types, and The Python standard library documents the modules (both built-in and written in Python) that give the language its wide application range.

Para uma descrição detalhada de toda a API Python/C, consulte o Manual de referência da API C/Python separado.

Ferramentas de terceiros recomendadas

Este guia aborda apenas as ferramentas básicas para a criação de extensões fornecidas como parte desta versão do CPython. Algumas ferramentas de terceiros oferecem abordagens mais simples e mais sofisticadas para a criação de extensões em C e C++ para Python.

Criando extensões sem ferramentas de terceiros

Esta seção do guia aborda a criação de extensões C e C++ sem assistência de ferramentas de terceiros. Destina-se principalmente aos criadores dessas ferramentas, em vez de ser uma maneira recomendada de criar suas próprias extensões C.

Ver também

PEP 489 – Inicialização de módulo extensão multifase

• 1. Estendendo Python com C ou C++
  • 1.1. Um Exemplo Simples
  • 1.2. Intermezzo: erros e exceções
  • 1.3. De volta ao exemplo
  • 1.4. A tabela de métodos e a função de inicialização do módulo
  • 1.5. Compilação e vinculação
  • 1.6. Chamando funções Python de C
  • 1.7. Extraindo parâmetros em funções de extensão
  • 1.8. Parâmetros nomeados para funções de extensão
  • 1.9. Construindo valores arbitrários
  • 1.10. Contagens de referências
  • 1.11. Escrevendo extensões em C++
  • 1.12. Fornecendo uma API C para um módulo de extensão
• 2. Definindo Tipos de Extensão: Tutorial
  • 2.1. O básico
  • 2.2. Adicionando dados e métodos ao exemplo básico
  • 2.3. Fornecendo controle mais preciso sobre atributos de dados
  • 2.4. Apoiando a coleta de lixo cíclica
  • 2.5. Criando subclasses de outros tipos
• 3. Defining Extension Types: Assorted Topics
  • 3.1. Finalization and De-allocation
  • 3.2. Object Presentation
  • 3.3. Attribute Management
  • 3.4. Object Comparison
  • 3.5. Abstract Protocol Support
  • 3.6. Weak Reference Support
  • 3.7. More Suggestions
• 4. Construindo extensões C e C++
  • 4.1. Construindo extensões C e C ++ com setuptools
• 5. Construindo Extensões C e C++ no Windows
  • 5.1. Uma abordagem de livro de receitas
  • 5.2. Diferenças entre o Unix e o Windows
  • 5.3. Usando DLLs na prática

Incorporando o tempo de execução do CPython em uma aplicação maior

Às vezes, em vez de criar uma extensão que é executada dentro do interpretador Python como a aplicação principal, é desejável incorporar o tempo de execução do CPython em uma aplicação maior. Esta seção aborda alguns dos detalhes envolvidos para fazer isso com êxito.

• 1. Incorporando o Python numa Outra Aplicação
  • 1.1. Very High Level Embedding
  • 1.2. Beyond Very High Level Embedding: An overview
  • 1.3. Pure Embedding
  • 1.4. Extending Embedded Python
  • 1.5. Embedding Python in C++
  • 1.6. Compiling and Linking under Unix-like systems