Metadata-Version: 2.1
Name: ping-multi-ext
Version: 1.0.8
Summary: Interactively ping one or many hosts from one or multiple locations (locally or via SSH)
Home-page: https://github.com/famzah/ping-multi-ext
Author: Ivan Zahariev (famzah)
License: UNKNOWN
Project-URL: Bug Reports, https://github.com/famzah/ping-multi-ext/issues
Project-URL: Source, https://github.com/famzah/ping-multi-ext
Description: ping-multi-ext
        **************
        
        This tool lets you interactively ping:
        
        * **One** host from **multiple** locations (via SSH)
        * **Multiple** hosts from **one** location (local machine, or remote via SSH)
        * **Multiple** hosts from **multiple** locations (via SSH)
        
        Screenshots
        ***********
        
        The main screen:
        
        .. image:: https://raw.githubusercontent.com/famzah/ping-multi-ext/main/screenshots/main-screen.jpg
        
        Full history of the "ping" raw output for a selected host:
        
        .. image:: https://raw.githubusercontent.com/famzah/ping-multi-ext/main/screenshots/full-history-ping-output.jpg
        
        Description
        ***********
        
        The ping results are summarized in real-time and you can also observe the following statistics:
        
        * **TX_cnt**: Count of sent PING requests
        * **RX_cnt**: Count of received PING replies which are not timeouts
        * **XX_cnt**: Count of timeouts and missing PING replies
        * **Loss%**: Packet loss defined as the percentage of timed out and missing replies
        * **Avg**: Average round trip time (RTT)
        * **Min**: Minimum (best) RTT
        * **Max**: Maximum (worst) RTT
        * **StDev**: Population standard deviation of all RTT data
        
        The interactive UI interface lets you visualize the **RTT summary** in three modes:
        
        * Successful vs. unsuccessful PING replies
        * The RTT values (ping time) as a number
        * Scaled per 100 ms where "0" means an RTT between 0 and 99 ms,
          "1" means an RTT between 100 and 199 ms, and so on
        
        You also have the option to review each host's "ping" command **raw output**.
        The **full history** is kept and you can navigate using the keys PgUp/PgDn/Home/End.
        
        No "root" privileges are required because for each host an external process is started which uses the standard "ping" command.
        
        You can select the statistics forwards and backwards using the lower "s" and upper "S" keys, similar to the "Vim" behavior.
        
        Installation
        ************
        
        ::
        
          pip3 install ping-multi-ext
        
        The executable "ping-multi" is automatically added to your "~/.local/bin" directory which you should add to your "$PATH" environment, so that you can easily execute "ping-multi".
        
        If you install the package globally using "root" privileges, then the binaries are added in "/usr/local/bin" and you should be able to use them right away with no additional setup.
        
        Examples
        ********
        
        Ping multiple hosts specified directly on the command-line; you can also provide just one host: ::
        
          ping-multi google.com github.com
        
        You can also use SSH to run "ping" on remote machines: ::
        
          ping-multi google.com github.com github.com@root@my-server.com
        
        Ping multiple hosts specified in a file; you can also add more single hosts directly as additional command-line arguments: ::
        
          ping-multi -f sample.list
          
        The usage help explains the additional command-line options: ::
        
          $ ping-multi -h
          
          usage: ping-multi [-h] [--version] [-W,--wait SECS] [-i,--interval SECS] [-f,--file FILE] [--hosts-max-width HOSTS_MAX_WIDTH] [host [host ...]]
          
          Ping all hosts from FILE and HOSTs.
          
          positional arguments:
            host                  host to ping; you can specify this option many times
          
          optional arguments:
            -h, --help            show this help message and exit
            --version             show program's version number and exit
            -W,--wait SECS        timeout in seconds to wait for a ping reply; default=1
            -i,--interval SECS    time in seconds between sending each request; default=1
            -f,--file FILE        read list of hosts from file
            --hosts-max-width HOSTS_MAX_WIDTH
                                  maximum width of the hosts column; default=0
        
Keywords: ping,multi,console,ssh,terminal,interactive
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet
Classifier: Topic :: System :: Networking :: Monitoring
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Python: >=3.6, <4
Description-Content-Type: text/x-rst
