dnspython

INTRODUCTION

dnspython est une boîte à outils DNS pour Python. Il prend en charge presque tous les types d'enregistrements. Il peut être utilisé pour des requêtes, des transferts de zone et des mises à jour dynamiques. Il prend en charge les messages authentifiés TSIG et EDNS0.

dnspython fournit un accès à la fois de haut et de bas niveau au DNS. Les classes de haut niveau effectuent des requêtes pour des données d'un nom, d'un type et d'une classe donnés, et renvoient un ensemble de réponses. Les classes de bas niveau permettent la manipulation directe des zones, des messages, des noms et des enregistrements DNS.

Le nom du module pour dnspython est dns. Pour voir quelques-unes des façons dont dnspython peut être utilisé, consultez le répertoire examples/.

dnspython est un utilitaire pour travailler avec le DNS, /etc/hosts n'est donc pas utilisé. Pour de simples recherches DNS directes, il est préférable d'utiliser socket.getaddrinfo() ou socket.gethostbyname().

dnspython est né chez Nominum où il a été développé pour faciliter les tests de logiciels DNS.

À PROPOS DE CETTE VERSION

Ceci est la version de développement de dnspython 2.9.0. Veuillez lire What's New pour des informations sur les changements dans cette version.

INSTALLATION

• De nombreuses distributions proposent dnspython déjà empaqueté pour vous, vous devriez donc vérifier là en premier.
• Pour utiliser un wheel téléchargé depuis PyPi, exécutez :

    pip install dnspython

• Pour installer depuis le code source, placez-vous à la racine du code source et exécutez :

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

• Pour installer la dernière version depuis la branche main, exécutez pip install git+https://github.com/rthalley/dnspython.git

L'installation par défaut de dnspython ne dépend d'aucun module autre que ceux de la bibliothèque standard Python. Pour utiliser certaines fonctionnalités, des modules supplémentaires doivent être installés. Pour plus de commodité, des options pip sont définies pour les prérequis.

Si vous souhaitez utiliser DNS-over-HTTPS, exécutez pip install dnspython[doh].

Si vous souhaitez utiliser la fonctionnalité DNSSEC, exécutez pip install dnspython[dnssec].

Si vous souhaitez utiliser la fonctionnalité des noms de domaine internationalisés (IDNA), vous devez exécuter pip install dnspython[idna]

Si vous souhaitez utiliser le package d'E/S asynchrones Trio, exécutez pip install dnspython[trio].

Si vous souhaitez utiliser WMI sous Windows pour déterminer les paramètres DNS actifs au lieu de la méthode par défaut d'analyse du registre, exécutez pip install dnspython[wmi].

Si vous souhaitez essayer le code expérimental DNS-over-QUIC, exécutez pip install dnspython[doq].

Notez que vous pouvez installer n'importe quelle combinaison de ce qui précède, par exemple : pip install dnspython[doh,dnssec,idna]

Remarques

La prise en charge de Python 2.x a pris fin avec la version 1.16.0. dnspython prend en charge Python 3.10 et versions ultérieures. La prise en charge future est alignée sur la durée de vie des versions de Python 3.

La documentation a été déplacée vers dnspython.readthedocs.io.