Skip to main content

Simple ping visualization on the CLI

Project description


Software Description

This script provides a simple CLI based ping visualization script by utilizing `hipster plot`_ with customize-able UI views.

The software aims to remain lightweight and as os-independent as possible while maintaining ex sensibility throughout the software.

Why should you use it?

.. *Right, but why would I use it?*

The long and short is that ``pingstats`` provides a simple and stable method to visualize average ping over time from the command line. Aside from that, it provides the following features:

- Provides a highly modular dynamic UI layout selector, allowing the user to modify the way the software presents data.

- Provides a simple API for implementing unique and new UI behaviour

- Automatically resizes and stays aware of viewport size

- Stays under a megabyte of total size


Installation has been made easy on any system that implements ``pip3``.

pip3 install pingstats


Installing from source

Installing from source can be achieved relatively simply by first cloning the
repository and moving into the subsequent directory:

git clone && cd pingstats

.. note:: To checkout the newest, experimental changes ensure you are on the
``rolling-release`` branch with ``git checkout rolling-release``

Once the repository is cloned, you can run the ```` script to install
the local files:

python3 install


This software was implemented with simplicity in mind, and only provides one point of access:


Command Line Arguments

The software also has a variety of command line arguments avaialable:

usage: pingstats [-h] [-l LAYOUT] [--list-widgets] [-V] address

positional arguments:
address The address to ping. This could be either a web
address (i.e, "") or an IP address.

optional arguments:
-h, --help show this help message and exit
-l LAYOUT, --layout LAYOUT
Specify a UI layout by listing ui elements in a comma
separated list where
'realtimepane,progstatus,averagepane' displays the
default layout. See the docs for more information.
--list-widgets Output a list of available widgets for '-l'
-V, --version show program's version number and exit

Examples of software in use

.. image::

In this image, we can see two separate outputs. The top display is a display of the most recent actual return times, whereas the bottom display is the average return time for each sequence.

This display automatically scales to whatever window you have open, adding more lines and columns as necessary.

Running the tests

To run the tests, clone the repository:

git clone

Then simply run:

python3 test

.. include:: CONTRIBUTION.rst

.. _`hipster plot`:
.. _PingStats:

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 pingstats, version 0.9.4
Filename, size File type Python version Upload date Hashes
Filename, size pingstats-0.9.4-py3-none-any.whl (13.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pingstats-0.9.4.tar.gz (12.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page