checkconnectnet

A tiny, dependency-free Python library for checking whether an HTTP or HTTPS endpoint is reachable.

Installation

pip install checkconnectnet

Usage

from checkconnectnet import is_connected

if is_connected():
    print("Online")
else:
    print("Offline")

You can choose the URL and timeout:

from checkconnectnet import check_connection

result = check_connection("https://example.com", timeout=3)
print(result.connected, result.status_code, result.elapsed_seconds, result.error)

The default URL is https://icanhazip.com/. Any HTTP response proves that the network request reached the server, including responses such as 403 or 404.

Command line

checkconnectnet
checkconnectnet --url https://example.com --timeout 3

The command exits with code 0 when connected and 1 when the request fails.