TCP Port Ping
Repeatedly connect to a TCP host and port and report latency.
Install
pip install lupaxa-tcp-port-ping
tcp-port-ping --help
CLI
tcp-port-ping --server example.com --port 80
tcp-port-ping -s example.com -p 443 -d 1
tcp-port-ping -s 192.0.2.10 -p 22 --count 5 --timeout 0.5
python -m lupaxa.tcp_port_ping --version
The tool opens a TCP connection, times the handshake, closes it, and
repeats after --delay seconds (default 1). --server and --port
are required. --timeout bounds the socket (default 1 second). Omit
--count to run until Ctrl-C; the summary then prints total, pass,
fail, and the failure percentage.
Library
from lupaxa.tcp_port_ping import probe_tcp_port, run_probes
one = probe_tcp_port("example.com", 443, timeout=1.0)
print(one.ok, one.elapsed_ms, one.detail)
summary = run_probes("example.com", 443, count=3, delay=0)
print(summary.total, summary.passed, summary.failed, summary.fail_percent)
Development
make init
make python-install-dev
make python-check
make mkdocs-serve
Documentation
The published guide is at https://tcp-port-ping.thelupaxaproject.org/.
Site Markdown lives in mkdocs/.
1 maintainer
Release files for lupaxa-tcp-port-ping 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| lupaxa_tcp_port_ping-0.1.2.tar.gz | 7.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| lupaxa_tcp_port_ping-0.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 15.8 kB
Release files / lupaxa_tcp_port_ping-0.1.2.tar.gz
| Download URL | lupaxa_tcp_port_ping-0.1.2.tar.gz |
|---|---|
| Size | 7.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
de7cf270c5b4bd3f72814c3056398e02b218056f89d59f75dd3bb4af830dc1fe
|
|
BLAKE2b-256 checksum How to use checksums |
dded59f1e58b4f01f7195dc89590eaf2ecab95916e07f35722b2f27c0586cb03
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency logRelease files / lupaxa_tcp_port_ping-0.1.2-py3-none-any.whl
| Download URL | lupaxa_tcp_port_ping-0.1.2-py3-none-any.whl |
|---|---|
| Size | 8.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
af08b8b996000d8db1b92e5034def944a859bd84b40f48cf98a21288c8ae91cd
|
|
BLAKE2b-256 checksum How to use checksums |
4c64848369105cf7d008ee5d3ffb9fb6a788ad97e778b67eca3aa772b3019c50
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency log
