KYDNS (Know Your DNS) is a simple DNS client library written in Python 3.
It allows sending DNS queries for A, AAAA, and NS records, easily modify any of the DNS packet fields, and provides an ASCII representation of the DNS
7F8F
packets.
The library is designed to be easy to use and can be used for learning, testing, or other purposes.
KYDNS uses Python 3 standard libs and has no 3rd party dependencies. Install using pip:
pip install kydnsOr git clone:
git clone https://github.com/eliaonceagain/kydns.git
cd kydns/
pip install .Send a DNS query for the A record of google.com and return the response
from kydns import Request
req = Request("google.com")
rsp = req.send(("1.1.1.1", 53))>>> rsp
1
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0501 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|1| 0x0 |0|0|1|1| 0 | 0x0 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0001 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0001 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0000 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0000 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+<--Header
/ google.com /
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0001 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0001 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+<--Question
/ google.com /
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0001 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0001 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| |
+ 265 +
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0004 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
/ /
+ 142.251.36.14 +
/ /
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+<--ARecord
KYDNS also allows you to easily modify any of the DNS packet fields before sending the query. Here is an example of how to set the DNS request ID:
from kydns import Request
req = Request('google.com') # or Request('google.com', id=0x1234)
req.header.id = 0x1234
rsp = req.send(("1.1.1.1", 53))
assert req.header.id == rsp.header.id == 0x1234>>> req.header
1
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x1234 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|0| 0x0 |0|0|1|0| 0 | 0x0 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0001 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0000 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0000 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0000 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+<--Header
>>> rsp.header
1
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x1234 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|1| 0x0 |0|0|1|1| 0 | 0x0 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0001 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0001 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0000 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x0000 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+<--Header
KYDNS is licensed under the MIT license. See the LICENSE file for more details.