🌐 DNSLOOKUP

██████╗ ███╗   ██╗███████╗██╗      ██████╗  ██████╗ ██╗  ██╗██╗   ██╗██████╗
██╔══██╗████╗  ██║██╔════╝██║     ██╔═══██╗██╔═══██╗██║ ██╔╝██║   ██║██╔══██╗
██║  ██║██╔██╗ ██║███████╗██║     ██║   ██║██║   ██║█████╔╝ ██║   ██║██████╔╝
██║  ██║██║╚██╗██║╚════██║██║     ██║   ██║██║   ██║██╔═██╗ ██║   ██║██╔═══╝
██████╔╝██║ ╚████║███████║███████╗╚██████╔╝╚██████╔╝██║  ██╗╚██████╔╝██║
╚═════╝ ╚═╝  ╚═══╝╚══════╝╚══════╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚═╝

Professional DNS query CLI with Rich terminal output, asynchronous resolution, and integrated WHOIS lookups.

---

✨ Features

• 🚀 Asynchronous Resolution: Concurrent querying for high-performance lookups.
• 🌳 Visual DNS Trace: Interactive tree view of the resolution path from root servers.
• 📋 Rich Formatting: Beautifully color-coded tables for A, MX, NS, TXT, and more.
• 🔍 WHOIS Integration: Instant domain registration details in a clean interface.
• 📦 Batch Processing: Process domain lists concurrently with JSON export support.
• 🛠️ Developer Friendly: Full JSON output support for pipeline integration.

---

🚀 Installation

Using pip

pip install .

Using uv (Recommended)

uv tool install .

---

🛠️ Usage

1. Basic Query

Retrieve all common records for a domain in a beautiful table.

dnslookup query google.com

2. DNS Trace

Follow the resolution path from root servers to the authoritative nameserver.

dnslookup trace example.com

3. WHOIS Lookup

Get registrar and registration dates for any domain.

dnslookup whois github.com

4. Reverse Lookup

Find the hostname associated with an IP address.

dnslookup reverse 8.8.8.8

5. Batch Mode

Process a file containing multiple domains (one per line).

dnslookup batch domains.txt --output results.json

---

⚙️ Configuration

All commands support the following flags:

• --json: Output raw data in JSON format for scripting.
• --server: Specify a custom DNS nameserver (e.g., 8.8.8.8).
• --timeout: Adjust query timeout in seconds.

---

👨‍💻 Author

Created and maintained by dk3yyyy.

---

⚖️ License

AGPL 3.0