123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149 |
- Metadata-Version: 2.3
- Name: dnspython
- Version: 2.7.0
- Summary: DNS toolkit
- Project-URL: homepage, https://www.dnspython.org
- Project-URL: repository, https://github.com/rthalley/dnspython.git
- Project-URL: documentation, https://dnspython.readthedocs.io/en/stable/
- Project-URL: issues, https://github.com/rthalley/dnspython/issues
- Author-email: Bob Halley <halley@dnspython.org>
- License: ISC
- License-File: LICENSE
- Classifier: Development Status :: 5 - Production/Stable
- Classifier: Intended Audience :: Developers
- Classifier: Intended Audience :: System Administrators
- Classifier: License :: OSI Approved :: ISC License (ISCL)
- Classifier: Operating System :: Microsoft :: Windows
- Classifier: Operating System :: POSIX
- Classifier: Programming Language :: Python
- Classifier: Programming Language :: Python :: 3
- Classifier: Programming Language :: Python :: 3.9
- Classifier: Programming Language :: Python :: 3.10
- Classifier: Programming Language :: Python :: 3.11
- Classifier: Programming Language :: Python :: 3.12
- Classifier: Programming Language :: Python :: 3.13
- Classifier: Topic :: Internet :: Name Service (DNS)
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
- Requires-Python: >=3.9
- Provides-Extra: dev
- Requires-Dist: black>=23.1.0; extra == 'dev'
- Requires-Dist: coverage>=7.0; extra == 'dev'
- Requires-Dist: flake8>=7; extra == 'dev'
- Requires-Dist: hypercorn>=0.16.0; extra == 'dev'
- Requires-Dist: mypy>=1.8; extra == 'dev'
- Requires-Dist: pylint>=3; extra == 'dev'
- Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
- Requires-Dist: pytest>=7.4; extra == 'dev'
- Requires-Dist: quart-trio>=0.11.0; extra == 'dev'
- Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == 'dev'
- Requires-Dist: sphinx>=7.2.0; extra == 'dev'
- Requires-Dist: twine>=4.0.0; extra == 'dev'
- Requires-Dist: wheel>=0.42.0; extra == 'dev'
- Provides-Extra: dnssec
- Requires-Dist: cryptography>=43; extra == 'dnssec'
- Provides-Extra: doh
- Requires-Dist: h2>=4.1.0; extra == 'doh'
- Requires-Dist: httpcore>=1.0.0; extra == 'doh'
- Requires-Dist: httpx>=0.26.0; extra == 'doh'
- Provides-Extra: doq
- Requires-Dist: aioquic>=1.0.0; extra == 'doq'
- Provides-Extra: idna
- Requires-Dist: idna>=3.7; extra == 'idna'
- Provides-Extra: trio
- Requires-Dist: trio>=0.23; extra == 'trio'
- Provides-Extra: wmi
- Requires-Dist: wmi>=1.5.1; extra == 'wmi'
- Description-Content-Type: text/markdown
- # dnspython
- [](https://github.com/rthalley/dnspython/actions/)
- [](https://dnspython.readthedocs.io/en/latest/?badge=latest)
- [](https://badge.fury.io/py/dnspython)
- [](https://opensource.org/licenses/ISC)
- [](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.7.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.
- * To use a wheel downloaded from PyPi, run:
- pip install dnspython
- * To install from the source code, go into the top-level of the source code
- and run:
- ```
- pip install --upgrade pip build
- python -m build
- pip install dist/*.whl
- ```
- * To install the latest from the main 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 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.6.x supports
- Python 3.8 and later, though support for 3.8 ends on October 14, 2024.
- Dnspython 2.7.x supports Python 3.9 and later. Future support is aligned with the
- lifetime of the Python 3 versions.
- Documentation has moved to
- [dnspython.readthedocs.io](https://dnspython.readthedocs.io).
|