$ dnstest

dns latency, measured

How fast is your DNS, really?

dnstest queries the big public resolvers straight from your terminal and tells you exactly who answers first — one real round-trip at a time. No config files, no daemons.

capabilities — v1.0

01 · latency

Each resolver gets one real UDP round-trip, timed to the millisecond. No caches, no retry logic polluting the numbers.

02 · flags

--resolvers, --type, --count, --json, --quiet — everything a script needs.

03 · exit codes

0 answered · 1 nothing answered · 2 usage error. Grep-friendly, cron-friendly.

04 · zero config

A single Python file, two dependencies, no daemon and no database. Uninstallable by deletion.

installation — 60 seconds

install.sh sh
# from pypi (once published)
$ pip install dnstest

# or straight from source
$ git clone https://github.com/brycejensen540/DNStest
$ cd DNStest
$ python -m venv .venv && source .venv/bin/activate
$ pip install .

Requires Python 3.10 or newer. The full list of flags lives in the project README.

usage — copy & paste

examples.sh sh
$ dnstest example.com
$ dnstest example.com --type AAAA
$ dnstest api.example.com --resolvers 9.9.9.9,149.112.112.112
$ dnstest example.com --count 5 --json | jq '.summary'
$ dnstest --list-resolvers

built-in resolvers — shipped by default

resolver address
Cloudflare 1.1.1.1
Google 8.8.8.8
Quad9 9.9.9.9
OpenDNS 208.67.222.222

Missing your favorite? --resolvers accepts any list, comma-separated or repeated.