Skip to main content

Meassure latency using TCP.

Project description


PyPI - Python Version PyPI PyPI - License


tcp-latency provides an easy way to measure latency using TCP.

Inspired by other similar tools, tcp-latency comes from the need of running network diagnosis/troubleshooting tasks with Python on serverless infrastructure (as many providers don't include ping/ICMP support) but should work too in any other environment with Python>=36.


  • Runs as a command-line tool or inside your code as a module.
  • Custom parameters for a port, runs, timeout and wait time between runs.
  • IPv4 (e.g and domain (e.g host support.
  • Human readable output when running as a command-line tool.
  • Small and extensible.


tcp-latency can be used both as a module and as a standalone script.


>>> from tcp_latency import meassure_latency
>>> meassure_latency(host='')
>>> meassure_latency(host='', port=80, runs=10, timeout=2.5)
[433.82, 409.21, 409.25, 307.09, 306.64, 409.45, 306.58, 306.93, 409.25, 409.26]

Note: If omitted, meassure_latency() arguments use the same defaults that command line mode.


$ tcplatency -h
usage: tcp-latency [-h] [-p [p]] [-t [t]] [-r [r]] [-w [w]] h

Meassure latency using TCP.

positional arguments:

optional arguments:
  -h, --help            show this help message and exit
  -p [p], --port [p]    (default: 443)
  -t [t], --timeout [t]
                        (seconds, float, default: 5)
  -r [r], --runs [r]    number of latency points (int, default: 5)
  -w [w], --wait [w]    between each run (seconds, float, default: 0)
$ tcplatency tcp seq=0 port=443 timeout=5 time=32.91 ms tcp seq=1 port=443 timeout=5 time=14.1 ms tcp seq=2 port=443 timeout=5 time=16.26 ms tcp seq=3 port=443 timeout=5 time=16.35 ms tcp seq=4 port=443 timeout=5 time=15.63 ms

$ tcplatency --port 80 --runs 3 --wait 0.5 tcp seq=0 port=80 timeout=5 time=269.45 ms tcp seq=1 port=80 timeout=5 time=409.2 ms tcp seq=2 port=80 timeout=5 time=409.14 ms

$ tcp-latency -r 1 tcp seq=0 port=443 timeout=5 time=34.36 ms


Via pip:

pip install tcp-latency

How to contribute

  1. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
  2. Fork the repository on GitHub to start making your changes to the master branch (or branch off of it).
  3. Write a test which shows that the bug was fixed or that the feature works as expected.
  4. Send a pull request and bug me until it gets merged and published.

Some things that would be great to have:

  • Add at the end of human_output statistics (ping-like).
  • Add documentation (Sphinx?).
  • Add Ipv6 support.
  • Add support for machine-readable output (JSON?XML?).
  • Add automated testing and releases with CircleCI.
  • Add codecov.
  • Add to a list of alternatives to tcp-latency.
  • Improve formatting in human_output to feel more like ping.
  • Improve test suite.
  • Improve How to contribute information (pyenv, tox, pre-commit...)

Similar tools

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tcp-latency, version 0.0.5
Filename, size File type Python version Upload date Hashes
Filename, size tcp_latency-0.0.5-py3-none-any.whl (5.4 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size tcp-latency-0.0.5.tar.gz (4.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page