SimplePortSniff 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 51a3f87c3d129c424023e6955746e6ce2da18868
+  data.tar.gz: de160ca0bd168e743bf1143e55f3fec93aed05e0
+SHA512:
+  metadata.gz: ec377d309bd55f3243c79ad2be4a497317c4ce7b76ff6d3b3046b0092c6369a14213cb327d91f67d39bb62474732c33b509f6dfc1c1b015335203409e59f1fab
+  data.tar.gz: 1b5e45a3f8aca011c2dc1275ac112f55da3d3588e28ad8f4f7d445fba55017be963108e7456d42a58036e5c3d03cfcfb1578c8fefc86ddfeeca0971beb99fda4

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Nicholas Sardo
+
+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,44 @@
+
+[![Gem Version](https://badge.fury.io/rb/PortSniff.svg)](https://badge.fury.io/rb/PortSniff)
+# SimplePortSniff
+Native Ruby naive port sniffer
+
+Input an IP and a range of ports as an array, and get back which of those ports are open or closed.
+
+## To use as a gem
+
+```
+gem install PortSniff
+```
+
+Then, in your source file:
+
+```
+require 'SimplePortSniff'
+
+ps = SimplePortSniff.new( 'google.com', [79,80,81] )
+puts s.sniff()
+```
+RETURNS:
+   ```
+    port 79 is closed
+    port 80 is open
+    port 81 is closed
+   ```
+    
+    
+## To work with the source files:
+
+### To Run:
+```
+cd into bin/ and type: ./simplePortSniff (the file is already chmod a+x)
+```
+
+### To Run Cucumber Tests:
+(requires Cucumber be installed...)
+```
+cd into the root directory of this project:
+ruby-port-sniff/
+
+then type:  cucumber
+```

data/bin/simplePortSniff

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+# Nicholas Sardo <ruby.code.artist@gmail.com>
+
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'simplePortSniff/simpleportsniff'
+
+
+s = SimplePortSniff.new('google.com', [79, 80, 81])
+puts s.sniff()

data/features/simplePortSniff.feature

@@ -0,0 +1,13 @@
+
+Feature: Sniff a port
+  In order to sniff a port
+  As a user
+  I want to sniff some ports
+
+  Scenario:
+    Given ip and ports are
+    | ip   | google.com   |
+    | ports| [79,80,81] |
+    When I enter the ip
+    And  I enter the ports
+    Then Then the result should be "port 79 is closed\nport 80 is open\nport 81 is closed"

data/features/step_definitions/simplePortSniff_steps.rb

@@ -0,0 +1,24 @@
+
+
+Given(/^ip and ports are$/) do |table|
+  # table is a Cucumber::MultilineArgument::DataTable
+  #puts table.raw
+  #puts table.raw[0][0]
+  #puts table.raw[0][1]
+  @table = table.raw
+end
+
+When(/^I enter the ip$/) do
+  @ip = @table[0][1].to_s
+end
+
+When(/^I enter the ports$/) do
+  #puts @table[1][1].class == String !!
+  @ports = eval(@table[1][1])
+end
+
+Then(/^Then the result should be "([^"]*)"$/) do |arg1|
+  @sps = Simpleportsniff.new(@ip.to_s, @ports )
+  rslt = @sps.sniff()
+  rslt == arg1
+end

data/features/support/env.rb

@@ -0,0 +1,4 @@
+# Nicholas Sardo <ruby.code.artist@gmail.com>
+$LOAD_PATH << File.expand_path( '../../../lib', __FILE__ )
+
+require 'simplePortSniff/simpleportsniff'

data/lib/simplePortSniff/simpleportsniff.rb

@@ -0,0 +1,61 @@
+require 'socket'
+
+class SimplePortSniff
+
+  def initialize( ip, ports )
+    @ip     = ip
+    @ports  = ports
+  end
+
+  # this function modified from original at: https://spin.atomicobject.com/2013/09/30/socket-connection-timeout-ruby/
+  def connect( host, port, timeout = 5 )
+    # Convert the passed host into structures the non-blocking calls
+    # can deal with
+    addr      = Socket.getaddrinfo(host, nil )
+    sockaddr  = Socket.pack_sockaddr_in( port, addr[0][3] )
+
+    Socket.new(Socket.const_get( addr[0][0]), Socket::SOCK_STREAM, 0 ).tap do |socket|
+      socket.setsockopt( Socket::IPPROTO_TCP, Socket::TCP_NODELAY, 1 )
+
+      begin
+        # Initiate the socket connection in the background. If it doesn't fail
+        # immediatelyit will raise an IO::WaitWritable (Errno::EINPROGRESS)
+        # indicating the connection is in progress.
+        socket.connect_nonblock( sockaddr )
+
+      rescue IO::WaitWritable
+        # IO.select will block until the socket is writable or the timeout
+        # is exceeded - whichever comes first.
+        if IO.select( nil, [socket], nil, timeout )
+          begin
+            # Verify there is now a good connection
+            socket.connect_nonblock( sockaddr )
+          rescue Errno::EISCONN
+            # Good news everybody, the socket is connected!
+            return "port #{port} is open"
+          rescue
+            # An unexpected exception was raised - the connection is no good.
+            socket.close
+            return "port #{port} is closed"
+            #raise
+          end
+        else
+          # IO.select returns nil when the socket is not ready before timeout
+          # seconds have elapsed
+          socket.close
+          return "port #{port} is closed"
+          #raise "Connection timeout"
+        end
+      end
+    end
+  end
+
+  def sniff()
+    rtn = []
+    @ports.each do |item|
+      rtn.push( connect( @ip, item, 1 ) )
+    end
+    return rtn.join("\n")
+  end
+
+end

data/lib/simpleportsniff.rb

@@ -0,0 +1,2 @@
+# Nicholas Sardo <ruby.code.artist@gmail.com>
+require 'simplePortSniff/simpleportsniff.rb'

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: SimplePortSniff
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Nicholas Sardo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-04-25 00:00:00.000000000 Z
+dependencies: []
+description: A simple, native, and naive, Ruby Port Sniffer that takes IP and Port
+  range as inputs
+email: nsardo@aol.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/simplePortSniff
+- features/simplePortSniff.feature
+- features/step_definitions/simplePortSniff_steps.rb
+- features/support/env.rb
+- lib/simplePortSniff/simpleportsniff.rb
+- lib/simpleportsniff.rb
+homepage: https://rubygems.org/gems/Simpleportsniff
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.11
+signing_key: 
+specification_version: 4
+summary: Basic native and naive Ruby Port Sniffer
+test_files: []