Skip to main content

A Python module to perform DNS resolution, health check and configuration.

Project description

dnscheck

🔎 A Python module and CLI tool to check DNS health, resolve domains, inspect and configure system DNS settings — made for sysadmins, developers, and network engineers.


📦 Installation

Install from PyPI:

pip install dnscheck

🚀 Features

🌐 Resolve domains to IP addresses 📡 Check DNS and network health with ping 🧠 Get system-configured DNS nameservers 🧭 Query authoritative DNS servers (NS records) ⚙️ Change system DNS configuration (Linux only) 🧪 CLI and Python module support

🧑‍💻 Usage

📘 As a Python Module

from dnscheck import resolve, check_dns_health, get_nameservers, get_authoritative_dns, set_dns

# Resolve a domain
ips = resolve("example.com")

# DNS health check
healthy = check_dns_health("google.com")

# Get current nameservers
dns_servers = get_nameservers()

# Get authoritative DNS
authoritative = get_authoritative_dns("example.com")

# Change system DNS (Linux only)
set_dns(["8.8.8.8", "1.1.1.1"])

💻 As a CLI Tool

# Resolve a domain
dnscheck resolve example.com

# Check DNS health
dnscheck health

# Get current DNS servers
dnscheck nameservers

# Get authoritative DNS
dnscheck authoritative example.com

# Set DNS (Linux only)
dnscheck setdns 8.8.8.8 1.1.1.1

📜 License

MIT License.

🧑‍💼 Author

Santhosh Murugesan A full-stack network engineer building tools and writing blogs to make life easier for fellow engineers.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py_dnscheck-1.0.0.tar.gz (4.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

py_dnscheck-1.0.0-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

File details

Details for the file py_dnscheck-1.0.0.tar.gz.

File metadata

  • Download URL: py_dnscheck-1.0.0.tar.gz
  • Upload date:
  • Size: 4.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for py_dnscheck-1.0.0.tar.gz
Algorithm Hash digest
SHA256 b1390de8808de416824ba75055f6fdc50f3b83f6990b872e61a0fe1fc62ba3d5
MD5 7f217691cf15c8ee2d58d00d536b5700
BLAKE2b-256 ac05f686e9e547d5b893c2c692bf8a0c2a96a9026d956116fa84f3cc141e2236

See more details on using hashes here.

File details

Details for the file py_dnscheck-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: py_dnscheck-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 5.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for py_dnscheck-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 40902d855452d1740d57f2ec0b449be433528b4515b8198ce33cf718e47236de
MD5 083c7973ef4cb5eb5dd6c66ce3f3da12
BLAKE2b-256 e65b3e2559ae2e339aceabbd6b3023993aa095280f604b0153306b756e0b9a82

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page