knoc-knoc 0.0.1

data/.gitignore

@@ -0,0 +1,20 @@
+# Files
+*.swp
+*.swo
+*.jpg
+.DS_Store
+.rvmrc
+.bundle/
+
+# Dir
+tmp/
+coverage/
+scratch_directory/
+rdoc/
+pkg/
+doc/
+gems/
+
+*.gem
+.yardoc
+

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,17 @@
+PATH
+  remote: .
+  specs:
+    knoc-knoc (0.0.1)
+      net-ping (>= 1.3.7)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    net-ping (1.3.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  knoc-knoc!
+  net-ping (>= 1.3.7)

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 lex148
+
+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.markdown

@@ -0,0 +1,31 @@
+# knoc-knoc, a gem to tell you who is there
+
+KnocKnoc will scan your network and tell you who is on it.
+It will tell you when someone new arrives and when someone leaves
+
+##About KnocKnoc
+
+KnocKnoc has two modes live and monitor. 
+
+Monitor mode scans your network in the background. if you ask KnocKnoc whos there in monitor mode, it will only tell you about who it knows about right then.
+ 
+Live mode only scans when you ask about the network. when in live mode you are guaranteed a fill list of people on your network, however you will have to wait for it.
+
+###Switching Modes
+
+- KnocKnoc::mode = KnocKnoc::WatchmanMonitor
+- KnocKnoc::mode = KnocKnoc::WatchmanLive
+
+
+##Using KnocKnoc
+
+To use KnocKnoc you ask it who is there
+
+require 'knoc-knoc'
+
+- KnocKnoc::whos_there => [list of people on your network]
+- KnocKnoc::whos_new => [list of the new people on your network]
+- KnocKnoc::whos_left => [list of the people that have left your network]
+
+
+

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+desc "Open an irb session preloaded with this library"
+task :console do
+    sh "irb -rubygems -r ./lib/knoc-knoc.rb"
+end
+
+

data/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+:patch: 0
+:major: 0
+:minor: 1
+

data/knoc-knoc.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+#require "knoc-knoc/version"
+require File.expand_path("../lib/knoc-knoc/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "knoc-knoc"
+  s.version     = KnocKnoc::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Lex Childs"]
+  s.email       = ["lex@childs.me"]
+  s.homepage    = %q{http://github.com/lex148/knoc-knoc}
+  s.summary     = %q{A library to tell you who is there.}
+
+
+  s.rubyforge_project = "knoc-knoc"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.add_dependency 'net-ping', ">= 1.3.7"
+
+end

data/lib/knoc-knoc.rb

@@ -0,0 +1,42 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'net/ping'
+require 'socket'
+
+require File.dirname(__FILE__) + '/knoc-knoc/host'
+require File.dirname(__FILE__) + '/knoc-knoc/watchman'
+require File.dirname(__FILE__) + '/knoc-knoc/watchman_live'
+require File.dirname(__FILE__) + '/knoc-knoc/watchman_monitor'
+
+module KnocKnoc
+  module_function
+
+  def mode
+    @watchman.class
+  end
+
+  def mode= value
+    if value.class == Class
+      @watchman.cleanup
+      @watchman = value.new
+    end
+  end
+
+  #set the default mode
+  @watchman = WatchmanMonitor.new
+  #@watchman = WatchmanLive.new
+
+  def whos_there
+    @watchman.whos_there
+  end
+
+  def whos_new
+    @watchman.whos_new
+  end
+
+  def whos_left
+    @watchman.whos_left
+  end
+
+
+end

data/lib/knoc-knoc/host.rb

@@ -0,0 +1,32 @@
+module KnocKnoc
+
+  class Host
+
+    #@ip, @hostname, @mac = nil, nil, nil
+    attr_reader :ip, :hostname, :mac
+
+    def initialize(address)
+      @ip = address
+      @hostname = get_hostname(address)
+      @mac = get_mac(address)
+    end
+
+
+    private 
+
+    def get_hostname ip
+      Socket::getaddrinfo(ip,nil)[0][2]
+    end
+
+    def get_mac ip
+      mac = /([a-zA-Z0-9]+:)+([a-zA-Z0-9]+)/.match(`arp #{ip}`).to_s
+      mac = mac.split /:/
+      mac = mac.map{ |p| '%02s' % p }
+      mac = mac.map{ |p| p.gsub(' ', '0' ) }
+      mac = mac.join(':')
+      mac.upcase
+    end
+
+  end
+
+end

data/lib/knoc-knoc/version.rb

@@ -0,0 +1,3 @@
+module KnocKnoc
+    VERSION = "0.0.1"
+end

data/lib/knoc-knoc/watchman.rb

@@ -0,0 +1,83 @@
+module KnocKnoc
+
+  class Watchman
+
+    attr_reader :whos_there, :whos_left, :whos_new
+
+    def self.local_ip
+      orig, Socket.do_not_reverse_lookup = Socket.do_not_reverse_lookup, true  # turn off reverse DNS resolution temporarily
+      UDPSocket.open do |s|
+        s.connect '172.0.0.1', 1
+        s.addr.last
+      end
+    ensure
+      Socket.do_not_reverse_lookup = orig
+    end
+
+    SUBNET = /([0-9]+\.){3}/.match(self.local_ip).to_s
+
+    def initialize
+      @whos_there, @whos_new, @whos_left = [], [], []
+    end
+
+    def whos_new
+      list = @whos_new
+      @whos_new = []
+      list
+    end
+
+    def whos_left
+      list = @whos_left
+      @whos_left = []
+      list
+    end
+
+    def refresh_lists
+      current_ips = self.class.ping_all
+      whos_there_ips = @whos_there.map{|h| h.ip }
+      new_ips = current_ips - whos_there_ips
+      left_ips = whos_there_ips - current_ips
+      self.update_new_ips new_ips
+      self.update_whos_left left_ips
+    end
+
+    def update_new_ips new_ips
+      new_ips.each do |ip|
+        host = Host.new(ip)
+        @whos_there.push host
+        @whos_new.push host
+      end
+    end
+   
+    def update_whos_left left_ips
+      left_ips.each do |ip|
+        host = @whos_there.find{ |x| x.ip == ip }
+        @whos_there = @whos_there - [host]
+        @whos_left.push host
+      end
+    end
+
+    def self.ping_all
+      threads, list = [], []
+      (1..254).select do |num|
+        threads << Thread.new(num) do |n|
+          ip = SUBNET + n.to_s
+          if Net::Ping::External.new(ip, 1).ping?
+          #if ping ip
+            list.push( ip )
+          end
+        end
+      end
+      threads.each { |th| th.join() }
+      list
+    end
+
+    def self.ping ip
+      !!(/1 received/.match(`ping #{ip} -c 1 -w 1`))
+    end
+
+    def cleanup
+    end
+
+  end
+end

data/lib/knoc-knoc/watchman_live.rb

@@ -0,0 +1,31 @@
+module KnocKnoc
+
+  class WatchmanLive < Watchman 
+
+    def initialize
+      super
+      Thread.new() do
+        refresh_lists
+      end
+    end
+
+    def whos_new
+      refresh_lists
+      super
+    end
+
+    def whos_left
+      refresh_lists
+      super
+    end
+    
+    def whos_there
+      refresh_lists
+      super
+    end
+
+    def cleanup
+    end
+
+  end
+end

data/lib/knoc-knoc/watchman_monitor.rb

@@ -0,0 +1,32 @@
+module KnocKnoc
+
+  class WatchmanMonitor < Watchman
+
+    def initialize
+      super
+      @running = true
+      #run the refresh_lists once before 
+      #starting the set interval
+      Thread.new() do 
+        self.refresh_lists
+        self.repeat_every(30) do 
+          self.refresh_lists
+        end
+      end
+    end
+
+    def repeat_every(interval, &block)
+      while @running 
+        start_time = Time.now
+        Thread.new(&block).join
+        elapsed = Time.now - start_time
+        sleep([interval - elapsed, 0].max)
+      end
+    end
+
+    def cleanup
+      @running = false
+    end
+
+  end
+end

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification 
+name: knoc-knoc
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Lex Childs
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-15 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: net-ping
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 21
+        segments: 
+        - 1
+        - 3
+        - 7
+        version: 1.3.7
+  type: :runtime
+  version_requirements: *id001
+description: 
+email: 
+- lex@childs.me
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION.yml
+- knoc-knoc.gemspec
+- lib/knoc-knoc.rb
+- lib/knoc-knoc/host.rb
+- lib/knoc-knoc/version.rb
+- lib/knoc-knoc/watchman.rb
+- lib/knoc-knoc/watchman_live.rb
+- lib/knoc-knoc/watchman_monitor.rb
+has_rdoc: true
+homepage: http://github.com/lex148/knoc-knoc
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: knoc-knoc
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A library to tell you who is there.
+test_files: []
+