METADATA 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149
  1. Metadata-Version: 2.4
  2. Name: dnspython
  3. Version: 2.8.0
  4. Summary: DNS toolkit
  5. Project-URL: homepage, https://www.dnspython.org
  6. Project-URL: repository, https://github.com/rthalley/dnspython.git
  7. Project-URL: documentation, https://dnspython.readthedocs.io/en/stable/
  8. Project-URL: issues, https://github.com/rthalley/dnspython/issues
  9. Author-email: Bob Halley <halley@dnspython.org>
  10. License: ISC
  11. License-File: LICENSE
  12. Classifier: Development Status :: 5 - Production/Stable
  13. Classifier: Intended Audience :: Developers
  14. Classifier: Intended Audience :: System Administrators
  15. Classifier: License :: OSI Approved :: ISC License (ISCL)
  16. Classifier: Operating System :: Microsoft :: Windows
  17. Classifier: Operating System :: POSIX
  18. Classifier: Programming Language :: Python
  19. Classifier: Programming Language :: Python :: 3
  20. Classifier: Programming Language :: Python :: 3.10
  21. Classifier: Programming Language :: Python :: 3.11
  22. Classifier: Programming Language :: Python :: 3.12
  23. Classifier: Programming Language :: Python :: 3.13
  24. Classifier: Topic :: Internet :: Name Service (DNS)
  25. Classifier: Topic :: Software Development :: Libraries :: Python Modules
  26. Requires-Python: >=3.10
  27. Provides-Extra: dev
  28. Requires-Dist: black>=25.1.0; extra == 'dev'
  29. Requires-Dist: coverage>=7.0; extra == 'dev'
  30. Requires-Dist: flake8>=7; extra == 'dev'
  31. Requires-Dist: hypercorn>=0.17.0; extra == 'dev'
  32. Requires-Dist: mypy>=1.17; extra == 'dev'
  33. Requires-Dist: pylint>=3; extra == 'dev'
  34. Requires-Dist: pytest-cov>=6.2.0; extra == 'dev'
  35. Requires-Dist: pytest>=8.4; extra == 'dev'
  36. Requires-Dist: quart-trio>=0.12.0; extra == 'dev'
  37. Requires-Dist: sphinx-rtd-theme>=3.0.0; extra == 'dev'
  38. Requires-Dist: sphinx>=8.2.0; extra == 'dev'
  39. Requires-Dist: twine>=6.1.0; extra == 'dev'
  40. Requires-Dist: wheel>=0.45.0; extra == 'dev'
  41. Provides-Extra: dnssec
  42. Requires-Dist: cryptography>=45; extra == 'dnssec'
  43. Provides-Extra: doh
  44. Requires-Dist: h2>=4.2.0; extra == 'doh'
  45. Requires-Dist: httpcore>=1.0.0; extra == 'doh'
  46. Requires-Dist: httpx>=0.28.0; extra == 'doh'
  47. Provides-Extra: doq
  48. Requires-Dist: aioquic>=1.2.0; extra == 'doq'
  49. Provides-Extra: idna
  50. Requires-Dist: idna>=3.10; extra == 'idna'
  51. Provides-Extra: trio
  52. Requires-Dist: trio>=0.30; extra == 'trio'
  53. Provides-Extra: wmi
  54. Requires-Dist: wmi>=1.5.1; (platform_system == 'Windows') and extra == 'wmi'
  55. Description-Content-Type: text/markdown
  56. # dnspython
  57. [![Build Status](https://github.com/rthalley/dnspython/actions/workflows/ci.yml/badge.svg)](https://github.com/rthalley/dnspython/actions/)
  58. [![Documentation Status](https://readthedocs.org/projects/dnspython/badge/?version=latest)](https://dnspython.readthedocs.io/en/latest/?badge=latest)
  59. [![PyPI version](https://badge.fury.io/py/dnspython.svg)](https://badge.fury.io/py/dnspython)
  60. [![License: ISC](https://img.shields.io/badge/License-ISC-brightgreen.svg)](https://opensource.org/licenses/ISC)
  61. [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
  62. ## INTRODUCTION
  63. `dnspython` is a DNS toolkit for Python. It supports almost all record types. It
  64. can be used for queries, zone transfers, and dynamic updates. It supports
  65. TSIG-authenticated messages and EDNS0.
  66. `dnspython` provides both high- and low-level access to DNS. The high-level
  67. classes perform queries for data of a given name, type, and class, and return an
  68. answer set. The low-level classes allow direct manipulation of DNS zones,
  69. messages, names, and records.
  70. To see a few of the ways `dnspython` can be used, look in the `examples/`
  71. directory.
  72. `dnspython` is a utility to work with DNS, `/etc/hosts` is thus not used. For
  73. simple forward DNS lookups, it's better to use `socket.getaddrinfo()` or
  74. `socket.gethostbyname()`.
  75. `dnspython` originated at Nominum where it was developed to facilitate the
  76. testing of DNS software.
  77. ## ABOUT THIS RELEASE
  78. This is of `dnspython` 2.8.0.
  79. Please read
  80. [What's New](https://dnspython.readthedocs.io/en/stable/whatsnew.html) for
  81. information about the changes in this release.
  82. ## INSTALLATION
  83. * Many distributions have dnspython packaged for you, so you should check there
  84. first.
  85. * To use a wheel downloaded from PyPi, run:
  86. ```
  87. pip install dnspython
  88. ```
  89. * To install from the source code, go into the top-level of the source code
  90. and run:
  91. ```
  92. pip install --upgrade pip build
  93. python -m build
  94. pip install dist/*.whl
  95. ```
  96. * To install the latest from the main branch, run
  97. `pip install git+https://github.com/rthalley/dnspython.git`
  98. `dnspython`'s default installation does not depend on any modules other than
  99. those in the Python standard library. To use some features, additional modules
  100. must be installed. For convenience, `pip` options are defined for the
  101. requirements.
  102. If you want to use DNS-over-HTTPS, run
  103. `pip install dnspython[doh]`.
  104. If you want to use DNSSEC functionality, run
  105. `pip install dnspython[dnssec]`.
  106. If you want to use internationalized domain names (IDNA)
  107. functionality, you must run
  108. `pip install dnspython[idna]`
  109. If you want to use the Trio asynchronous I/O package, run
  110. `pip install dnspython[trio]`.
  111. If you want to use WMI on Windows to determine the active DNS settings
  112. instead of the default registry scanning method, run
  113. `pip install dnspython[wmi]`.
  114. If you want to try the experimental DNS-over-QUIC code, run
  115. `pip install dnspython[doq]`.
  116. Note that you can install any combination of the above, e.g.:
  117. `pip install dnspython[doh,dnssec,idna]`
  118. ### Notices
  119. Python 2.x support ended with the release of 1.16.0. `dnspython` supports Python 3.10
  120. and later. Future support is aligned with the lifetime of the Python 3 versions.
  121. Documentation has moved to
  122. [dnspython.readthedocs.io](https://dnspython.readthedocs.io).