Description:
pingping 1.3.4
Multi Linguistic Ping (pingping)
Introduction
Docs
Commands
Pre-requisites
Installation and Downloads
FAQ
Other Resources
Bug Tracker and Support
Unit-Tests
License and Copyright
Author and Thanks
Introduction
pingping is a special library which understands multi linguistic of ping output and translated the result to machine understandable format. i.e. Json
pingping is a vendor independent library where you can parse any language ping output
pingping support tcping which works on transport layer i.e. Ping on proxy server, here ping refers to seding packets via tcp protocol to check the connectivity.
Docs
How to use pingping?
Command Line
Type pingping <ip-address> or pingping <ip-address> --web. For more help type pingping -h
Python
It's very simple, create an object of Ping and call ping method with ip address. Internally it calls system ping command and captures the needed result.
How to run ping command?
# cli
pingping 192.168.1.1
pingping 1.1.1.1
# python code
obj = Ping()
print(obj.ping('192.168.1.1'))
print(obj.ping('1.1.1.1'))
It returns Json output and easy to understand by the keys of it.
{"ip": "192.168.1.1", "loss_percentage": 100.0}
{"ip": "1.1.1.1", "loss_percentage": 0.0, "min": 55.669, "avg": 78.198, "max": 130.778, "time_in": "ms"}
How to capture result from ping output?
I am having ping result how to analise the output of it.
Ping.fetch_ping_data(ping_output) # it's a class method.
It automatically identifies the ip address and important details from it. It doesn't have any language barier.
{"ip": "1.1.1.1", "loss_percentage": 0.0, "min": 55.669, "avg": 78.198, "max": 130.778, "time_in": "ms"}
Commands
Usage pingping <ip-address>
-c | --count <Number>
-l4 | --web | --tcp | --http (ping over proxy)
-h | --help
Pre-requisites
pingping supports both trains of python 2.7+ and 3.1+, the OS should not matter.
shconfparser is used to captured the data.
Installation and Downloads
The best way to get pingping is with setuptools or pip. If you already have setuptools, you can install as usual:
python -m pip install pingping
Otherwise download it from PyPi, extract it and run the setup.py script
python setup.py install
If you're Interested in the source, you can always pull from the github repo:
From github git clone https://github.com/network-tools/pingping.git
FAQ
Question: I want to use pingping with Python3, is that safe?
Answer: As long as you're using python 3.3 or higher, it's safe. I tested every release against python 3.1+, however python 3.1 and 3.2 not running in continuous integration test.
Question: I want to use pingping with Python2, is that safe?
Answer: As long as you're using python 2.7 or higher, it's safe. I tested against python 2.7.
Other Resources
Python3 documentation is a good way to learn python
Python GeeksforGeeks
JSON
Bug Tracker and Support
Please report any suggestions, bug reports, or annoyances with pingping through the Github bug tracker. If you're having problems with general python issues, consider searching for a solution on Stack Overflow.
If you can't find a solution for your problem or need more help, you can ask a question.
You can also ask on the Stack Exchange Network Engineering site.
Unit Tests
Travis CI project tests pingping on Python versions 2.7 through 3.7.
The current build status is:
License and Copyright
pingping is licensed MIT 2019
Author and Thanks
pingping was developed by Kiran Kumar Kotari
License
For personal and professional use. You cannot resell or redistribute these repositories in their original state.
Customer Reviews
There are no reviews.
