Informer 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Scott Burton
+
+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.rdoc

@@ -0,0 +1,35 @@
+= Informer
+
+Running Informer will watch something, formulate messages about it,  and report back somehow. It is useful for extremely simplified reporting the status of a host system.
+
+Informer is simple and extensible. New arbitrary watchers and reporters just need to be namespaced within the Watcher or Reporter module and respond to #report. See source for details.
+
+
+== Examples
+
+* Print the state of two processes, plus the current hostname and ip address for en1, to stdout
+    Informer.watch do
+      process "ruby"
+      process "irb", :handle => "Interactive Ruby"
+      hostname "en1"
+    end
+
+* Report whether ssh-agent is running on the LCD screen of a Rackable Systems Roamer ILOM device
+    informer = Informer.new("lcd")
+    informer.watchers << Watcher::Process.new("ssh-agent", :handle => "SSH Keychain Agent")
+    informer.report
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+  bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 Scott Burton. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,63 @@
+require 'rubygems'
+require 'rake'
+
+$LOAD_PATH << './lib'
+require 'informer'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "Informer"
+    gem.summary = %Q{Informer gathers info and shoots it over the wire}
+    gem.description = %Q{Informer is a flexible information gathering and reporting system.}
+    gem.email = "scottburton11@gmail.com"
+    gem.homepage = "http://github.com/scottburton11/informer"
+    gem.authors = ["Scott Burton"]
+    gem.executables = ["informer"]
+    gem.default_executable = "informer"
+  end
+
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+rescue LoadError
+  task :features do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "Informer #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/bin/informer

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+require 'lib/informer'
+
+Informer.watch do
+  process "ruby", :handle => "Ruby"
+  process "irb"
+  hostname "en1"
+end

data/features/hostname_watcher.feature

@@ -0,0 +1,13 @@
+Feature: The HostnameWatcher gathers the hostname and IP address, and reports back
+  In order to determine which host is reporting
+  As an Informant
+  I want a HostnameWatcher to gather the hostname and IP address of the host system
+
+  Scenario: Gather the hostname and IP
+    Given I have a HostnameWatcher
+    When it gathers info
+    Then it should have a hostname and IP address
+    And it should report the hostname and IP address as a message
+  
+  
+  

data/features/informer.feature

@@ -0,0 +1,10 @@
+Feature: Informant tells you what important stuff is happening
+  In order to protect revenue
+  As a System Administrator
+  I want to be informed about what is happening on my system
+  
+  Scenario: Just tell me the message
+    Given I am watching something
+    When the informer runs
+    Then it should report a message
+  

data/features/step_definitions/hostname_watcher_steps.rb

@@ -0,0 +1,12 @@
+Given /^I have a HostnameWatcher$/ do
+  @watcher = HostnameWatcher.new
+end
+
+Then /^it should have a hostname and IP address$/ do
+  @watcher.ip.should =~ %r|\d{1,3}.\d{1,3}.\d{1,3}.\d{1,3}|
+  @watcher.hostname.should =~ %r|(\w+).(\w+).(\w+)|
+end
+
+Then /^it should report the hostname and IP address as a message$/ do
+  pending
+end

data/features/step_definitions/informer_steps.rb

@@ -0,0 +1,11 @@
+When /^the informer runs$/ do
+  Informer.run
+end
+
+Then /^it should report a message$/ do
+  Then "it should report 1 message"
+end
+
+Then /^it should report (\d+) messages?$/ do |n|
+  Informer.messages.size.should eql(n.to_i)
+end

data/features/step_definitions/watcher_steps.rb

@@ -0,0 +1,21 @@
+Given /^I am watching something$/ do
+  @watcher = Watcher.new
+end
+
+Given /^I have a watcher$/ do
+  @watcher = Watcher.new
+end
+
+When /^the watcher gathers info$/ do
+  @watcher.gather
+end
+
+
+When /^it gathers info$/ do
+  When "the watcher gathers info"
+end
+
+
+Then /^it should have a message$/ do
+  @watcher.message.should be_kind_of(String)
+end

data/features/support/env.rb

@@ -0,0 +1,4 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../lib')
+require 'informer'
+
+require 'spec/expectations'

data/features/watcher.feature

@@ -0,0 +1,12 @@
+Feature: Watchers gather information and report back
+  In order to protect revenue
+  As a System Administrator
+  I want to watch something specific, and formulate a message about it
+
+  Scenario: A watcher gathers info and creates a message
+    Given I have a watcher
+    When the watcher gathers info
+    Then it should have a message
+  
+  
+  

data/lib/informer.rb

@@ -0,0 +1,64 @@
+$LOAD_PATH << './lib'
+
+require 'informer/basic_watcher'
+
+require 'informer/watcher/hostname'
+require 'informer/watcher/process'
+
+require 'informer/reporter/led'
+require 'informer/reporter/standard_output'
+
+class Informer
+  
+  attr_reader :watchers
+  
+  def initialize(reporter)
+    @reporter = get_reporter(reporter)
+    @watchers = []
+  end
+  
+  def messages
+    watchers.map {|watcher| watcher.report}
+  end
+  
+  def report
+    @reporter.report(messages)
+  end
+  
+  def self.watch(reporter = "standard_output", &block)
+    informer = Informer.new(reporter)
+    informer.instance_eval(&block)
+    informer.report
+  end
+  
+  private
+  
+  def get_reporter(reporter)
+    begin
+      Reporter.const_get("#{reporter.camelize}")
+    rescue NameError
+      puts "No reporter exists named #{reporter}. We'll use standard output instead."
+      Reporter::StandardOutput
+    end
+  end
+  
+  def method_missing(method, *args, &block)
+    begin
+      watcher = Watcher.const_get("#{method.to_s.camelize}")
+      @watchers << watcher.new(*args, &block)
+    rescue NameError => e
+      puts "No watcher named #{method.to_s}. Error was: #{e}"
+      super
+    end
+    
+  end
+  
+end
+
+
+
+class String
+  def camelize
+    self.split(/[^a-z0-9]/).map{|w|w.capitalize}.join("")
+  end
+end

data/lib/informer/basic_watcher.rb

@@ -0,0 +1,11 @@
+module Watcher
+  class BasicWatcher
+
+    attr_reader :message
+
+    def report
+      @message = "Superclass called"
+    end
+
+  end
+end

data/lib/informer/reporter/led.rb

@@ -0,0 +1,22 @@
+module Reporter
+  class Lcd
+    
+    LCD_DEV = "/dev/tty" # "/dev/ttyS1"
+    
+    def self.report(messages)
+      messages.each do |message|
+        display do |led|
+          led.write "LCD:\n#{message}\n"
+        end
+        sleep 3
+      end
+    end
+    
+    def self.display(&block)
+      File.open(LCD_DEV, "w+") do |f|
+        yield f
+      end
+    end
+    
+  end
+end

data/lib/informer/reporter/standard_output.rb

@@ -0,0 +1,9 @@
+module Reporter
+  class StandardOutput
+    
+    def self.report(messages)
+      puts messages
+    end
+    
+  end
+end

data/lib/informer/watcher/hostname.rb

@@ -0,0 +1,45 @@
+module Watcher
+  class Hostname < BasicWatcher
+
+    attr_reader :ip, :hostname
+
+    def initialize(interface = "eth0")
+      @interface = interface
+    end
+
+    def report
+      gather
+      message
+    end
+
+    def message
+      @message ||= "#{hostname}\n#{ip}"
+    end
+
+    protected
+
+    def gather
+      @ip = get_ip_address
+      @hostname = get_hostname
+    end
+
+    private
+
+    def get_hostname
+      `hostname`.chomp
+    end
+
+    def get_ip_address
+      ip_match.match(ifconfig).to_s
+    end
+
+    def ifconfig
+      `ifconfig #{@interface}`.chomp
+    end
+
+    def ip_match
+      %r|\d{1,3}.\d{1,3}.\d{1,3}.\d{1,3}|
+    end
+
+  end
+end

data/lib/informer/watcher/process.rb

@@ -0,0 +1,27 @@
+module Watcher
+  class Process < BasicWatcher
+    def initialize(process, options = {})
+      @process = process
+      @handle = options[:handle] || @process
+    end
+
+    def report
+      "#{@handle} is #{running? ? '' : 'not '}running"
+    end
+
+    private
+
+    def processes
+      `ps aux`.chomp
+    end
+
+    def process_match
+      %r|#{@process}|
+    end
+
+    def running?
+      process_match === processes
+    end
+
+  end
+end

data/spec/helpers/host_helpers.rb

@@ -0,0 +1,16 @@
+module HostHelpers
+  def ifconfig_eth0
+<<RUBY_HERE
+eth0      Link encap:Ethernet  HWaddr 00:0c:29:14:d1:e9  
+          inet addr:192.168.157.129  Bcast:192.168.157.255  Mask:255.255.255.0
+          inet6 addr: fe80::20c:29ff:fe14:d1e9/64 Scope:Link
+          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
+          RX packets:3436 errors:0 dropped:0 overruns:0 frame:0
+          TX packets:526 errors:0 dropped:0 overruns:0 carrier:0
+          collisions:0 txqueuelen:1000 
+          RX bytes:783465 (783.4 KB)  TX bytes:70731 (70.7 KB)
+RUBY_HERE
+
+    
+  end
+end

data/spec/helpers/process_helpers.rb

@@ -0,0 +1,107 @@
+module ProcessHelpers
+  
+  def ps_aux
+<<RUBY_HERE
+USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
+root         1  0.0  0.2   5236   576 ?        Ss   Oct27   0:01 /sbin/init
+root         2  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kthreadd]
+root         3  0.0  0.0      0     0 ?        S<   Oct27   0:00 [migration/0]
+root         4  0.0  0.0      0     0 ?        S<   Oct27   0:00 [ksoftirqd/0]
+root         5  0.0  0.0      0     0 ?        S<   Oct27   0:00 [watchdog/0]
+root         6  0.0  0.0      0     0 ?        S<   Oct27   0:00 [events/0]
+root         7  0.0  0.0      0     0 ?        S<   Oct27   0:00 [khelper]
+root         8  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kstop/0]
+root         9  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kintegrityd/0]
+root        10  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kblockd/0]
+root        11  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kacpid]
+root        12  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kacpi_notify]
+root        13  0.0  0.0      0     0 ?        S<   Oct27   0:00 [cqueue]
+root        14  0.0  0.0      0     0 ?        S<   Oct27   0:17 [ata/0]
+root        15  0.0  0.0      0     0 ?        S<   Oct27   0:00 [ata_aux]
+root        16  0.0  0.0      0     0 ?        S<   Oct27   0:00 [ksuspend_usbd]
+root        17  0.0  0.0      0     0 ?        S<   Oct27   0:00 [khubd]
+root        18  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kseriod]
+root        19  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kmmcd]
+root        20  0.0  0.0      0     0 ?        S<   Oct27   0:00 [btaddconn]
+root        21  0.0  0.0      0     0 ?        S<   Oct27   0:00 [btdelconn]
+root        22  0.0  0.0      0     0 ?        S    Oct27   0:00 [pdflush]
+root        23  0.0  0.0      0     0 ?        S    Oct27   0:00 [pdflush]
+root        24  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kswapd0]
+root        25  0.0  0.0      0     0 ?        S<   Oct27   0:00 [aio/0]
+root        26  0.0  0.0      0     0 ?        S<   Oct27   0:00 [ecryptfs-kthrea]
+root        29  0.0  0.0      0     0 ?        S<   Oct27   0:00 [pciehpd]
+root        30  0.0  0.0      0     0 ?        S<   Oct27   0:00 [scsi_eh_0]
+root        31  0.0  0.0      0     0 ?        S<   Oct27   0:00 [scsi_eh_1]
+root        32  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kstriped]
+root        33  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kmpathd/0]
+root        34  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kmpath_handlerd]
+root        35  0.0  0.0      0     0 ?        S<   Oct27   0:00 [ksnapd]
+root        36  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kondemand/0]
+root        37  0.0  0.0      0     0 ?        S<   Oct27   0:00 [krfcommd]
+root       220  0.0  0.0      0     0 ?        S<   Oct27   0:00 [mpt_poll_0]
+root       334  0.0  0.0      0     0 ?        S<   Oct27   0:00 [scsi_eh_2]
+root       753  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kjournald]
+root       873  0.0  0.1  16660   368 ?        S<s  Oct27   0:00 /sbin/udevd --daemon
+root      1056  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kgameportd]
+root      1189  0.0  0.0      0     0 ?        S<   Oct27   0:00 [kpsmoused]
+root      2344  0.0  0.1   3944   488 tty4     Ss+  Oct27   0:00 /sbin/getty 38400 tty4
+root      2345  0.0  0.1   3944   488 tty5     Ss+  Oct27   0:00 /sbin/getty 38400 tty5
+root      2346  0.0  0.2   4024   608 ?        Ss   Oct27   0:00 /bin/sh /etc/init.d/rc 2
+root      2351  0.0  0.1   3944   488 tty2     Ss+  Oct27   0:00 /sbin/getty 38400 tty2
+root      2355  0.0  0.1   3944   488 tty3     Ss+  Oct27   0:00 /sbin/getty 38400 tty3
+root      2356  0.0  0.1   3944   488 tty6     Ss+  Oct27   0:00 /sbin/getty 38400 tty6
+root      2418  0.0  0.2   3944   576 ?        Ss   Oct27   0:00 /usr/sbin/acpid -c /etc/acpi/events -s /var/run/acpid.socket
+syslog    2452  0.0  0.2  12376   560 ?        Ss   Oct27   0:00 /sbin/syslogd -u syslog
+root      2470  0.0  0.1   8204   460 ?        S    Oct27   0:00 /bin/dd bs 1 if /proc/kmsg of /var/run/klogd/kmsg
+klog      2472  0.0  0.1   6612   468 ?        Ss   Oct27   0:00 /sbin/klogd -P /var/run/klogd/kmsg
+103       2491  0.0  0.3  21388   944 ?        Ss   Oct27   0:00 /bin/dbus-daemon --system
+lp        2700  0.0  0.1  12432   344 ?        Ss   Oct27   0:00 /usr/sbin/lpd -s
+root      2761  0.0  0.2  66292   648 ?        Ss   Oct27   0:00 /usr/sbin/winbindd
+root      2783  0.0  0.2  66292   552 ?        S    Oct27   0:00 /usr/sbin/winbindd
+root      2791  0.0  1.2  41912  3028 ?        Ssl  Oct27   0:01 /usr/sbin/console-kit-daemon
+avahi     2979  0.0  0.5  31884  1344 ?        Ss   Oct27   0:00 avahi-daemon: running [minibuntu.local]
+avahi     2980  0.0  0.1  31764   436 ?        Ss   Oct27   0:00 avahi-daemon: chroot helper
+daemon    3030  0.0  0.1  16524   432 ?        Ss   Oct27   0:00 /usr/sbin/atd
+root      3055  0.0  0.3  19972   744 ?        Ss   Oct27   0:00 /usr/sbin/cron
+root      3081  0.0  0.2   4024   636 ?        S    Oct27   0:00 /bin/sh /etc/rc2.d/S99rc.local start
+root      3085  0.0  0.2   4024   556 ?        S    Oct27   0:00 /bin/sh -e /etc/rc.local
+scott     3086  0.0  0.3  41904   952 ?        S    Oct27   0:00 su - scott -c startx
+scott     3094  0.0  0.4  10864  1096 ?        S    Oct27   0:00 /bin/bash /usr/bin/startx
+scott     3125  0.0  0.2  15384   732 ?        S    Oct27   0:00 xinit /etc/X11/xinit/xinitrc -- /etc/X11/xinit/xserverrc :0 -auth /tmp/serverauth.zhFytCmJHA
+root      3129  0.0  7.8 113644 19372 tty7     Ss+  Oct27   0:04 /usr/bin/X11/X -nolisten tcp
+scott     3285  0.0  1.1 147216  2776 ?        S    Oct27   0:00 x-session-manager
+scott     3300  0.0  2.5  61232  6356 ?        S    Oct27   0:00 xterm
+scott     3309  0.0  0.0      0     0 ?        Z    Oct27   0:00 [sh] <defunct>
+scott     3312  0.0  0.2  35940   604 ?        Ss   Oct27   0:00 /usr/bin/ssh-agent /usr/bin/dbus-launch --exit-with-session x-session-manager
+scott     3315  0.0  0.2  23824   608 ?        S    Oct27   0:00 /usr/bin/dbus-launch --exit-with-session x-session-manager
+scott     3316  0.0  0.2  21256   616 ?        Ss   Oct27   0:00 //bin/dbus-daemon --fork --print-pid 5 --print-address 7 --session
+scott     3317  0.0  1.3  20856  3316 pts/0    Ss   Oct27   0:00 bash
+scott     3331  0.0  0.5  26536  1256 ?        S    Oct27   0:00 /usr/lib/xfconfd
+scott     3343  0.0  3.9 146812  9572 ?        S    Oct27   0:02 xfwm4
+scott     3344  0.0  0.9 121080  2432 ?        S    Oct27   0:00 xfsettingsd
+scott     3346  0.0  1.3 132040  3228 ?        S    Oct27   0:00 xfce4-panel
+scott     3348  0.0  1.3 155268  3204 ?        S    Oct27   0:00 Thunar --daemon
+scott     3350  0.0  6.3 218876 15500 ?        S    Oct27   0:01 xfdesktop
+scott     3365  0.0  1.2 154408  3112 ?        S    Oct27   0:00 xfce4-settings-helper
+scott     3380  0.0  0.3  17544   888 ?        S    Oct27   0:00 /usr/lib/gamin/gam_server
+105      11449  0.0  1.5  35392  3808 ?        Ss   Oct27   0:01 /usr/sbin/hald
+root     11450  0.0  0.4  15816  1212 ?        S    Oct27   0:00 hald-runner
+root     11481  0.0  0.8  28484  2032 ?        S    Oct27   0:00 hald-addon-input: Listening on /dev/input/event1 /dev/input/event0 /dev/input/event3
+root     11544  0.0  0.8  28484  2044 ?        S    Oct27   0:01 hald-addon-storage: polling /dev/sr0 (every 2 sec)
+root     11547  0.0  0.8  28484  2020 ?        S    Oct27   0:00 hald-addon-storage: no polling on /dev/fd0 because it is explicitly disabled
+105      11552  0.0  0.8  32392  2016 ?        S    Oct27   0:00 hald-addon-acpi: listening on acpid socket /var/run/acpid.socket
+root     11629  0.0  0.0      0     0 ?        S<   Oct27   0:00 [vmhgfs]
+root     11647  0.0  0.0      0     0 ?        S<   Oct27   0:00 [vmmemctl]
+root     11761  0.0  0.5  23112  1440 ?        Ss   Oct27   0:19 /usr/lib/vmware-tools/sbin64/vmware-guestd --background /var/run/vmware-guestd.pid
+root     29894  0.0  0.2   6488   676 ?        Ss   12:36   0:00 dhclient3 -e IF_METRIC=100 -pf /var/run/dhclient.eth0.pid -lf /var/lib/dhcp3/dhclient.eth0.leases eth0
+root     29960  0.0  0.8  18964  2020 pts/0    S+   12:37   0:00 -bash
+root     30190  0.0  0.4  48940  1204 ?        Ss   12:39   0:00 /usr/sbin/sshd
+root     30211  0.0  1.3  80804  3372 ?        Ss   12:39   0:00 sshd: scott [priv]
+scott    30219  0.0  0.7  80804  1740 ?        S    12:39   0:00 sshd: scott@pts/1
+scott    30235  0.0  1.4  20860  3672 pts/1    Ss   12:39   0:00 -bash
+root     30268  0.0  0.8  18992  2040 pts/1    S    12:39   0:00 -bash
+root     31641  2.0  0.4  15172  1136 pts/1    R+   14:00   0:00 ps aux
+RUBY_HERE
+  end
+  
+end

data/spec/hostname_spec.rb

@@ -0,0 +1,57 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Watcher::Hostname do
+  
+  include HostHelpers
+  
+  before(:each) do
+    @watcher = Watcher::Hostname.new
+  end
+  
+  describe "gathering info on the host system" do
+    before(:each) do
+      @watcher.should_receive(:get_ip_address).and_return("192.168.157.129")
+      @watcher.should_receive(:get_hostname).and_return("localhost")
+    end
+    
+    it "reports formatted text with the IP and hostname" do
+      @watcher.report.should eql("localhost\n192.168.157.129")
+    end
+  end
+  
+  describe "private methods" do
+    describe "get_ip_address method" do
+      before(:each) do
+        @watcher.should_receive(:ifconfig).and_return(ifconfig_eth0)
+      end
+      it "calls ifconfig with a system call" do
+        @watcher.send(:get_ip_address).should eql("192.168.157.129")
+      end
+    end
+
+    describe "ifconfig method" do
+      
+      before(:each) do
+        @watcher.should_receive(:`).with("ifconfig eth0").and_return(ifconfig_eth0)
+      end
+      
+      it "calls ifconfig with a system call" do
+        @watcher.send(:ifconfig).should eql(ifconfig_eth0.chomp)
+      end
+      
+    end
+
+    describe "get_hostname method" do
+
+      before(:each) do
+        @watcher.should_receive(:`).with("hostname").and_return("localhost")
+      end
+      
+      it "calls hostname with a system call" do
+        @watcher.send(:get_hostname).should eql("localhost")
+      end
+
+    end
+    
+  end
+end

data/spec/informer_spec.rb

@@ -0,0 +1 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')

data/spec/process_spec.rb

@@ -0,0 +1,58 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Watcher::Process do
+
+  include ProcessHelpers
+  
+  before(:each) do
+    @watcher = Watcher::Process.new('process-name', :handle => 'Process Handle')
+  end
+  
+  describe "gathering info about the host system" do
+    
+    describe "when the process is running" do
+      
+      before(:each) do
+        @watcher.should_receive(:running?).and_return(true)
+      end
+      
+      it "reports the process label and 'is running'" do
+        @watcher.report.should eql("Process Handle is running")
+      end
+      
+    end
+    
+    describe "when the process isn't running" do
+      
+      before(:each) do
+        @watcher.should_receive(:running?).and_return(false)
+      end
+      
+      it "reports the process label and 'is not running'" do
+        @watcher.report.should eql("Process Handle is not running")
+      end
+      
+    end
+    
+    describe "privately" do
+      
+      it "calls 'ps aux' with a system call" do
+        @watcher.should_receive(:`).with("ps aux").and_return(ps_aux)
+        @watcher.send(:processes).should eql(ps_aux.chomp)
+      end
+      
+      it "says that :running? is true when the process exists" do
+        @watcher.should_receive(:processes).and_return("process-1\nprocess-2\nprocess-name")
+        @watcher.should be_running
+      end
+      
+      it "says that :running? is false when the process doesn't exist" do
+        @watcher.should_receive(:processes).and_return("process-1\nprocess-2")
+        @watcher.should_not be_running
+      end
+      
+    end
+    
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'Informer'
+require 'spec'
+require 'spec/autorun'
+require 'helpers/host_helpers'
+require 'helpers/process_helpers'
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: Informer
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Scott Burton
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-29 00:00:00 -07:00
+default_executable: informer
+dependencies: []
+
+description: Informer is a flexible information gathering and reporting system.
+email: scottburton11@gmail.com
+executables: 
+- informer
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- bin/informer
+- features/hostname_watcher.feature
+- features/informer.feature
+- features/step_definitions/hostname_watcher_steps.rb
+- features/step_definitions/informer_steps.rb
+- features/step_definitions/watcher_steps.rb
+- features/support/env.rb
+- features/watcher.feature
+- lib/informer.rb
+- lib/informer/basic_watcher.rb
+- lib/informer/reporter/led.rb
+- lib/informer/reporter/standard_output.rb
+- lib/informer/watcher/hostname.rb
+- lib/informer/watcher/process.rb
+- spec/helpers/host_helpers.rb
+- spec/helpers/process_helpers.rb
+- spec/hostname_spec.rb
+- spec/informer_spec.rb
+- spec/process_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/scottburton11/informer
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Informer gathers info and shoots it over the wire
+test_files: 
+- spec/helpers/host_helpers.rb
+- spec/helpers/process_helpers.rb
+- spec/hostname_spec.rb
+- spec/informer_spec.rb
+- spec/process_spec.rb
+- spec/spec_helper.rb