Metadata-Version: 2.1 Name: dnspython Version: 2.3.0 Summary: DNS toolkit Home-page: https://www.dnspython.org License: ISC Author: Bob Halley Author-email: halley@dnspython.org Requires-Python: >=3.7,<4.0 Classifier: License :: OSI Approved Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.7 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: 3.11 Provides-Extra: curio Provides-Extra: dnssec Provides-Extra: doh Provides-Extra: doq Provides-Extra: idna Provides-Extra: trio Provides-Extra: wmi Requires-Dist: aioquic (>=0.9.20) ; extra == "doq" Requires-Dist: cryptography (>=2.6,<40.0) ; extra == "dnssec" Requires-Dist: curio (>=1.2,<2.0) ; extra == "curio" Requires-Dist: h2 (>=4.1.0) ; (python_full_version >= "3.6.2") and (extra == "doh") Requires-Dist: httpx (>=0.21.1) ; (python_full_version >= "3.6.2") and (extra == "doh") Requires-Dist: idna (>=2.1,<4.0) ; extra == "idna" Requires-Dist: requests (>=2.23.0,<3.0.0) ; extra == "doh" Requires-Dist: requests-toolbelt (>=0.9.1,<0.11.0) ; extra == "doh" Requires-Dist: sniffio (>=1.1,<2.0) ; extra == "curio" Requires-Dist: trio (>=0.14,<0.23) ; extra == "trio" Requires-Dist: wmi (>=1.5.1,<2.0.0) ; extra == "wmi" Project-URL: Bug Tracker, https://github.com/rthalley/dnspython/issues Project-URL: Documentation, https://dnspython.readthedocs.io/en/stable/ Project-URL: Repository, https://github.com/rthalley/dnspython.git Description-Content-Type: text/markdown # dnspython [![Build Status](https://github.com/rthalley/dnspython/actions/workflows/python-package.yml/badge.svg)](https://github.com/rthalley/dnspython/actions/) [![Documentation Status](https://readthedocs.org/projects/dnspython/badge/?version=latest)](https://dnspython.readthedocs.io/en/latest/?badge=latest) [![PyPI version](https://badge.fury.io/py/dnspython.svg)](https://badge.fury.io/py/dnspython) [![License: ISC](https://img.shields.io/badge/License-ISC-brightgreen.svg)](https://opensource.org/licenses/ISC) [![Coverage](https://codecov.io/github/rthalley/dnspython/coverage.svg?branch=master)](https://codecov.io/github/rthalley/dnspython) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) ## INTRODUCTION dnspython is a DNS toolkit for Python. It supports almost all record types. It can be used for queries, zone transfers, and dynamic updates. It supports TSIG authenticated messages and EDNS0. dnspython provides both high and low level access to DNS. The high level classes perform queries for data of a given name, type, and class, and return an answer set. The low level classes allow direct manipulation of DNS zones, messages, names, and records. To see a few of the ways dnspython can be used, look in the `examples/` directory. dnspython is a utility to work with DNS, `/etc/hosts` is thus not used. For simple forward DNS lookups, it's better to use `socket.getaddrinfo()` or `socket.gethostbyname()`. dnspython originated at Nominum where it was developed to facilitate the testing of DNS software. ## ABOUT THIS RELEASE This is dnspython 2.3.0. Please read [What's New](https://dnspython.readthedocs.io/en/stable/whatsnew.html) for information about the changes in this release. ## INSTALLATION * Many distributions have dnspython packaged for you, so you should check there first. * If you have pip installed, you can do `pip install dnspython` * If not just download the source file and unzip it, then run `sudo python setup.py install` * To install the latest from the master branch, run `pip install git+https://github.com/rthalley/dnspython.git` Dnspython's default installation does not depend on any modules other than those in the Python standard library. To use some features, additional modules must be installed. For convenience, pip options are defined for the requirements. If you want to use DNS-over-HTTPS, run `pip install dnspython[doh]`. If you want to use DNSSEC functionality, run `pip install dnspython[dnssec]`. If you want to use internationalized domain names (IDNA) functionality, you must run `pip install dnspython[idna]` If you want to use the Trio asynchronous I/O package, run `pip install dnspython[trio]`. If you want to use the Curio asynchronous I/O package, run `pip install dnspython[curio]`. If you want to use WMI on Windows to determine the active DNS settings instead of the default registry scanning method, run `pip install dnspython[wmi]`. If you want to try the experimental DNS-over-QUIC code, run `pip install dnspython[doq]`. Note that you can install any combination of the above, e.g.: `pip install dnspython[doh,dnssec,idna]` ### Notices Python 2.x support ended with the release of 1.16.0. Dnspython 2.0.0 through 2.2.x support Python 3.6 and later. As of dnspython 2.3.0, the minimum supported Python version will be 3.7. We plan to align future support with the lifetime of the Python 3 versions. Documentation has moved to [dnspython.readthedocs.io](https://dnspython.readthedocs.io).