dnspython

INTRODUÇÃO

dnspython é um kit de ferramentas DNS para Python. Ele suporta quase todos os tipos de registros. Pode ser usado para consultas, transferências de zona e atualizações dinâmicas. Suporta mensagens autenticadas com TSIG e EDNS0.

dnspython fornece acesso de alto e baixo nível ao DNS. As classes de alto nível realizam consultas por dados de um determinado nome, tipo e classe, e retornam um conjunto de respostas. As classes de baixo nível permitem a manipulação direta de zonas, mensagens, nomes e registros DNS.

O nome do módulo para dnspython é dns. Para ver algumas das formas como dnspython pode ser usado, consulte o diretório examples/.

dnspython é um utilitário para trabalhar com DNS, portanto /etc/hosts não é utilizado. Para consultas DNS diretas simples, é melhor usar socket.getaddrinfo() ou socket.gethostbyname().

dnspython teve origem na Nominum, onde foi desenvolvido para facilitar os testes de software DNS.

SOBRE ESTA VERSÃO

Esta é a versão de desenvolvimento do dnspython 2.9.0. Por favor, leia What's New para informações sobre as mudanças nesta versão.

INSTALAÇÃO

• Muitas distribuições já possuem o dnspython empacotado para você, então você deve verificar lá primeiro.
• Para usar um wheel baixado do PyPi, execute:

    pip install dnspython

• Para instalar a partir do código-fonte, vá até o nível superior do código-fonte e execute:

    pip install --upgrade pip build
    python -m build
    pip install dist/*.whl

• Para instalar a versão mais recente do branch main, execute pip install git+https://github.com/rthalley/dnspython.git

A instalação padrão do dnspython não depende de nenhum módulo além daqueles da biblioteca padrão do Python. Para usar alguns recursos, módulos adicionais devem ser instalados. Por conveniência, opções do pip são definidas para os requisitos.

Se você quiser usar DNS-over-HTTPS, execute pip install dnspython[doh].

Se você quiser usar a funcionalidade DNSSEC, execute pip install dnspython[dnssec].

Se você quiser usar a funcionalidade de nomes de domínio internacionalizados (IDNA), você deve executar pip install dnspython[idna]

Se você quiser usar o pacote de I/O assíncrono Trio, execute pip install dnspython[trio].

Se você quiser usar WMI no Windows para determinar as configurações ativas de DNS em vez do método padrão de varredura do registro, execute pip install dnspython[wmi].

Se você quiser experimentar o código experimental de DNS-over-QUIC, execute pip install dnspython[doq].

Observe que você pode instalar qualquer combinação dos itens acima, por exemplo: pip install dnspython[doh,dnssec,idna]

Avisos

O suporte ao Python 2.x terminou com o lançamento da versão 1.16.0. dnspython suporta Python 3.10 e posteriores. O suporte futuro está alinhado com o tempo de vida das versões do Python 3.

A documentação foi movida para dnspython.readthedocs.io.