Python version

.gitignore

@@ -0,0 +1,9 @@
+*.py[co]
+*~
+*.egg-info
+/dist
+/build
+.pydevproject
+/.settings
+/.venv*
+/.idea

AUTHORS

@@ -0,0 +1,18 @@
+AUTHORS / CONTRIBUTORS (alphabetic order):
+
+ * Cowles, Matthew Dixon -- ftp://ftp.visi.com/users/mdc/ping.py
+ * Diemer, Jens -- http://www.jensdiemer.de
+ * Falatic, Martin -- http://www.falatic.com
+ * Hallman, Chris -- http://cdhallman.blogspot.com
+ * Harvey, Dan -- https://github.com/danharvey
+ * incidence -- https://github.com/incidence
+ * jcborras -- https://github.com/jcborras
+ * Motl, Andreas -- https://github.com/amotl
+ * Notaras, George -- http://www.g-loaded.eu
+ * Poincheval, Jerome
+ * Sarkhel, Kunal -- https://github.com/techwizrd
+ * Stauffer, Samuel
+ * Tibold, Marko -- https://github.com/markotibold
+ * Toews, Ben --- http://btoe.ws
+ * Zach Ware
+ * zed -- https://github.com/zed

CHANGES.rst

@@ -0,0 +1,39 @@
+***************
+gping changelog
+***************
+
+In progress
+===========
+
+2016-11-21 0.2
+==============
+- Be graceful to hostname resolution failures
+- Record all failures (hostname resolution and timeouts) in ``self.failures``
+- Improve console output formatting
+- Add shell command entrypoint ``gping`` to ``setup.py``
+- Add argument parsing for interactive use, e.g. ``--hostnames=www.example.net,mail.example.net``
+- Incorporate "Make it possible to ping without root access" using ``socket.SOCK_DGRAM`` instead of ``socket.SOCK_RAW``
+  by Marko Tibold: https://github.com/markotibold/gping/commit/b75fa2d4
+- Incorporate  "Allow binding to an interface", e.g. ``--bind=192.168.111.2``
+  by Dan Harvey: https://github.com/danharvey/pyping/commit/cb848976
+- Non-interactive mode: Record all results in ``self.results``
+- Non-interactive mode: Make verbose output optional
+
+2012-08-21 0.1
+==============
+- Fix setup.py deps
+- Add install instructions to README
+- Tag release ``gping-0.1``
+
+2012-07-17 0.0
+==============
+- Add main gping.py
+
+2012-07-12 0.0
+==============
+- Change __main__ action. Fix id overflow issue.
+
+2012-07-10 0.0
+==============
+- First commit. Clean out stuff. Fix setup.py.
+- Add README.md

LICENSE

@@ -0,0 +1,11 @@
+The original code derived from ping.c distributed in Linux's netkit.
+That code is copyright (c) 1989 by The Regents of the University of California.
+That code is in turn derived from code written by Mike Muuss of the
+US Army Ballistic Research Laboratory in December, 1983 and
+placed in the public domain. They have my thanks.
+
+Copyright (c) Matthew Dixon Cowles, <http://www.visi.com/~mdc/>.
+Distributable under the terms of the GNU General Public License
+version 2. Provided with no warranties of any sort.
+
+See AUTHORS for complete list of authors and contributors.

README.md

@@ -0,0 +1,59 @@
+# GPing #
+
+An asynchronous, event-driven, pure-python ping implementation using raw sockets based on gevent.
+This is a fork of the python-ping project replacing its internal machinery with gevent.
+The point is to have an event driven ping utility for doing a huge number of concurrent pings efficiently.
+
+
+## Usage ##
+
+### Run on the commandline ###
+
+    # Ping some hostnames
+    gping --hostnames=gnu.org,fsf.org,google.com,microsoft.com,googleusercontent.com,live.com,stackoverflow.com,141.1.1.1,8.8.8.8,192.168.123.1,192.168.999.1
+
+    # Bind to a specific IP address
+    gping --bind=192.168.111.2 --hostnames=google.com,stackoverflow.com,8.8.8.8
+
+### Demo with 100 concurrent pings ###
+
+    # Ping the top 100 domains
+    time python gping.py
+
+### Use as library ###
+
+    from gping import GPing
+
+    gp = GPing()
+    gp.send("127.0.0.1", test_callback)
+    gp.join()
+
+## Install ##
+
+### From Python Package Index ###
+This *should* be easy on your average \*nix box, just type:
+
+    sudo pip install gping
+
+
+### From GitHub ###
+This way of installing gping is suitable for hacking on it:
+
+    git clone https://github.com/mastahyeti/gping.git
+    cd gping
+    virtualenv .venv27
+    source .venv27/bin/activate
+    python setup.py develop
+
+## License and Credits ##
+
+The python-ping project was started by Matthew Dixon Cowles.
+
+    - copyleft 1989-2016 by the python-ping team, see AUTHORS for more details.
+    - license: GNU GPL v2, see LICENSE for more details.
+
+It was forked and ported to `gevent` by Ben Toews. Since then, this program is now called appropriately *GPing*.
+
+He says:
+> I have left the license and authors information intact, but this project seems to have a long history or forks and such
+> so I am probably somehow pissing someone off or violating some license. Let me know if this is the case and I will be better.

TODO.rst

@@ -0,0 +1,24 @@
+**********
+gping todo
+**********
+
+Tasks
+=====
+- [x] Add entrypoint ``gping`` and argument parsing
+- [o] Add reading from stdin
+- [o] Add collectd metrics gathering: https://pythonhosted.org/collectd/
+
+Upstream changes
+================
+- [x] Add "Make it possible to ping without root access.": https://github.com/markotibold/gping/commit/b75fa2d41ec10073f894676fc3f3ec6b46693c05
+- [o] Add "Allow binding to an interface": https://github.com/danharvey/pyping/commit/cb8489762d3171fb0b69c0fb9aaa8968d5e439b4
+- [o] Add statsd support: https://github.com/ChristianKniep/python-ping/commit/a3653526e5857f346e2a244988df3849574ba385
+- [o] Check "fix packet numbering bug": https://github.com/matesito/gping/commit/498c93500e35c8f5ad9c682df1e6c66fb5c5998a
+- [o] Check improvements from Vijayananda Reddy: https://github.com/VijayanandaReddy/gping/commit/25ac7c8efb6cf394b6c36ed2ed5b6712116b6c53
+- [o] Check "For some reason, die was not working": https://github.com/biplav/gping/commit/377f0f4e85535fd3b6f812eb29d49ad8bf9a24fa
+- [o] Check "Changes to harden gping.py for usecases like die, ping of devices, timeouts": https://github.com/biplav/gping/commit/6fb9008d4ae63f954f6d59cfbf4bb445964c1351
+- [o] Check features of leading non-gevent repositories (IPv6, etc.):
+
+    - https://github.com/l4m3rx/python-ping
+    - https://github.com/tomwilkie/pyping
+