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 py-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.1.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.1-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: py_dnscheck-1.0.1.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.1.tar.gz
Algorithm Hash digest
SHA256 a9d0a94477a4f39be5b8ca174a52734ab0ea0dc8c5851a558e216108f7a62822
MD5 bb29e7771cef00e9f2a5010d44e3a0f2
BLAKE2b-256 60189661e34ea1a9beaa3bdbccd5855794172991bebfa3aea6362a9a1965b6ee

See more details on using hashes here.

File details

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

File metadata

  • Download URL: py_dnscheck-1.0.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e1abc6f79c006f95c0857324951c4e4751954660524ef07c056777f10ac02a8d
MD5 24bc2b2365bf42500fe64c4e83a6e6aa
BLAKE2b-256 5cf6c7e8251a5b59c4ac01a934aababe7564d51d2b0b10ed911d7a8c17ef9754

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