Manual de referência da API Python/C
************************************

Este manual documenta a API usada por programadores C e C++ que
desejam escrever módulos de extensões ou embutir Python. É um
complemento para Estendendo e incorporando o interpretador Python, que
descreve os princípios gerais da escrita de extensões mas não
documenta as funções da API em detalhes.

* Introdução

  * Compatibilidade com a versão da linguagem

  * Padrões de codificação

  * Arquivos de inclusão

  * Macros úteis

  * Objetos, tipos e contagens de referências

  * Exceções

  * Incorporando Python

  * Compilações de depuração

  * Ferramentas de terceiros recomendadas

* Estabilidade da API C

  * API C Instável

  * Interface Binária de Aplicação Estável

  * Considerações da plataforma

  * Conteúdo da API Limitada

* A camada de nível muito alto

  * Símbolos iniciais disponíveis

  * Stack Effects

* Contagem de referências

* Tratamento de exceções

  * Impressão e limpeza

  * Levantando exceções

  * Emitindo avisos

  * Consultando o indicador de erro

  * Tratamento de sinal

  * Classes de exceção

  * Objeto Exceção

  * Objetos de exceção Unicode

  * Controle de recursão

  * Exception and warning types

  * Tracebacks

* Definindo módulos de extensão

  * Várias instâncias de módulo

  * Função de inicialização

  * Inicialização multifásica

  * Inicialização monofásica legada

* Utilitários

  * Utilitários do sistema operacional

  * Funções de sistema

  * Controle de processos

  * Importando módulos

  * Suporte a *marshalling* de dados

  * Análise de argumentos e construção de valores

  * Conversão e formação de strings

  * Classificação e conversão de caracteres

  * API do PyHash

  * Reflexão

  * Registro de codec e funções de suporte

  * API C PyTime

  * Suporte a Mapas do Perf

* Camada de Objetos Abstratos

  * Protocolo de objeto

  * Protocolo de chamada

  * Protocolo de número

  * Protocolo de sequência

  * Protocolo de mapeamento

  * Protocolo Iterador

  * Protocolo de buffer

* Camada de Objetos Concretos

  * Objetos Fundamentais

  * Objetos Numéricos

  * Objetos Sequência

  * Coleções

  * Objetos Função

  * Outros Objetos

  * API C para módulos de extensão

* Inicialização, finalização e threads

  * Antes da inicialização do Python

  * Variáveis de configuração global

  * Inicializando e encerrando o interpretador

  * Parâmetros de todo o processo

  * Estado de thread e a trava global do interpretador

  * Sub-interpreter support

  * Notificações assíncronas

  * Profiling and Tracing

  * Reference tracing

  * Advanced Debugger Support

  * Thread Local Storage Support

  * Synchronization Primitives

  * Operating System Thread APIs

* Configuração de inicialização do Python

  * API C PyInitConfig

  * Opções de configuração

  * API de configuração Python em tempo de execução

  * API C PyConfig

  * Py_GetArgcArgv()

  * Delaying main module execution

* Gerenciamento de Memória

  * Visão Geral

  * Allocator Domains

  * Raw Memory Interface

  * Interface da Memória

  * Alocadores de objeto

  * Alocadores de memória padrão

  * Alocadores de memória

  * Debug hooks on the Python memory allocators

  * The pymalloc allocator

  * The mimalloc allocator

  * tracemalloc C API

  * Exemplos

* Suporte a implementação de Objetos

  * Alocando objetos na heap

  * Ciclo de vida do objeto

  * Estruturas comuns de objetos

  * Estruturas de objetos tipo

  * Suporte a Coleta Cíclica de Lixo

* API e Versionamento de ABI

  * Constantes de versão de tempo de construção

  * Versão de tempo de execução

  * Macros de empacotamento de bits

* API C de monitoramento

* Gerando eventos de execução

  * Gerenciando o Estado de um Monitoramento
