Metadata-Version: 2.0
Name: pingparsing
Version: 0.2.0
Summary: pingparsing is a python library of parsing ping command output.
Home-page: https://github.com/thombashi/pingparsing
Author: Tsuyoshi Hombashi
Author-email: gogogo.vm@gmail.com
License: MIT License
Keywords: ping,parse
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Networking
Requires-Dist: DataProperty
Requires-Dist: pyparsing

**pingparsing**

.. image:: https://travis-ci.org/thombashi/pingparsing.svg?branch=master
    :target: https://travis-ci.org/thombashi/pingparsing

.. contents:: Table of contents
   :backlinks: top
   :local:

Summary
=======
pingparsing is a python library of parsing ping command output.

Installation
============

::

    pip install pingparsing

Usage
=====

Parsing ping output
-------------------

parse\_sample.py
~~~~~~~~~~~~~~~~

.. code:: python

    import pingparsing
    ping_parser = pingparsing.PingParsing()

    # parse out put of `ping google.com -q -c 60`
    ping_parser.parse("""
    PING google.com (216.58.196.238) 56(84) bytes of data.

    --- google.com ping statistics ---
    60 packets transmitted, 60 received, 0% packet loss, time 59153ms
    rtt min/avg/max/mdev = 61.425/99.731/212.597/27.566 ms
    """)

    print "packet_transmit:", ping_parser.packet_transmit
    print "packet_receive:", ping_parser.packet_receive
    print "packet_loss:", ping_parser.packet_loss
    print "rtt_min:", ping_parser.rtt_min
    print "rtt_avg:", ping_parser.rtt_avg
    print "rtt_max:", ping_parser.rtt_max
    print "rtt_mdev:", ping_parser.rtt_mdev
    print ping_parser.as_dict()

Execution result of parse\_sample.py
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code:: console

    ./parse_sample.py
    packet_transmit: 60
    packet_receive: 60
    packet_loss: 0.0
    rtt_min: 61.425
    rtt_avg: 99.731
    rtt_max: 212.597
    rtt_mdev: 27.566
    {'packet_loss': 0.0, 'packet_receive': 60, 'packet_transmit': 60, 'rtt_min': 61.425, 'rtt_max': 212.597, 'rtt_mdev': 27.566, 'rtt_avg': 99.731}

Execute ping and parse
----------------------

ping\_sample.py
~~~~~~~~~~~~~~~

.. code:: python

    import pingparsing
    ping_parser = pingparsing.PingParsing()
    ping_parser.destination_host = "192.168.11.25"
    ping_parser.waittime = 5
    result = ping_parser.ping()
    ping_parser.parse(result)

    print "packet_transmit:", ping_parser.packet_transmit
    print "packet_receive:", ping_parser.packet_receive
    print "packet_loss:", ping_parser.packet_loss
    print "rtt_min:", ping_parser.rtt_min
    print "rtt_avg:", ping_parser.rtt_avg
    print "rtt_max:", ping_parser.rtt_max
    print "rtt_mdev:", ping_parser.rtt_mdev
    print ping_parser.as_dict()

Execution result of ping\_sample.py
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code:: console

    ./sample.py
    packet_transmit: 5379
    packet_receive: 5379
    packet_loss: 0.0
    rtt_min: 0.397
    rtt_avg: 0.911
    rtt_max: 7.393
    rtt_mdev: 0.783
    {'packet_loss': 0.0, 'packet_receive': 5379, 'packet_transmit': 5379, 'rtt_min': 0.397, 'rtt_max': 7.393, 'rtt_mdev': 0.783, 'rtt_avg': 0.911}

Dependencies
============

Python 2.5+ or 3.3+

-  `DataPropery <https://github.com/thombashi/DataProperty>`__
-  `pyparsing <https://pyparsing.wikispaces.com/>`__

Test dependencies
-----------------

-  `pytest <https://pypi.python.org/pypi/pytest>`__
-  `pytest-runner <https://pypi.python.org/pypi/pytest-runner>`__
-  `tox <https://pypi.python.org/pypi/tox>`__


