pingly 0.1.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in Pingly.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Robert Jackson
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,52 @@
+# Pingly
+
+We built this to allow us to quickly know if our Internet connection had failed, but
+we quickly realized it had many more possibilities. Uses your systems 'ping' command
+to attempt a ping on the host specified and lets you access the results.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'Pingly'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install Pingly
+
+## Usage
+
+Use the Pingly binary (optionally specifying a host to ping) to ping every 5 seconds and log the output forever.
+
+You can also use this in your code to test if a service is up:
+
+    require 'Pingly'
+
+    # standard initialization
+    p = Pingly.new('google.com')
+    p.ping!
+
+    # quick/shortcut initialization (same as above)
+    p = Pingly.ping!('google.com')
+
+    puts p.response #=> "2013-01-03 15:48:29 - google.com(74.125.139.102) - Sent: 5 Received: 5 Loss: 0.0%"
+
+One can call any of the following methods on an instance of Pingly to get various details of the ping attempt:
+
+* packet\_loss - Returns a float representing the packet loss.
+* ip\_address - Returns a string representing the IP Address that the system resolved the passed in host to.
+* packets\_sent - Returns the number of packets sent as an integer.
+* packets\_received - Returns the number of packets received as an integer.
+* response - Returns a formatted string containing the results if the previous methods.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/pingly

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(File.join('..','lib','pingly'), File.dirname(__FILE__))
+
+host = ARGV[0] || 'google.com'
+
+Pingly.ping_loop(host) do
+  `say 'LINK DOWN'`
+end

data/lib/pingly.rb

@@ -0,0 +1,68 @@
+class Pingly
+  VERSION = '0.1.0'
+
+  attr_accessor :host, :timeout, :raw_response
+
+  def self.ping_loop(host, timeout = 5)
+    while true do
+      p = new(host)
+      p.ping!
+
+      if p.packet_loss > 0
+        yield if block_given?
+      end
+
+      puts p.response
+    end
+  end
+
+  def self.ping!(host, timeout = 5)
+    new(host,timeout).ping!
+  end
+
+  def initialize(host, timeout = 5)
+    self.host, self.timeout = host, timeout
+  end
+
+  def ping!
+    self.raw_response = `#{build_ping_string}`
+  end
+
+  def packet_loss
+    response_regex(/(\d+\.\d+)\% packet loss$/).to_f
+  end
+
+  def ip_address
+    response_regex(/^PING #{Regexp.escape(host)} \((\d+\.\d+\.\d+\.\d+)\)/)
+  end
+
+  def packets_sent
+    response_regex(/^(\d+) packets transmitted/).to_i
+  end
+
+  def packets_received
+    response_regex(/, (\d+) packets received/).to_i
+  end
+
+  def response
+    "#{Time.now.strftime('%Y-%m-%d %H:%M:%S')} - #{host}(#{ip_address}) - Sent: #{packets_sent} Received: #{packets_received} Loss: #{packet_loss}%"
+  end
+
+  private
+
+  def response_regex(regex)
+    ping! unless raw_response
+    raw_response =~ regex
+    $1
+  end
+
+  def build_ping_string
+    "ping -t #{timeout} -q #{host}"
+  end
+end
+
+if __FILE__ == $0
+  Pingly.ping_loop('google.com') do
+    `say 'link down'`
+  end
+end

data/pinger.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'pingly'
+
+Gem::Specification.new do |gem|
+  gem.name          = "pingly"
+  gem.version       = Pingly::VERSION
+  gem.authors       = ["Jon Jackson", "Robert Jackson"]
+  gem.email         = ["robertj@promedicalinc.com"]
+  gem.description   = %q{Ping a specified host, logs the output, and calls a block on packet loss.}
+  gem.summary       = %q{Ping a specified host.}
+  gem.homepage      = "https://github.com/rjackson/Pingly"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: pingly
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Jon Jackson
+- Robert Jackson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-01-03 00:00:00.000000000 Z
+dependencies: []
+description: Ping a specified host, logs the output, and calls a block on packet loss.
+email:
+- robertj@promedicalinc.com
+executables:
+- pingly
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/pingly
+- lib/pingly.rb
+- pinger.gemspec
+homepage: https://github.com/rjackson/Pingly
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+  none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+  none: false
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Ping a specified host.
+test_files: []
+has_rdoc: