Metadata-Version: 2.1
Name: ppping
Version: 0.1.10
Summary: ping monitoring tool written in Python
Home-page: http://github.com/johejo/ppping
Author: Mitsuo Heijo
Author-email: mitsuo_h@outlook.com
License: MIT
Platform: Linux
Platform: UNIX
Platform: macOS
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: System :: Networking :: Monitoring
Requires-Python: >=3.5

ppping
======

.. image:: https://travis-ci.org/johejo/ppping.svg?branch=master
    :target: https://travis-ci.org/johejo/ppping

.. image:: https://img.shields.io/pypi/v/ppping.svg
    :target: https://pypi.python.org/pypi/ppping

.. image:: https://img.shields.io/github/license/johejo/ppping.svg
    :target: https://raw.githubusercontent.com/johejo/ppping/master/LICENSE

.. image:: https://api.codeclimate.com/v1/badges/aea7bbd42d3b4cf5b4ae/maintainability
   :target: https://codeclimate.com/github/johejo/ppping/maintainability
   :alt: Maintainability

.. image:: https://api.codeclimate.com/v1/badges/aea7bbd42d3b4cf5b4ae/test_coverage
   :target: https://codeclimate.com/github/johejo/ppping/test_coverage
   :alt: Test Coverage

Description
-----------

ping monitoring tool written in Python affected
`deadman <https://github.com/upa/deadman>`__

Demo
----

.. figure:: https://github.com/johejo/ppping/blob/master/demo.gif
   :alt: result

Environment
-----------

ppping works using python's curses

List of environments actually checking the operation

- Linux distribution (Ubuntu, ArchLinux)
- Windows Subsystem for Linux (Ubuntu)
- UNIX (macOS)

Requirements
------------

- Python 3.5 or later
- cURL (optional: used to acquire global IP)

Install
-------

From PyPi
~~~~~~~~~
.. code:: bash

    $ pip install -U ppping

Standalone (recommended)
~~~~~~~~~~~~~~~~~~~~~~~~

Download standalone script to a directory that is convenient for you (e.g. "~/.local/bin/" or "/usr/local/bin/")

.. code:: bash

    $ curl "https://raw.githubusercontent.com/johejo/ppping/master/standalone/ppping" -O
    $ chmod +x ppping


Usage
-----

Simple Usage
~~~~~~~~~~~~

.. code:: bash

    $ ppping foo.com bar.org WW.XX.YY.ZZ ...

Futher help

.. code:: bash

    $ ppping --help

Config File Usage
~~~~~~~~~~~~~~~~~

.. code:: bash

    $ ppping -c [CONFIG_FILE]

This is a sample of configuration file.

::

    [Hosts]
    google: www.google.com
    google DNS: 8.8.8.8
    GitHub: www.github.com

Docker image
~~~~~~~~~~~~

.. code:: bash

    $ docker run --rm -it johejo/ppping foo.bar ...

When using the docker container, you can not read the config file by the method shown above. 
It is necessary to mount the config file on the container. For example ``-v CONFIGFILE:/CONFIGFILE``

License
-------

MIT


