dnspython

2.8.0

Sun, 07 Sep 2025 12:15:00 -0700

Dnspython 2.8.0 is now available on PyPI.

Thank you to all the contributors to this release, and, as usual, thanks to my co-maintainers: Tomáš Křížek, Petr Špaček, and Brian Wellington.

Dnspython 2.8.0 requires Python 3.10 or later.

This release was published to PyPI using Trusted Publishing.

2.8.0rc1

Mon, 01 Sep 2025 17:00:00 -0700

Dnspython 2.8.0rc1 is now available on PyPI.

This is the first release candidate for dnspython 2.8.0. See What’s New for details.

We anticipate the final release in about a week.

Thank you to all the contributors to this release.

Dnspython 2.8.0 requires Python 3.10 or later.

2.7.0

Sat, 05 Oct 2024 13:15:00 -0700

Dnspython 2.7.0 is now available on PyPI.

See What’s New for details.

Thank you to all the contributors to this release, and, as usual, thanks to my co-maintainers: Tomáš Křížek, Petr Špaček, and Brian Wellington.

Dnspython 2.7.0 requires Python 3.9 or later.

2.7.0rc1

Sat, 21 Sep 2024 10:00:00 -0700

Dnspython 2.7.0rc1 is now available on PyPI.

This is the first release candidate for dnspython 2.7.0. See What’s New for details.

We anticipate the final release in about a week.

Thank you to all the contributors to this release.

Dnspython 2.7.0 requires Python 3.9 or later.

2.6.1

Sun, 18 Feb 2024 10:35:00 -0800

Dnspython 2.6.1 is now available on PyPI.

See What’s New for details.

This is a bug fix release for 2.6.0 where the “TuDoor” fix erroneously suppressed legitimate Truncated exceptions. This caused the stub resolver to timeout instead of failing over to TCP when a legitimate truncated response was received over UDP.

This release addresses the potential DoS issue discussed in the “TuDoor” paper (CVE-2023-29483). The dnspython stub resolver is vulnerable to a potential DoS if a bad-in-some-way response from the right address and port forged by an attacker arrives before a legitimate one on the UDP port dnspython is using for that query. In this situation, dnspython might switch to querying another resolver or give up entirely, possibly denying service for that resolution. This release addresses the issue by adopting the recommended mitigation, which is ignoring the bad packets and continuing to listen for a legitimate response until the timeout for the query has expired.

2.6.0

Fri, 16 Feb 2024 12:15:00 -0800

Dnspython 2.6.0 is now available on PyPI.

See What’s New for details.

2.6.0rc1

Sat, 10 Feb 2024 06:00:00 -0800

Dnspython 2.6.0rc1 is now available on PyPI.

This is the first release candidate for dnspython 2.6.0. See What’s New for details.

About dnspython

Fri, 09 Feb 2024 05:25:00 -0800

Dnspython is a DNS toolkit for Python. It can be used for queries, zone transfers, dynamic updates, nameserver testing, and many other things.

Dnspython provides both high and low level access to the 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. Almost all RR types are supported.

2.5.0

Sat, 20 Jan 2024 05:00:00 -0800

Dnspython 2.5.0 is now available on PyPI.

See What’s New for details.

Thank you to all the contributors to this release, and, as usual, thanks to my co-maintainers: Tomáš Křížek, Petr Špaček, and Brian Wellington.

Dnspython 2.5.0 requires Python 3.8 or later. Python 3.8 goes into end-of-life state in October of 2024, and dnspython will drop support for it at that time and require 3.9 or later.

2.5.0rc1

Sat, 06 Jan 2024 08:50:00 -0800

Dnspython 2.5.0rc1 is now available on PyPI.

This is the first release candidate for dnspython 2.5.0. See What’s New for details.

Thank you to all the contributors to this release.

Dnspython 2.5.0 requires Python 3.8 or later. Python 3.8 goes into end-of-life state in October of 2024, and dnspython will drop support for it at that time and require 3.9 or later.

2.4.2

Wed, 09 Aug 2023 07:00:00 -0655

Dnspython 2.4.2 is now available on PyPI.

This is a bug fix release, see What’s New for the details.

2.4.1

Wed, 26 Jul 2023 07:00:00 -0700

Dnspython 2.4.1 is now available on PyPI.

This is a bug fix release, see What’s New for the details.

2.4.0

Sat, 15 Jul 2023 08:45:00 -0700

Dnspython 2.4.0 is now available on PyPI.

See What’s New!

Thank you to all the contributors to this release. Special thanks to Jakob Schlyter for writing zone signing code and also refactoring the DNSSEC code to allow new algorithms to be added more easily.

Dnspython 2.4.0 requires Python 3.8 or later. Also note that this release drops support for curio and requests (DoH is now done exclusively with httpx).

2.4.0rc1

Tue, 04 Jul 2023 13:30:00 -0700

Dnspython 2.4.0rc1 is now available on PyPI.

This is the first release candidate for dnspython 2.4.0. See What’s New!

Thank you to all the contributors to this release. Special thanks to Jakob Schlyter for writing zone signing code and also refactoring the DNSSEC code to allow new algorithms to be added more easily.

Dnspython 2.4.0 requires Python 3.8 or later. Also note that this release drops support for curio and requests (DoH is now done exclusively with httpx).

2.3.0

Sun, 15 Jan 2023 09:15:00 -0800

Dnspython 2.3.0 is now available on PyPI.

See What’s New for the details!

Thank you to all the contributors to this release, and special thanks to Jakob Schlyter for writing code to make DNSSEC signatures and help with DS, CDS, and CDNSKEY management.

Dnspython 2.3.0 requires Python 3.7 or later.

2.3.0rc1

Tue, 27 Dec 2022 12:15:00 -0800

Dnspython 2.3.0rc1 is now available on PyPI.

This is the first release candidate for dnspython 2.3.0. See What’s New!

Thank you to all the contributors to this release, and special thanks to Jakob Schlyter for writing code to make DNSSEC signatures and help with DS, CDS, and CDNSKEY management.

Dnspython 2.3.0 requires Python 3.7 or later.

2.2.1

Sun, 06 Mar 2022 15:30:00 -0800

Dnspython 2.2.1 is now available on PyPI. There are no new features, this is just a bug fix release.

See What’s New for all the fixes.

Thank you to all the contributors to this release.

Python 2.x support ended with 1.16.0. Dnspython 2.2.1 requires Python 3.6 or later.

Note that when dnspython 2.3 is released, the minimum Python version will be 3.7.

2.2.0

Tue, 18 Jan 2022 05:45:00 -0800

Dnspython 2.2.0 is now available on PyPI.

See What’s New for all the features.

Thank you to all the contributors to this release.

Python 2.x support ended with 1.16.0. Dnspython 2.2.0 requires Python 3.6 or later.

2.2.0rc1

Tue, 21 Dec 2021 08:15:00 -0800

Dnspython 2.2.0rc1 is now available on PyPI.

This is the first release candidate for dnspython 2.2.0. See What’s New!

2.1.0

Thu, 07 Jan 2021 08:30:00 -0800

Dnspython 2.1.0 is now available on PyPI.

See “What’s New” for all the features in this major release.

Thanks to the many people who have contributed to this release!

Python 2.x support ended with 1.16.0. Dnspython 2.1.0 requires Python 3.6 or later.

2.1.0rc1

Fri, 30 Oct 2020 09:30:00 -0700

Dnspython 2.1.0rc1 is now available on PyPI.

This is the first release candidate for dnspython 2.1.0. See What’s New!

2.0.0

Fri, 17 Jul 2020 06:30:00 -0700

Dnspython 2.0.0 is now available on PyPI.

See “What’s New” for all the features in this major release.

Thanks to the many people who have contributed to this release!

Python 2.x support ended with 1.16.0. Dnspython 2.0.0 requires Python 3.6 or later.

2.0.0rc2

Sat, 04 Jul 2020 10:21:00 -0700

Dnspython 2.0.0rc2 is now available on PyPI.

This is the second release candidate for dnspython 2.0.0. See What’s New!

There was a substantial overhaul of the message class hierarchy and the rdata encoding system in this RC, and dedicated classes were made for OPT and TSIG.

2.0.0rc1

Sat, 20 Jun 2020 14:09:00 -0700

Dnspython 2.0.0rc1 is now available on PyPI.

This is the first release candidate for dnspython 2.0.0. See What’s New!

Python support update

Sat, 20 Jun 2020 10:21:00 -0700

Python 2.x support ended with 1.16.0. Dnspython 2.0.0 will require Python 3.6 or later.

Mon, 01 Jan 0001 00:00:00 +0000

Examples

Get the MX target and preference of a name:

import dns.resolver

answers = dns.resolver.resolve('dnspython.org', 'MX')
for rdata in answers:
    print('Host', rdata.exchange, 'has preference', rdata.preference)

Use DNS dynamic update to set the address of a host to a value specified on the command line:

import dns.tsigkeyring
import dns.update
import sys

keyring = dns.tsigkeyring.from_text({
    'host-example.' : 'XXXXXXXXXXXXXXXXXXXXXX=='
})

update = dns.update.UpdateMessage('dyn.test.example', keyring=keyring)
update.replace('host', 300, 'a', sys.argv[1])

response = dns.query.tcp(update, '10.0.0.1')

Manipulate domain names: