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.

Publishing to PyPI

Create an API token in your PyPI account, then run these commands from this directory:

python -m pip install --upgrade build twine
python -m build
python -m twine check dist/*
$env:TWINE_USERNAME = "__token__"
$env:TWINE_PASSWORD = "pypi-your-api-token"
python -m twine upload dist/*

Do not save the PyPI token in this project or commit it to source control.