net-ping 1.7.4-universal-mingw32 → 1.7.5-universal-mingw32

data/examples/example_pingexternal.rb

@@ -1,16 +1,16 @@
-########################################################################
-# example_pingexternal.rb
-#
-# A short sample program demonstrating an external ping. You can run
-# this program via the example:external task. Modify as you see fit.
-########################################################################
-require 'net/ping'
-
-good = 'www.rubyforge.org'
-bad  = 'foo.bar.baz'
-
-p1 = Net::Ping::External.new(good)
-p p1.ping?
-
-p2 = Net::Ping::External.new(bad)
-p p2.ping?
+########################################################################
+# example_pingexternal.rb
+#
+# A short sample program demonstrating an external ping. You can run
+# this program via the example:external task. Modify as you see fit.
+########################################################################
+require 'net/ping'
+
+good = 'www.rubyforge.org'
+bad  = 'foo.bar.baz'
+
+p1 = Net::Ping::External.new(good)
+p p1.ping?
+
+p2 = Net::Ping::External.new(bad)
+p p2.ping?

data/examples/example_pinghttp.rb

@@ -1,22 +1,22 @@
-########################################################################
-# example_pinghttp.rb
-#
-# A short sample program demonstrating an http ping. You can run
-# this program via the example:http task. Modify as you see fit.
-########################################################################
-require 'net/ping'
-
-good = 'http://www.google.com/index.html'
-bad  = 'http://www.ruby-lang.org/index.html'
-
-puts "== Good ping, no redirect"
-
-p1 = Net::Ping::HTTP.new(good)
-p p1.ping?
-
-puts "== Bad ping"
-
-p2 = Net::Ping::HTTP.new(bad)
-p p2.ping?
-p p2.warning
-p p2.exception
+########################################################################
+# example_pinghttp.rb
+#
+# A short sample program demonstrating an http ping. You can run
+# this program via the example:http task. Modify as you see fit.
+########################################################################
+require 'net/ping'
+
+good = 'http://www.google.com/index.html'
+bad  = 'http://www.ruby-lang.org/index.html'
+
+puts "== Good ping, no redirect"
+
+p1 = Net::Ping::HTTP.new(good)
+p p1.ping?
+
+puts "== Bad ping"
+
+p2 = Net::Ping::HTTP.new(bad)
+p p2.ping?
+p p2.warning
+p p2.exception

data/examples/example_pingtcp.rb

@@ -1,16 +1,16 @@
-########################################################################
-# example_pingtcp.rb
-#
-# A short sample program demonstrating a tcp ping. You can run
-# this program via the example:tcp task. Modify as you see fit.
-########################################################################
-require 'net/ping'
-
-good = 'www.google.com'
-bad  = 'foo.bar.baz'
-
-p1 = Net::Ping::TCP.new(good, 'http')
-p p1.ping?
-
-p2 = Net::Ping::TCP.new(bad)
-p p2.ping?
+########################################################################
+# example_pingtcp.rb
+#
+# A short sample program demonstrating a tcp ping. You can run
+# this program via the example:tcp task. Modify as you see fit.
+########################################################################
+require 'net/ping'
+
+good = 'www.google.com'
+bad  = 'foo.bar.baz'
+
+p1 = Net::Ping::TCP.new(good, 'http')
+p p1.ping?
+
+p2 = Net::Ping::TCP.new(bad)
+p p2.ping?

data/examples/example_pingudp.rb

@@ -1,12 +1,12 @@
-########################################################################
-# example_pingudp.rb
-#
-# A short sample program demonstrating a UDP ping. You can run
-# this program via the example:udp task. Modify as you see fit.
-########################################################################
-require 'net/ping'
-
-host = 'www.google.com'
-
-u = Net::Ping::UDP.new(host)
-p u.ping?
+########################################################################
+# example_pingudp.rb
+#
+# A short sample program demonstrating a UDP ping. You can run
+# this program via the example:udp task. Modify as you see fit.
+########################################################################
+require 'net/ping'
+
+host = 'www.google.com'
+
+u = Net::Ping::UDP.new(host)
+p u.ping?

data/lib/net/ping.rb

@@ -1,17 +1,17 @@
-# By doing a "require 'net/ping'" you are requiring every subclass.  If you
-# want to require a specific ping type only, do "require 'net/ping/tcp'",
-# for example.
-#
-require 'rbconfig'
-
-require File.join(File.dirname(__FILE__), 'ping/tcp')
-require File.join(File.dirname(__FILE__), 'ping/udp')
-require File.join(File.dirname(__FILE__), 'ping/icmp')
-require File.join(File.dirname(__FILE__), 'ping/external')
-require File.join(File.dirname(__FILE__), 'ping/http')
-
-RbConfig = Config unless Object.const_defined?(:RbConfig)
-
-if File::ALT_SEPARATOR
-  require File.join(File.dirname(__FILE__), 'ping/wmi')
-end
+# By doing a "require 'net/ping'" you are requiring every subclass.  If you
+# want to require a specific ping type only, do "require 'net/ping/tcp'",
+# for example.
+#
+require 'rbconfig'
+
+require File.join(File.dirname(__FILE__), 'ping/tcp')
+require File.join(File.dirname(__FILE__), 'ping/udp')
+require File.join(File.dirname(__FILE__), 'ping/icmp')
+require File.join(File.dirname(__FILE__), 'ping/external')
+require File.join(File.dirname(__FILE__), 'ping/http')
+
+RbConfig = Config unless Object.const_defined?(:RbConfig)
+
+if File::ALT_SEPARATOR
+  require File.join(File.dirname(__FILE__), 'ping/wmi')
+end

data/lib/net/ping/external.rb

@@ -1,93 +1,101 @@
-require 'open3'
-require 'rbconfig'
-
-require File.join(File.dirname(__FILE__), 'ping')
-
-# The Net module serves as a namespace only.
-module Net
-
-  # The Ping::External class encapsulates methods for external (system) pings.
-  class Ping::External < Ping
-    # Pings the host using your system's ping utility and checks for any
-    # errors or warnings. Returns true if successful, or false if not.
-    #
-    # If the ping failed then the Ping::External#exception method should
-    # contain a string indicating what went wrong. If the ping succeeded then
-    # the Ping::External#warning method may or may not contain a value.
-    #
-    def ping(host = @host)
-      super(host)
-
-      pcmd = ['ping']
-      bool = false
-
-      case RbConfig::CONFIG['host_os']
-        when /linux/i
-          pcmd += ['-c', '1', '-W', @timeout.to_s, host]
-        when /aix/i
-          pcmd += ['-c', '1', '-w', @timeout.to_s, host]
-        when /bsd|osx|mach|darwin/i
-          pcmd += ['-c', '1', '-t', @timeout.to_s, host]
-        when /solaris|sunos/i
-          pcmd += [host, @timeout.to_s]
-        when /hpux/i
-          pcmd += [host, '-n1', '-m', @timeout.to_s]
-        when /win32|windows|msdos|mswin|cygwin|mingw/i
-          pcmd += ['-n', '1', '-w', (@timeout * 1000).to_s, host]
-        else
-          pcmd += [host]
-      end
-
-      start_time = Time.now
-
-      begin
-        err = nil
-
-        Open3.popen3(*pcmd) do |stdin, stdout, stderr, thread|
-          stdin.close
-          err = stderr.gets # Can't chomp yet, might be nil
-
-          case thread.value.exitstatus
-            when 0
-              info = stdout.read
-              if info =~ /unreachable/ix # Windows
-                bool = false
-                @exception = "host unreachable"
-              else
-                bool = true  # Success, at least one response.
-              end
-
-              if err & err =~ /warning/i
-                @warning = err.chomp
-              end
-            when 2
-              bool = false # Transmission successful, no response.
-              @exception = err.chomp if err
-            else
-              bool = false # An error occurred
-              if err
-                @exception = err.chomp
-              else
-                stdout.each_line do |line|
-                  if line =~ /(timed out|could not find host|packet loss)/i
-                    @exception = line.chomp
-                    break
-                  end
-                end
-              end
-          end
-        end
-      rescue Exception => error
-        @exception = error.message
-      end
-
-      # There is no duration if the ping failed
-      @duration = Time.now - start_time if bool
-
-      bool
-    end
-
-    alias ping? ping
-    alias pingecho ping
-  end
-end
+require 'open3'
+require 'rbconfig'
+
+require File.join(File.dirname(__FILE__), 'ping')
+
+# The Net module serves as a namespace only.
+module Net
+
+  # The Ping::External class encapsulates methods for external (system) pings.
+  class Ping::External < Ping
+    # Pings the host using your system's ping utility and checks for any
+    # errors or warnings. Returns true if successful, or false if not.
+    #
+    # If the ping failed then the Ping::External#exception method should
+    # contain a string indicating what went wrong. If the ping succeeded then
+    # the Ping::External#warning method may or may not contain a value.
+    #
+    def ping(host = @host, count = 1, interval = 1, timeout = @timeout)
+
+      raise "Count must be an integer" unless count.is_a? Integer
+      raise "Timeout must be a number" unless timeout.is_a? Numeric
+
+      unless interval.is_a?(Numeric) && interval >= 0.2
+        raise "Interval must be a decimal greater than or equal to 0.2"
+      end
+
+      super(host)
+
+      pcmd = ['ping']
+      bool = false
+
+      case RbConfig::CONFIG['host_os']
+        when /linux/i
+          pcmd += ['-c', count.to_s, '-W', timeout.to_s, host, '-i', interval.to_s]
+        when /aix/i
+          pcmd += ['-c', count.to_s, '-w', timeout.to_s, host]
+        when /bsd|osx|mach|darwin/i
+          pcmd += ['-c', count.to_s, '-t', timeout.to_s, host]
+        when /solaris|sunos/i
+          pcmd += [host, timeout.to_s]
+        when /hpux/i
+          pcmd += [host, "-n#{count.to_s}", '-m', timeout.to_s]
+        when /win32|windows|msdos|mswin|cygwin|mingw/i
+          pcmd += ['-n', count.to_s, '-w', (timeout * 1000).to_s, host]
+        else
+          pcmd += [host]
+      end
+
+      start_time = Time.now
+
+      begin
+        err = nil
+
+        Open3.popen3(*pcmd) do |stdin, stdout, stderr, thread|
+          stdin.close
+          err = stderr.gets # Can't chomp yet, might be nil
+
+          case thread.value.exitstatus
+            when 0
+              info = stdout.read
+              if info =~ /unreachable/ix # Windows
+                bool = false
+                @exception = "host unreachable"
+              else
+                bool = true  # Success, at least one response.
+              end
+
+              if err & err =~ /warning/i
+                @warning = err.chomp
+              end
+            when 2
+              bool = false # Transmission successful, no response.
+              @exception = err.chomp if err
+            else
+              bool = false # An error occurred
+              if err
+                @exception = err.chomp
+              else
+                stdout.each_line do |line|
+                  if line =~ /(timed out|could not find host|packet loss)/i
+                    @exception = line.chomp
+                    break
+                  end
+                end
+              end
+          end
+        end
+      rescue Exception => error
+        @exception = error.message
+      end
+
+      # There is no duration if the ping failed
+      @duration = Time.now - start_time if bool
+
+      bool
+    end
+
+    alias ping? ping
+    alias pingecho ping
+  end
+end

data/lib/net/ping/http.rb

@@ -1,188 +1,188 @@
-require File.join(File.dirname(__FILE__), 'ping')
-require 'net/http'
-require 'net/https'
-require 'uri'
-require 'open-uri'
-
-# Force non-blocking Socket.getaddrinfo on Unix systems. Do not use on
-# Windows because it (ironically) causes blocking problems.
-unless File::ALT_SEPARATOR or RUBY_VERSION >= "1.9.3"
-  require 'resolv-replace'
-end
-
-# The Net module serves as a namespace only.
-module Net
-
-  # The Ping::HTTP class encapsulates methods for HTTP pings.
-  class Ping::HTTP < Ping
-
-    # By default an http ping will follow a redirect and give you the result
-    # of the final URI.  If this value is set to false, then it will not
-    # follow a redirect and will return false immediately on a redirect.
-    #
-    attr_accessor :follow_redirect
-
-    # The maximum number of redirects allowed. The default is 5.
-    attr_accessor :redirect_limit
-
-    # The user agent used for the HTTP request. The default is nil.
-    attr_accessor :user_agent
-
-    # OpenSSL certificate verification mode. The default is VERIFY_NONE.
-    attr_accessor :ssl_verify_mode
-
-    # Use GET request instead HEAD. The default is false.
-    attr_accessor :get_request
-
-    # was this ping proxied?
-    attr_accessor :proxied
-
-    # For unsuccessful requests that return a server error, it is
-    # useful to know the HTTP status code of the response.
-    attr_reader :code
-
-    # Creates and returns a new Ping::HTTP object. The default port is the
-    # port associated with the URI or 80. The default timeout is 5 seconds.
-    #
-    def initialize(uri=nil, port=nil, timeout=5)
-      @follow_redirect = true
-      @redirect_limit  = 5
-      @ssl_verify_mode = OpenSSL::SSL::VERIFY_NONE
-      @get_request     = false
-      @code            = nil
-
-      port ||= URI.parse(uri).port if uri
-      port ||= 80
-
-      @port = port
-
-      super(uri, port, timeout)
-    end
-
-    # Looks for an HTTP response from the URI passed to the constructor.
-    # If the result is a kind of Net::HTTPSuccess then the ping was
-    # successful and true is returned.  Otherwise, false is returned
-    # and the Ping::HTTP#exception method should contain a string
-    # indicating what went wrong.
-    #
-    # If the HTTP#follow_redirect accessor is set to true (which it is
-    # by default) and a redirect occurs during the ping, then the
-    # HTTP#warning attribute is set to the redirect message, but the
-    # return result is still true. If it's set to false then a redirect
-    # response is considered a failed ping.
-    #
-    # If no file or path is specified in the URI, then '/' is assumed.
-    # If no scheme is present in the URI, then 'http' is assumed.
-    #
-    def ping(host = @host)
-      super(host)
-      bool = false
-
-      # See https://bugs.ruby-lang.org/issues/8645
-      host = "http://#{host}" unless host.include?("http")
-
-      uri = URI.parse(host)
-
-      # A port provided here via the host argument overrides anything
-      # provided in constructor.
-      #
-      port = URI.split(host)[3] || URI.parse(host).port || @port
-      port = port.to_i
-
-      start_time = Time.now
-
-      response = do_ping(uri, port)
-
-      if response.is_a?(Net::HTTPSuccess)
-        bool = true
-      elsif redirect?(response) # Check code, HTTPRedirection does not always work
-        if @follow_redirect
-          @warning = response.message
-          rlimit   = 0
-
-          while redirect?(response)
-            if rlimit >= redirect_limit
-              @exception = "Redirect limit exceeded"
-              break
-            end
-            redirect = URI.parse(response['location'])
-            redirect = uri + redirect if redirect.relative?
-            response = do_ping(redirect, port)
-            rlimit += 1
-          end
-
-          if response.is_a?(Net::HTTPSuccess)
-            bool = true
-          else
-            @warning   = nil
-            @exception ||= response.message
-          end
-
-        else
-          @exception = response.message
-        end
-      else
-        @exception ||= response.message
-      end
-
-      # There is no duration if the ping failed
-      @duration = Time.now - start_time if bool
-
-      bool
-    end
-
-    alias ping? ping
-    alias pingecho ping
-    alias follow_redirect? follow_redirect
-    alias uri host
-    alias uri= host=
-
-    private
-
-    def redirect?(response)
-      response && response.code.to_i >= 300 && response.code.to_i < 400
-    end
-
-    def do_ping(uri, port)
-      response = nil
-      proxy = uri.find_proxy || URI.parse("")
-
-      begin
-        uri_path = uri.path.empty? ? '/' : uri.path
-
-        headers = {}
-        headers["User-Agent"] = user_agent if user_agent
-
-        http = Net::HTTP::Proxy(proxy.host, proxy.port, proxy.user, proxy.password).new(uri.host, port)
-
-        http.open_timeout = timeout
-        http.read_timeout = timeout
-
-        @proxied = http.proxy?
-
-        if @get_request == true
-          request = Net::HTTP::Get.new(uri_path)
-        else
-          request = Net::HTTP::Head.new(uri_path)
-        end
-
-        if uri.scheme == 'https'
-          http.use_ssl = true
-          http.verify_mode = @ssl_verify_mode
-        end
-
-        response = http.start{ |h|
-          h.open_timeout = timeout
-          h.read_timeout = timeout
-          h.request(request)
-        }
-      rescue Exception => err
-        @exception = err.message
-      end
-
-      @code = response.code if response
-
-      response
-    end
-  end
-end
+require File.join(File.dirname(__FILE__), 'ping')
+require 'net/http'
+require 'net/https'
+require 'uri'
+require 'open-uri'
+
+# Force non-blocking Socket.getaddrinfo on Unix systems. Do not use on
+# Windows because it (ironically) causes blocking problems.
+unless File::ALT_SEPARATOR or RUBY_VERSION >= "1.9.3"
+  require 'resolv-replace'
+end
+
+# The Net module serves as a namespace only.
+module Net
+
+  # The Ping::HTTP class encapsulates methods for HTTP pings.
+  class Ping::HTTP < Ping
+
+    # By default an http ping will follow a redirect and give you the result
+    # of the final URI.  If this value is set to false, then it will not
+    # follow a redirect and will return false immediately on a redirect.
+    #
+    attr_accessor :follow_redirect
+
+    # The maximum number of redirects allowed. The default is 5.
+    attr_accessor :redirect_limit
+
+    # The user agent used for the HTTP request. The default is nil.
+    attr_accessor :user_agent
+
+    # OpenSSL certificate verification mode. The default is VERIFY_NONE.
+    attr_accessor :ssl_verify_mode
+
+    # Use GET request instead HEAD. The default is false.
+    attr_accessor :get_request
+
+    # was this ping proxied?
+    attr_accessor :proxied
+
+    # For unsuccessful requests that return a server error, it is
+    # useful to know the HTTP status code of the response.
+    attr_reader :code
+
+    # Creates and returns a new Ping::HTTP object. The default port is the
+    # port associated with the URI or 80. The default timeout is 5 seconds.
+    #
+    def initialize(uri=nil, port=nil, timeout=5)
+      @follow_redirect = true
+      @redirect_limit  = 5
+      @ssl_verify_mode = OpenSSL::SSL::VERIFY_NONE
+      @get_request     = false
+      @code            = nil
+
+      port ||= URI.parse(uri).port if uri
+      port ||= 80
+
+      @port = port
+
+      super(uri, port, timeout)
+    end
+
+    # Looks for an HTTP response from the URI passed to the constructor.
+    # If the result is a kind of Net::HTTPSuccess then the ping was
+    # successful and true is returned.  Otherwise, false is returned
+    # and the Ping::HTTP#exception method should contain a string
+    # indicating what went wrong.
+    #
+    # If the HTTP#follow_redirect accessor is set to true (which it is
+    # by default) and a redirect occurs during the ping, then the
+    # HTTP#warning attribute is set to the redirect message, but the
+    # return result is still true. If it's set to false then a redirect
+    # response is considered a failed ping.
+    #
+    # If no file or path is specified in the URI, then '/' is assumed.
+    # If no scheme is present in the URI, then 'http' is assumed.
+    #
+    def ping(host = @host)
+      super(host)
+      bool = false
+
+      # See https://bugs.ruby-lang.org/issues/8645
+      host = "http://#{host}" unless host.include?("http")
+
+      uri = URI.parse(host)
+
+      # A port provided here via the host argument overrides anything
+      # provided in constructor.
+      #
+      port = URI.split(host)[3] || URI.parse(host).port || @port
+      port = port.to_i
+
+      start_time = Time.now
+
+      response = do_ping(uri, port)
+
+      if response.is_a?(Net::HTTPSuccess)
+        bool = true
+      elsif redirect?(response) # Check code, HTTPRedirection does not always work
+        if @follow_redirect
+          @warning = response.message
+          rlimit   = 0
+
+          while redirect?(response)
+            if rlimit >= redirect_limit
+              @exception = "Redirect limit exceeded"
+              break
+            end
+            redirect = URI.parse(response['location'])
+            redirect = uri + redirect if redirect.relative?
+            response = do_ping(redirect, port)
+            rlimit += 1
+          end
+
+          if response.is_a?(Net::HTTPSuccess)
+            bool = true
+          else
+            @warning   = nil
+            @exception ||= response.message
+          end
+
+        else
+          @exception = response.message
+        end
+      else
+        @exception ||= response.message
+      end
+
+      # There is no duration if the ping failed
+      @duration = Time.now - start_time if bool
+
+      bool
+    end
+
+    alias ping? ping
+    alias pingecho ping
+    alias follow_redirect? follow_redirect
+    alias uri host
+    alias uri= host=
+
+    private
+
+    def redirect?(response)
+      response && response.code.to_i >= 300 && response.code.to_i < 400
+    end
+
+    def do_ping(uri, port)
+      response = nil
+      proxy = uri.find_proxy || URI.parse("")
+
+      begin
+        uri_path = uri.path.empty? ? '/' : uri.path
+
+        headers = {}
+        headers["User-Agent"] = user_agent if user_agent
+
+        http = Net::HTTP::Proxy(proxy.host, proxy.port, proxy.user, proxy.password).new(uri.host, port)
+
+        http.open_timeout = timeout
+        http.read_timeout = timeout
+
+        @proxied = http.proxy?
+
+        if @get_request == true
+          request = Net::HTTP::Get.new(uri_path)
+        else
+          request = Net::HTTP::Head.new(uri_path)
+        end
+
+        if uri.scheme == 'https'
+          http.use_ssl = true
+          http.verify_mode = @ssl_verify_mode
+        end
+
+        response = http.start{ |h|
+          h.open_timeout = timeout
+          h.read_timeout = timeout
+          h.request(request)
+        }
+      rescue Exception => err
+        @exception = err.message
+      end
+
+      @code = response.code if response
+
+      response
+    end
+  end
+end