Índice de APIs de baixo nível¶
Esta página lista todas as APIs de baixo nível do asyncio.
Obtendo o laço de eventos¶
A função preferida para obter o laço de eventos em execução. |
|
Obtém uma instância do laço de eventos (em execução ou atual por meio da política atual). |
|
Define o laço de eventos como atual através da política atual. |
|
Cria um novo laço de eventos. |
Exemplos
Métodos do laço de eventos¶
Veja também a seção principal da documentação sobre os Métodos do laço de eventos.
Ciclo de vida
Executa um Future/Task/aguardável até que esteja completo. |
|
Executa o laço de eventos para sempre. |
|
Para o laço de eventos. |
|
Fecha o laço de eventos. |
|
Retorna |
|
Retorna |
|
Fecha geradores assíncronos. |
Depuração
Habilita ou desabilita o modo de debug. |
|
Obtém o modo de debug atual. |
Agendando funções de retorno (callbacks)
Invoca uma função de retorno brevemente. |
|
Uma variante segura para thread de |
|
Invoca uma função de retorno após o tempo especificado. |
|
Invoca uma função de retorno no instante especificado. |
Thread/Interpreter/Process Pool
|
Executa uma função vinculada à CPU ou outra que seja bloqueante em um executor |
Define o executor padrão para |
Tasks e Futures
Cria um objeto |
|
Agenda corrotina como uma |
|
Define uma factory usada por |
|
Obtém o factory |
DNS
|
Versão assíncrona de |
|
Versão assíncrona de |
Rede e IPC
|
Abre uma conexão TCP. |
|
Cria um servidor TCP. |
Abre uma conexão soquete Unix. |
|
Cria um servidor soquete Unix. |
|
Envolve um |
|
Abre uma conexão por datagrama (UDP). |
|
|
Envia um arquivo por meio de um transporte. |
|
Atualiza uma conexão existente para TLS. |
|
Envolve a leitura final de um encadeamento em um par |
Envolve a escrita final de um encadeamento em um par |
Soquetes
|
Recebe dados do |
|
Recebe dados do |
|
Recebe um datagrama do |
Recebe um datagrama do |
|
|
Envia dados para o |
|
Envia um datagrama por meio de |
|
Conecta ao |
|
Aceita uma conexão do |
|
Envia um arquivo usando o |
Começa a observar um descritor de arquivo, aguardando por disponibilidade de leitura. |
|
Interrompe o monitoramento de um descritor de arquivo, que aguarda disponibilidade de leitura. |
|
Começa a observar um descritor de arquivo, aguardando por disponibilidade para escrita. |
|
Interrompe o monitoramento de um descritor de arquivo, que aguarda disponibilidade para escrita. |
Sinais Unix
Adiciona um tratador para um |
|
Remove um tratador para um |
Subprocessos
Inicia um subprocesso. |
|
Inicia um subprocesso a partir de um comando shell. |
Tratamento de erros
Chama o tratamento de exceção. |
|
Define um novo tratador de exceção. |
|
Obtém o tratador de exceção atual. |
|
A implementação padrão do tratador de exceção. |
Exemplos
Usando
loop.create_connection()
para implementar um cliente-eco.Usando
loop.create_connection()
para conectar a um soquete.Usando add_reader() para monitorar um descritor de arquivo para eventos de leitura.
Transportes¶
Todos os transportes implementam os seguintes métodos:
Fecha o transporte. |
|
Retorna |
|
Solicita informação a respeito do transporte. |
|
Define um novo protocolo. |
|
Retorna o protocolo atual. |
Transportes que podem receber dados (TCP e conexões Unix, encadeamentos, etc). Retornado a partir de métodos como loop.create_connection()
, loop.create_unix_connection()
, loop.connect_read_pipe()
, etc:
Realiza leitura de Transportes
Retorna |
|
Pausa o recebimento. |
|
Continua o recebimento. |
Transportes que podem enviar dados (TCP e conexões Unix, encadeamentos, etc). Retornado a partir de métodos como loop.create_connection()
, loop.create_unix_connection()
, loop.connect_write_pipe()
, etc:
Realiza escrita de Transportes
Escreve dados para o transporte. |
|
Escreve buffers para o transporte. |
|
Retorna |
|
Fecha e envia EOF após descarregar dados que estavam no buffer. |
|
Fecha o transporte imediatamente. |
|
Retorna o tamanho atual do buffer de saída. |
|
Retorna marcas d’agua alta e baixa para controle do fluxo de escrita. |
|
Define novas marcas d’agua alta e baixa para controle do fluxo de escrita. |
Transporte retornado por loop.create_datagram_endpoint()
:
Transportes de datagrama
Envia dados para o par remoto. |
|
Fecha o transporte imediatamente. |
Abstração de transporte de baixo nível sobre subprocessos. Retornado por loop.subprocess_exec()
e loop.subprocess_shell()
:
Transportes de Subprocesso
Retorna o process id do subprocesso. |
|
Retorna o transporte para o encadeamento de comunicação requisitada (stdin, stdout, ou stderr). |
|
Retorna o código de retorno do subprocesso. |
|
Mata o subprocesso. |
|
Envia um sinal para o subprocesso. |
|
Interrompe o subprocesso. |
|
Mata o subprocesso e fecha todos os encadeamentos. |
Protocolos¶
Classes de protocolos podem implementar os seguintes métodos de função de retorno:
|
Chamado quando uma conexão é estabelecida. |
|
Chamado quanto a conexão é perdida ou fechada. |
|
Chamado quando o buffer de transporte ultrapassa a marca de nível alto d’agua. |
|
Chamado quando o buffer de transporte drena abaixo da marca de nível baixo d’agua. |
Protocolos de Streaming (TCP, Soquetes Unix, Encadeamentos)
|
Chamado quando algum dado é recebido. |
|
Chamado quando um EOF é recebido. |
Protocolos de Streaming Bufferizados
|
Chamada para alocar um novo buffer para recebimento. |
|
Chamado quando o buffer foi atualizado com os dados recebidos. |
|
Chamado quando um EOF é recebido. |
Protocolos de Datagramas
|
Chamado quando um datagrama é recebido. |
|
Chamado quando uma operação de envio ou recebimento anterior levanta um |
Protocolos de Subprocesso
|
Chamado quando o processo filho escreve dados no seu encadeamento stdout ou stderr. |
|
Chamado quando um dos encadeamentos comunicando com o processo filho é fechado. |
|
Chamado quando o processo filho sai. Isso pode ser chamado antes dos métodos |
Políticas de laço de eventos¶
Política é um mecanismo de baixo nível para alterar o comportamento de funções, similar a asyncio.get_event_loop()
. Veja também a seção principal de políticas para mais detalhes.
Acessando Políticas
Retorna a política de todo o processo atual. |
|
Define uma nova política para todo o processo. |
|
Classe base para objetos de política. |