Cybersecurity-Projects/PROJECTS/beginner/dns-lookup
CarterPerez-dev ef315b072b chore: add demos for projects, update haskell-reverse-proxy modules, refresh siem assets
- Add DEMO.md and screenshots for bug-bounty-platform, hash-cracker,
  linux-cis-hardening-auditor, simple-port-scanner, simple-vulnerability-scanner,
  systemd-persistence-scanner, base64-tool, caesar-cipher, dns-lookup,
  metadata-scrubber-tool, network-traffic-analyzer, siem-dashboard
- Link DEMO.md from project READMEs
- Add .gitignore entries for DEMO-TRACKER and simple-port-scanner build dir
- Restructure haskell-reverse-proxy with DDoS, Fingerprint, ML, RateLimit, WAF,
  Geo, and Honeypot modules; drop superseded research docs and old Makefile
- Refresh siem-dashboard dashboard.png and rename alerts.png to alert-detail.png
2026-04-26 23:12:48 -04:00
..
assets chore: add demos for projects, update haskell-reverse-proxy modules, refresh siem assets 2026-04-26 23:12:48 -04:00
dnslookup feat: did a couple things idk 2026-02-28 14:08:36 -05:00
learn add and create all learn/ folders for beginner projects 2026-01-31 15:13:31 -05:00
tests feat: did a couple things idk 2026-02-28 14:08:36 -05:00
.gitignore feat: Complete Go secrets scanner - Portia 2026-02-22 20:02:38 -05:00
.style.yapf Phase 1.1: Organize PROJECTS by difficulty level 2026-01-29 02:41:15 -05:00
DEMO.md chore: add demos for projects, update haskell-reverse-proxy modules, refresh siem assets 2026-04-26 23:12:48 -04:00
LICENSE - Standardize READMEs and add justfiles across all 14 projects 2026-02-11 07:01:25 -05:00
README.md chore: add demos for projects, update haskell-reverse-proxy modules, refresh siem assets 2026-04-26 23:12:48 -04:00
justfile Phase 1.1: Organize PROJECTS by difficulty level 2026-01-29 02:41:15 -05:00
pyproject.toml Phase 1.1: Organize PROJECTS by difficulty level 2026-01-29 02:41:15 -05:00
uv.lock chore(deps): bump pytest in /PROJECTS/beginner/dns-lookup 2026-04-14 02:59:57 +00:00

README.md

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

Cybersecurity Projects Python License: AGPLv3 PyPI

Professional DNS query CLI with Rich terminal output, reverse lookups, and WHOIS integration.

This is a quick overview — security theory, architecture, and full walkthroughs are in the learn modules.

Screenshots & demo →

What It Does

  • Query A, AAAA, MX, NS, TXT, CNAME, and SOA records with colored table output
  • Reverse DNS lookup to resolve IP addresses back to hostnames
  • Trace DNS resolution path from root servers to authoritative nameservers
  • Batch lookups with concurrent queries for processing domain lists
  • WHOIS integration for domain registration information
  • JSON export for scripting and pipeline integration

Quick Start

uv tool install dnslookup-cli
dnslookup query example.com

[!TIP] This project uses just as a command runner. Type just to see all available commands.

Install: curl -sSf https://just.systems/install.sh | bash -s -- --to ~/.local/bin

Commands

Command Description
dnslookup query Query DNS records for a domain with colored table output
dnslookup reverse Resolve an IP address back to its hostname
dnslookup trace Trace the DNS resolution path from root to authoritative servers
dnslookup batch Query multiple domains concurrently from a file
dnslookup whois Retrieve WHOIS registration information for a domain

Learn

This project includes step-by-step learning materials covering security theory, architecture, and implementation.

Module Topic
00 - Overview Prerequisites and quick start
01 - Concepts Security theory and real-world breaches
02 - Architecture System design and data flow
03 - Implementation Code walkthrough
04 - Challenges Extension ideas and exercises

License

AGPL 3.0