Technologies Used

Python Socket programming ICMP TCP

netcheckup is a Python-based command-line utility that provides a quick and practical way to diagnose internet connectivity issues. I built this tool to consolidate essential network health checks — DNS resolution, ICMP ping latency, and port reachability — into a single, fast, and user-friendly CLI command.

The tool is published on PyPI and can be installed with a simple pip install netcheckup. Once installed, users can run targeted diagnostics directly from the terminal without needing multiple external tools.

This project focuses on simplicity, usability, and real-world troubleshooting scenarios where quick network validation is critical.


Key Features

  • DNS resolution time checks for popular domains
  • ICMP ping latency testing for public IPs
  • TCP port reachability validation for common services
  • Modular CLI commands for targeted checks
  • Installable and distributable via PyPI
  • Clean Python package structure with reusable functions

netcheckup is a lightweight internet health diagnostic tool. It can check DNS resolution time, ping latency, and common port connectivity.

Usage

netcheckup

Installation

Install directly from PyPI:

pip install netcheckup

After installation, just run:

netcheckup

just run:

netcheckup speed
from netcheckup import main

main()
from netcheckup import ping_check

print(ping_check(["8.8.8.8"]))
netcheckup ping --host 8.8.8.8 1.1.1.1 --count 4
from netcheckup import dns_check

print(dns_check(["google.com"]))
netcheckup dns --domain example.com google.com
from netcheckup import port_check

print(port_check(host="8.8.8.8", ports=[53, 443]))
netcheckup port --host 8.8.8.8 --ports 53 443
netcheckup all