JC SRE NETPROBE

Network health checks and utilities for Telecom, Networking, DevOps and SRE.

Features

• TCP connectivity checks with latency measurement
• DNS resolution checks
• HTTP/HTTPS health checks
• IPv4 and IPv6 network information
• TLS certificate validation and expiration information
• Configurable timeouts for TCP, HTTP and TLS checks
• JSON output for automation and scripting
• CLI input validation
• Operational exit codes

Installation

Requires Python 3.11+.

pip install jc-sre-netprobe

Usage

jc-sre-netprobe tcp HOST PORT [--timeout SECONDS]
jc-sre-netprobe dns HOSTNAME
jc-sre-netprobe http URL [--timeout SECONDS]
jc-sre-netprobe network CIDR
jc-sre-netprobe tls HOST [--port PORT] [--timeout SECONDS]

Examples

TCP connectivity check:

jc-sre-netprobe tcp github.com 443

TLS certificate check:

jc-sre-netprobe tls github.com

TLS check with a custom timeout:

jc-sre-netprobe tls github.com --timeout 3

JSON output:

jc-sre-netprobe --json tls github.com

Exit codes

The CLI uses exit codes designed for automation, monitoring and scripting:

Example:

jc-sre-netprobe tcp github.com 443
echo $?

Python API

from jc_sre_netprobe import tcp_check

result = tcp_check("github.com", 443)

print(result)

TLS checks are also available through the Python API:

from jc_sre_netprobe import tls_check

result = tls_check("github.com")

print(result)

Development

git clone https://github.com/jacivaldocarvalho/jc-sre-netprobe.git
cd jc-sre-netprobe

python -m venv .venv
source .venv/bin/activate

pip install -e ".[dev]"

Quality checks:

ruff check .
mypy src tests
pytest --cov=jc_sre_netprobe

CI/CD

GitHub Actions validates the project with Python 3.11, 3.12 and 3.13 using:

• Ruff
• Mypy
• Pytest
• Coverage
• Package build

Releases are published to PyPI using GitHub Actions, OpenID Connect (OIDC) and PyPI Trusted Publishing, without long-lived PyPI credentials.

License

Distributed under the MIT License. See LICENSE for more information.

Author

Jacivaldo Carvalho

Telecommunications Engineer | DevOps | SRE | Networking