vidibus-sysinfo 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+pkg/*
+*.gem
+.bundle
+rdoc
+coverage

data/Gemfile

@@ -0,0 +1,4 @@
+source :gemcutter
+
+# Specify your gem's dependencies in vidibus-sysinfo.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,33 @@
+PATH
+  remote: .
+  specs:
+    vidibus-sysinfo (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    rake (0.8.7)
+    relevance-rcov (0.9.2.1)
+    rr (1.0.2)
+    rspec (2.0.1)
+      rspec-core (~> 2.0.1)
+      rspec-expectations (~> 2.0.1)
+      rspec-mocks (~> 2.0.1)
+    rspec-core (2.0.1)
+    rspec-expectations (2.0.1)
+      diff-lcs (>= 1.1.2)
+    rspec-mocks (2.0.1)
+      rspec-core (~> 2.0.1)
+      rspec-expectations (~> 2.0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (>= 1.0.0)
+  rake
+  relevance-rcov
+  rr
+  rspec (~> 2.0.0.beta.20)
+  vidibus-sysinfo!

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Andre Pankratz
+
+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,106 @@
+= Vidibus::Sysinfo
+
+Allows reading various system information.
+
+
+== Installation
+
+Add the dependency to the Gemfile of your application:
+
+  gem "vidibus-sysinfo"
+
+Then call bundle install on your console.
+
+
+== System requirements
+
+This gem uses various tools to obtain system data. On Debian Lenny, installing
+those tools should be simple:
+
+  apt-get install sysstat vnstat
+  vnstat -u -i eth0
+
+
+== Usage
+
+=== CPU cores
+
+To get the number of CPU cores, call
+
+  Vidibus::Sysinfo.core
+  # => 8
+
+
+=== CPU utilization
+
+To get CPU utilization in percent, call
+
+  Vidibus::Sysinfo.cpu
+  # => 18.4 # percent
+
+
+=== System load
+
+The system load value is divided by the number of CPU cores.
+To get the system load, call
+
+  Vidibus::Sysinfo.load
+  # => 0.39
+
+
+=== Monthly traffic
+
+To get the total traffic of this month in gigabytes, call
+
+  Vidibus::Sysinfo.traffic
+  # => 7992.15 # gigabytes
+
+
+=== Currently used bandwidth
+
+To get the currently used bandwidth in MBit/s, call
+
+  Vidibus::Sysinfo.bandwidth
+  # => 38.71 # MBit/s
+
+Bandwidth detection is performed by analyzing the output of /proc/net/dev.
+To get the amount of traffic in a certain timespan, the analyzer gets
+called twice and the delta of the two results is the traffic.
+
+By default, bandwidth detection only waits one second, thus the results
+will be quite volatile. To get a more accurate result, you can provide
+an optional argument:
+
+  Vidibus::Sysinfo.bandwidth(10)
+  # => 33.28 # MBit/s
+
+
+=== Consumed storage
+
+To get the consumed storage of the main device in gigabytes, call
+
+  Vidibus::Sysinfo.storage
+  # => 647.89 # gigabytes
+
+
+=== Used memory
+
+To get the currently used memory in megabytes, call
+
+  Vidibus::Sysinfo.memory
+  # => 3281.38 # megabytes
+
+This will ignore memory used for system caching.
+
+
+=== Used swap
+
+To get the currently used swap in megabytes, call
+
+  Vidibus::Sysinfo.swap
+  # => 0.0 # megabytes
+
+
+== Copyright
+
+Copyright (c) 2011 Andre Pankratz. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,20 @@
+require "bundler"
+require "rake/rdoctask"
+require "rspec"
+require "rspec/core/rake_task"
+Bundler::GemHelper.install_tasks
+
+Rspec::Core::RakeTask.new(:rcov) do |t|
+  t.pattern = "spec/**/*_spec.rb"
+  t.rcov = true
+  t.rcov_opts = ["--exclude", "^spec,/gems/"]
+end
+
+Rake::RDocTask.new do |rdoc|
+  require File.expand_path("../lib/vidibus/sysinfo/version.rb", __FILE__)
+  rdoc.rdoc_dir = "rdoc"
+  rdoc.title = "vidibus-sysinfo #{Vidibus::Sysinfo::VERSION}"
+  rdoc.rdoc_files.include("README*")
+  rdoc.rdoc_files.include("lib/**/*.rb")
+  rdoc.options << "--charset=utf-8"
+end

data/lib/vidibus/sysinfo/bandwidth.rb

@@ -0,0 +1,48 @@
+module Vidibus
+  module Sysinfo
+
+    # Returns currently used bandwith in MBit/s.
+    #
+    # Analyzes /proc/net/dev
+    #
+    module Bandwidth
+      extend Base
+
+      class << self
+        def command
+          "cat /proc/net/dev | grep eth0:"
+        end
+
+        # Provide seconds to sleep between first and second call.
+        # The higher the seconds, the more accurate are the results.
+        def call(seconds = 1)
+          values = []
+          2.times do
+            output, error = perform(command)
+            values << respond(output, error)
+            sleep(seconds) unless values.size > 1
+          end
+          megs = values[1] - values[0]
+          mbits = (megs*8)/seconds
+          round(mbits)
+        end
+
+        # Returns sum of transmitted and received bytes in megabytes.
+        def parse(output)
+          if output.match(/eth0\:([\d\s]+)/)
+            numbers = $1.split(/\s+/)
+            received = numbers[0].to_i
+            transmitted = numbers[8].to_i
+            megabytes(received + transmitted)
+          end
+        end
+
+        def explain(error)
+          if error.match("No such file or directory")
+            return "This system does not provide /proc/net/dev"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vidibus/sysinfo/base.rb

@@ -0,0 +1,72 @@
+module Vidibus
+  module Sysinfo
+
+    class CallError < StandardError; end
+    class OutputError < StandardError; end
+    class ParseError < StandardError; end
+
+    # Provides common methods.
+    module Base
+
+      def call
+        output, error = perform(command)
+        respond(output, error)
+      end
+
+      def explain(error); end
+
+      private
+
+      def perform(cmd)
+        response = nil
+        Open3.popen3(cmd) do |stdin, stdout, stderr|
+          response = [stdout.read, stderr.read]
+        end
+        response
+      end
+
+      def respond(output, error)
+        if error and error != ""
+          reason = explain(error) || open3_reason(error) || error
+          raise CallError.new("Failed to call #{self}:\n- #{reason}")
+        end
+
+        unless output
+          raise OutputError.new("Result from call of #{self} is empty")
+        end
+
+        parse(output) or
+          raise ParseError.new("Result from call of #{self} could not be parsed: #{output.strip}")
+      end
+
+      def open3_reason(error)
+        if error.match("in `popen3'")
+          "the command '#{command}' is not available or this program is not allowed to call it"
+        end
+      end
+
+      # Rounds float with given precision.
+      def round(float, precision = 2)
+        m = 10**precision
+        (float.to_f*m).round.to_f/m
+      end
+
+      # Converts given amount from unit to megabytes.
+      def megabytes(value, unit = "B")
+        value = value.to_f
+        case unit
+          when "B"      : value /= 1048576 # bytes
+          when "K", "KB": value /= 1024    # kiloytes
+          when "G", "GB": value *= 1024    # gigabytes
+          when "T", "TB": value *= 1048576 # terabytes
+        end
+        round(value)
+      end
+
+      # Converts given amount from unit to gigabytes.
+      def gigabytes(value, unit = "B")
+        round(megabytes(value, unit) / 1024)
+      end
+    end
+  end
+end

data/lib/vidibus/sysinfo/core.rb

@@ -0,0 +1,30 @@
+module Vidibus
+  module Sysinfo
+
+    # Returns number of cpu cores on this system.
+    #
+    # Analyzes /proc/cpuinfo
+    #
+    module Core
+      extend Base
+
+      class << self
+        def command
+          "cat /proc/cpuinfo | grep processor | wc -l"
+        end
+
+        def parse(output)
+          if output.match(/\d+/)
+            output.to_i
+          end
+        end
+
+        def explain(error)
+          if error.match("No such file or directory")
+            return "This system does not provide /proc/cpuinfo"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vidibus/sysinfo/cpu.rb

@@ -0,0 +1,34 @@
+module Vidibus
+  module Sysinfo
+
+    # Returns CPU utilization in percent.
+    #
+    # Calls `mpstat`
+    #
+    # mpstat is part of the "systat" tools for Linux.
+    # Installation on Debian:
+    #   apt-get install sysstat
+    #
+    module Cpu
+      extend Base
+
+      class << self
+        def command
+          "mpstat 5 1 | grep Average:"
+        end
+
+        def parse(output)
+          if output.match(/([\d\.]+)\s+[^\s]+$/)
+            round(100.0 - $1.to_f)
+          end
+        end
+
+        def explain(error)
+          if error.match("mpstat: command not found")
+            return "mpstat is not installed. On Debian, you can install it with 'apt-get install sysstat'"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vidibus/sysinfo/load.rb

@@ -0,0 +1,26 @@
+module Vidibus
+  module Sysinfo
+
+    # Returns system load, divided by number of CPU cores.
+    #
+    # Calls `uptime`
+    #
+    module Load
+      extend Base
+
+      class << self
+        def command
+          "uptime"
+        end
+
+        def parse(output)
+          if output.match(/load average:\s+(\d+(?:\.\d+)?)/)
+            value = $1.to_f
+            cores = Core.call
+            round(value/cores)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vidibus/sysinfo/memory.rb

@@ -0,0 +1,27 @@
+module Vidibus
+  module Sysinfo
+
+    # Returns used memory in megabytes.
+    #
+    # Calls `free`
+    #
+    module Memory
+      extend Base
+
+      class << self
+        def command
+          "free -m | grep Mem:"
+        end
+
+        def parse(output)
+          if output.match(/^Mem:\s+([\d\s]+)$/)
+            numbers = $1.split(/\s+/)
+            used = numbers[1].to_i
+            cached = numbers[5].to_i
+            used - cached
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vidibus/sysinfo/storage.rb

@@ -0,0 +1,28 @@
+module Vidibus
+  module Sysinfo
+
+    # Returns consumed storage in gigabytes.
+    #
+    # Calls `df`
+    #
+    module Storage
+      extend Base
+
+      class << self
+        def command
+          "df -h"
+        end
+
+        def parse(output)
+          device = /(?:[\/a-z0-9]+)/
+          size = /\s+([\d\.]+)(K|M|G|T)\i?/
+          if output.match(/#{device}#{size}#{size}/m)
+            amount = $3.to_f
+            unit = $4
+            gigabytes(amount, unit)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vidibus/sysinfo/swap.rb

@@ -0,0 +1,25 @@
+module Vidibus
+  module Sysinfo
+
+    # Returns used swap in megabytes.
+    #
+    # Calls `free`
+    #
+    module Swap
+      extend Base
+
+      class << self
+        def command
+          "free -m | grep Swap:"
+        end
+
+        def parse(output)
+          if output.match(/^Swap:\s+([\d\s]+)$/)
+            numbers = $1.split(/\s+/)
+            numbers[1].to_i
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vidibus/sysinfo/traffic.rb

@@ -0,0 +1,41 @@
+module Vidibus
+  module Sysinfo
+
+    # Returns total traffic of this month in gigabytes.
+    #
+    # Calls `vnstat`
+    #
+    # Installation on Debian:
+    #   apt-get install vnstat
+    #   vnstat -u -i eth0
+    #
+    module Traffic
+      extend Base
+
+      class << self
+        def command
+          "vnstat -m"
+        end
+
+        def parse(output)
+          month = /(\s*\w{3} \'\d{2})/
+          traffic = /\s*(\d+(?:\.\d+)?) (kB|MB|GB|TB)\s*/
+          last_month = output.split(/\r?\n/)[-3]
+          if last_month and last_month.match(/#{month}#{traffic}\|#{traffic}\|#{traffic}+/m)
+            amount = $6.to_f
+            unit = $7
+            gigabytes(amount, unit)
+          elsif output.match("Not enough data available yet")
+            0.0
+          end
+        end
+
+        def explain(error)
+          if error.match("vnstat: command not found")
+            return "vnstat is not installed. On Debian, you can install it with 'apt-get install vnstat' and 'vnstat -u -i eth0'"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vidibus/sysinfo/version.rb

@@ -0,0 +1,5 @@
+module Vidibus
+  module Sysinfo
+    VERSION = "0.0.1"
+  end
+end

data/lib/vidibus/sysinfo.rb

@@ -0,0 +1,58 @@
+require "sysinfo/base"
+require "sysinfo/core"
+require "sysinfo/cpu"
+require "sysinfo/load"
+require "sysinfo/traffic"
+require "sysinfo/bandwidth"
+require "sysinfo/storage"
+require "sysinfo/memory"
+require "sysinfo/swap"
+
+module Vidibus
+  module Sysinfo
+    class << self
+
+      # Returns number of cpu cores.
+      def core
+        Core.call
+      end
+
+      # Returns CPU utilization in percent.
+      def cpu
+        Cpu.call
+      end
+
+      # Returns system load, divided by number of CPU cores.
+      def load
+        Load.call
+      end
+
+      # Returns total traffic of this month in gigabytes.
+      def traffic
+        Traffic.call
+      end
+
+      # Returns currently used bandwith in MBit/s.
+      # Provide seconds to improve measurement.
+      # The higher the seconds, the more accurate are the results.
+      def bandwidth(seconds = 1)
+        Bandwidth.call(seconds)
+      end
+
+      # Returns consumed storage in gigabytes.
+      def storage
+        Storage.call
+      end
+
+      # Returns used memory in megabytes.
+      def memory
+        Memory.call
+      end
+
+      # Returns used swap in megabytes.
+      def swap
+        Swap.call
+      end
+    end
+  end
+end

data/lib/vidibus-sysinfo.rb

@@ -0,0 +1,2 @@
+$:.unshift(File.join(File.dirname(__FILE__), "vidibus"))
+require "sysinfo"

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 "rubygems"
+require "rspec"
+require "rr"
+require "vidibus-sysinfo"
+
+RSpec.configure do |config|
+  config.mock_with :rr
+end

data/spec/vidibus/sysinfo/bandwidth_spec.rb

@@ -0,0 +1,59 @@
+require "spec_helper"
+
+describe "Vidibus::Sysinfo::Bandwidth" do
+  let(:this) {Vidibus::Sysinfo::Bandwidth}
+  let(:first_output) do
+    "  eth0:11987621067 183430993    0    0    0     0          0         0 639006876738 427999432    0    0    0     0       0          0"
+   end
+   let(:second_output) do
+    "   eth0:11987897466 183435418    0    0    0     0          0         0 639026477572 428012510    0    0    0     0       0          0"
+   end
+
+  describe ".command" do
+    it "should return 'cat /proc/net/dev | grep eth0:'" do
+      this.command.should eql("cat /proc/net/dev | grep eth0:")
+    end
+  end
+
+  describe ".parse" do
+    it "should return a float of megabytes from valid output" do
+      this.parse(first_output).should eql(620836.73)
+    end
+
+    it "should return nil from invalid output" do
+      this.parse("something").should be_nil
+    end
+  end
+
+  describe ".call" do
+    let(:calls) do
+      [
+        [first_output, ""],
+        [second_output, ""]
+      ]
+    end
+
+    before do
+      stub(this).perform(this.command) {calls.shift}
+    end
+
+    it "should return the currently used bandwidth in MBit/s" do
+      this.call.should eql(151.68)
+    end
+
+    it "should accept a seconds argument as interval" do
+      mock(this).sleep(2)
+      this.call(2)
+    end
+
+    it "should divide the result by given seconds" do
+      stub(this).sleep(3)
+      this.call(3).should eql(151.68/3)
+    end
+
+    it "should yield an error if /proc/net/dev is not available" do
+      stub(this).perform(this.command) {["", "cat: /proc/net/dev: No such file or directory\n"]}
+      expect {this.call}.to raise_error(Vidibus::Sysinfo::CallError)
+    end
+  end
+end

data/spec/vidibus/sysinfo/core_spec.rb

@@ -0,0 +1,34 @@
+require "spec_helper"
+
+describe "Vidibus::Sysinfo::Core" do
+  let(:this) {Vidibus::Sysinfo::Core}
+  let(:output) {"8"}
+
+  describe ".command" do
+    it "should return 'cat /proc/cpuinfo | grep processor | wc -l'" do
+      this.command.should eql("cat /proc/cpuinfo | grep processor | wc -l")
+    end
+  end
+
+  describe ".parse" do
+    it "should return a number from valid output" do
+      this.parse(output).should eql(8)
+    end
+
+    it "should return nil from invalid output" do
+      this.parse("something").should be_nil
+    end
+  end
+
+  describe ".call" do
+    it "should return the number of CPU cores" do
+      stub(this).perform(this.command) {[output, ""]}
+      this.call.should eql(8)
+    end
+
+    it "should yield an error if /proc/cpuinfo is not available" do
+      stub(this).perform(this.command) {["       0\n", "cat: /proc/cpuinfo: No such file or directory\n"]}
+      expect {this.call}.to raise_error(Vidibus::Sysinfo::CallError)
+    end
+  end
+end

data/spec/vidibus/sysinfo/cpu_spec.rb

@@ -0,0 +1,34 @@
+require "spec_helper"
+
+describe "Vidibus::Sysinfo::Cpu" do
+  let(:this) {Vidibus::Sysinfo::Cpu}
+  let(:output) {"Average:     all    0.72    0.00    0.21    0.41    0.05    0.26    0.00   98.35   2950.20"}
+
+  describe ".command" do
+    it "should return 'mpstat 5 1 | grep Average:'" do
+      this.command.should eql("mpstat 5 1 | grep Average:")
+    end
+  end
+
+  describe ".parse" do
+    it "should return a decimal from valid output" do
+      this.parse(output).should eql(1.65)
+    end
+
+    it "should return nil from invalid output" do
+      this.parse("something").should be_nil
+    end
+  end
+
+  describe ".call" do
+    it "should return the CPU load in percent" do
+      stub(this).perform(this.command) {[output, ""]}
+      this.call.should eql(1.65)
+    end
+
+    it "should yield an error if mpstat is not installed" do
+      stub(this).perform(this.command) {["", "sh: mpstat: command not found\n"]}
+      expect {this.call}.to raise_error(Vidibus::Sysinfo::CallError)
+    end
+  end
+end

data/spec/vidibus/sysinfo/load_spec.rb

@@ -0,0 +1,36 @@
+require "spec_helper"
+
+describe "Vidibus::Sysinfo::Load" do
+  let(:this) {Vidibus::Sysinfo::Load}
+  let(:output) {" 19:52:41 up 2 days,  9:39,  4 users,  load average: 0.46, 0.53, 0.56"}
+
+  before {stub(Vidibus::Sysinfo::Core).call {2}}
+
+  describe ".command" do
+    it "should return 'uptime'" do
+      this.command.should eql("uptime")
+    end
+  end
+
+  describe ".parse" do
+    it "should return a decimal from valid output" do
+      this.parse(output).should eql(0.23)
+    end
+
+    it "should return nil from invalid output" do
+      this.parse("something").should be_nil
+    end
+  end
+
+  describe ".call" do
+    it "should return the system load as decimal" do
+      stub(this).perform(this.command) {[output, ""]}
+      this.call.should eql(0.23)
+    end
+
+    it "should yield a ParseError if output of uptime could not be parsed" do
+      stub(this).perform(this.command) {["20:14  up 6 days, 22:03, 20 users, load averages: 0,41 0,26 0,29\n",""]}
+      expect {this.call}.to raise_error(Vidibus::Sysinfo::ParseError)
+    end
+  end
+end

data/spec/vidibus/sysinfo/memory_spec.rb

@@ -0,0 +1,36 @@
+require "spec_helper"
+
+describe "Vidibus::Sysinfo::Memory" do
+  let(:this) {Vidibus::Sysinfo::Memory}
+  let(:output) do
+    "Mem:         12041      11873        167          0         75      10511"
+  end
+
+  describe ".command" do
+    it "should return 'free -m | grep Mem:'" do
+      this.command.should eql("free -m | grep Mem:")
+    end
+  end
+
+  describe ".parse" do
+    it "should return a number from valid output" do
+      this.parse(output).should eql(1362)
+    end
+
+    it "should return nil from invalid output" do
+      this.parse("something").should be_nil
+    end
+  end
+
+  describe ".call" do
+    it "should return the number of CPU cores" do
+      stub(this).perform(this.command) {[output, ""]}
+      this.call.should eql(1362)
+    end
+
+    it "should yield an error if /proc/cpuinfo is not available" do
+      stub(this).perform(this.command) {["", "sh: free: command not found\n"]}
+      expect {this.call}.to raise_error(Vidibus::Sysinfo::CallError)
+    end
+  end
+end

data/spec/vidibus/sysinfo/storage_spec.rb

@@ -0,0 +1,36 @@
+require "spec_helper"
+
+describe "Vidibus::Sysinfo::Storage" do
+  let(:this) {Vidibus::Sysinfo::Storage}
+  let(:output) do
+    "Filesystem            Size  Used Avail Use% Mounted on
+     /dev/md2              1.4T  693G  622G  53% /
+     tmpfs                 5.9G     0  5.9G   0% /lib/init/rw
+     udev                   10M  764K  9.3M   8% /dev
+     tmpfs                 5.9G     0  5.9G   0% /dev/shm
+     /dev/md1              251M   22M  217M  10% /boot"
+  end
+
+  describe ".command" do
+    it "should return 'df -h'" do
+      this.command.should eql("df -h")
+    end
+  end
+
+  describe ".parse" do
+    it "should return a number from valid output" do
+      this.parse(output).should eql(693.0)
+    end
+
+    it "should return nil from invalid output" do
+      this.parse("something").should be_nil
+    end
+  end
+
+  describe ".call" do
+    it "should return the used storage in gigabytes" do
+      stub(this).perform(this.command) {[output, ""]}
+      this.call.should eql(693.0)
+    end
+  end
+end

data/spec/vidibus/sysinfo/swap_spec.rb

@@ -0,0 +1,36 @@
+require "spec_helper"
+
+describe "Vidibus::Sysinfo::Swap" do
+  let(:this) {Vidibus::Sysinfo::Swap}
+  let(:output) do
+    "Swap:         2053          0       2052"
+  end
+
+  describe ".command" do
+    it "should return 'free -m | grep Swap:'" do
+      this.command.should eql("free -m | grep Swap:")
+    end
+  end
+
+  describe ".parse" do
+    it "should return a number from valid output" do
+      this.parse(output).should eql(0)
+    end
+
+    it "should return nil from invalid output" do
+      this.parse("something").should be_nil
+    end
+  end
+
+  describe ".call" do
+    it "should return the number of CPU cores" do
+      stub(this).perform(this.command) {[output, ""]}
+      this.call.should eql(0)
+    end
+
+    it "should yield an error if /proc/cpuinfo is not available" do
+      stub(this).perform(this.command) {["", "sh: free: command not found\n"]}
+      expect {this.call}.to raise_error(Vidibus::Sysinfo::CallError)
+    end
+  end
+end

data/spec/vidibus/sysinfo/traffic_spec.rb

@@ -0,0 +1,46 @@
+require "spec_helper"
+
+describe "Vidibus::Sysinfo::Traffic" do
+  let(:this) {Vidibus::Sysinfo::Traffic}
+  let(:output) do
+    "  eth0  /  monthly
+
+       month         rx      |      tx      |   total
+    -------------------------+--------------+--------------------------------------
+      Feb '11      31.62 GB  |     1.93 TB  |     1.96 TB   ::::::::::::::::::::::
+    -------------------------+--------------+--------------------------------------
+     estimated        88 GB  |     5.50 TB  |     5.58 TB"
+   end
+
+  describe ".command" do
+    it "should return 'vnstat -m'" do
+      this.command.should eql("vnstat -m")
+    end
+  end
+
+  describe ".parse" do
+    it "should return a number from valid output" do
+      this.parse(output).should eql(2007.04)
+    end
+
+    it "should return 0.0 if not enough data is available yet" do
+      this.parse(" eth0: Not enough data available yet.\n").should eql(0.0)
+    end
+
+    it "should return nil from invalid output" do
+      this.parse("something").should be_nil
+    end
+  end
+
+  describe ".call" do
+    it "should return the total traffic in gigabytes" do
+      stub(this).perform(this.command) {[output, ""]}
+      this.call.should eql(2007.04)
+    end
+
+    it "should yield an error if the command is not available" do
+      stub(this).perform(this.command) {["", "/Users/punkrats/.rvm/rubies/ruby-1.8.7-p249/lib/ruby/1.8/open3.rb:73:in `exec': Permission denied - vnstat -m (Errno::EACCES)\n\tfrom /Users/punkrats/.rvm/rubies/ruby-1.8.7-p249/lib/ruby/1.8/open3.rb:73:in `popen3'\n\tfrom..."]}
+      expect {this.call}.to raise_error(Vidibus::Sysinfo::CallError)
+    end
+  end
+end

data/spec/vidibus/sysinfo_spec.rb

@@ -0,0 +1,66 @@
+require "spec_helper"
+
+describe "Vidibus::Sysinfo" do
+  let(:this) {Vidibus::Sysinfo}
+
+  describe ".core" do
+    it "should call Vidibus::Sysinfo::Core" do
+      mock(this::Core).call
+      this.core
+    end
+  end
+
+  describe ".cpu" do
+    it "should call Vidibus::Sysinfo::Cpu" do
+      mock(this::Cpu).call
+      this.cpu
+    end
+  end
+
+  describe ".load" do
+    it "should call Vidibus::Sysinfo::Load" do
+      mock(this::Load).call
+      this.load
+    end
+  end
+
+  describe ".traffic" do
+    it "should call Vidibus::Sysinfo::Traffic" do
+      mock(this::Traffic).call
+      this.traffic
+    end
+  end
+
+  describe ".bandwidth" do
+    it "should call Vidibus::Sysinfo::Bandwidth" do
+      mock(this::Bandwidth).call(1)
+      this.bandwidth
+    end
+
+    it "should accept a seconds argument" do
+      mock(this::Bandwidth).call(2)
+      this.bandwidth(2)
+    end
+  end
+
+  describe ".storage" do
+    it "should call Vidibus::Sysinfo::Storage" do
+      mock(this::Storage).call
+      this.storage
+    end
+  end
+
+  describe ".memory" do
+    it "should call Vidibus::Sysinfo::Memory" do
+      mock(this::Memory).call
+      this.memory
+    end
+  end
+
+  describe ".swap" do
+    it "should call Vidibus::Sysinfo::Swap" do
+      mock(this::Swap).call
+      this.swap
+    end
+  end
+end

data/vidibus-sysinfo.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path("../lib/vidibus/sysinfo/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "vidibus-sysinfo"
+  s.version     = Vidibus::Sysinfo::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = "Andre Pankratz"
+  s.email       = "andre@vidibus.com"
+  s.homepage    = "https://github.com/vidibus/vidibus-sysinfo"
+  s.summary     = "Provides tools for obtaining information about the system"
+  s.description = "Gets CPU usage, current load, consumed memory and some other figures."
+
+  s.required_rubygems_version = ">= 1.3.6"
+  s.rubyforge_project         = "vidibus-sysinfo"
+
+  s.add_development_dependency "bundler", ">= 1.0.0"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "rspec", "~> 2.0.0.beta.20"
+  s.add_development_dependency "rr"
+  s.add_development_dependency "relevance-rcov"
+
+  s.files        = `git ls-files`.split("\n")
+  s.executables  = `git ls-files`.split("\n").map{|f| f =~ /^bin\/(.*)/ ? $1 : nil}.compact
+  s.require_path = 'lib'
+end

metadata

@@ -0,0 +1,172 @@
+--- !ruby/object:Gem::Specification 
+name: vidibus-sysinfo
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Andre Pankratz
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-11 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 62196427
+        segments: 
+        - 2
+        - 0
+        - 0
+        - beta
+        - 20
+        version: 2.0.0.beta.20
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rr
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: relevance-rcov
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id005
+description: Gets CPU usage, current load, consumed memory and some other figures.
+email: andre@vidibus.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.rdoc
+- Rakefile
+- lib/vidibus-sysinfo.rb
+- lib/vidibus/sysinfo.rb
+- lib/vidibus/sysinfo/bandwidth.rb
+- lib/vidibus/sysinfo/base.rb
+- lib/vidibus/sysinfo/core.rb
+- lib/vidibus/sysinfo/cpu.rb
+- lib/vidibus/sysinfo/load.rb
+- lib/vidibus/sysinfo/memory.rb
+- lib/vidibus/sysinfo/storage.rb
+- lib/vidibus/sysinfo/swap.rb
+- lib/vidibus/sysinfo/traffic.rb
+- lib/vidibus/sysinfo/version.rb
+- spec/spec_helper.rb
+- spec/vidibus/sysinfo/bandwidth_spec.rb
+- spec/vidibus/sysinfo/core_spec.rb
+- spec/vidibus/sysinfo/cpu_spec.rb
+- spec/vidibus/sysinfo/load_spec.rb
+- spec/vidibus/sysinfo/memory_spec.rb
+- spec/vidibus/sysinfo/storage_spec.rb
+- spec/vidibus/sysinfo/swap_spec.rb
+- spec/vidibus/sysinfo/traffic_spec.rb
+- spec/vidibus/sysinfo_spec.rb
+- vidibus-sysinfo.gemspec
+has_rdoc: true
+homepage: https://github.com/vidibus/vidibus-sysinfo
+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: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: vidibus-sysinfo
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Provides tools for obtaining information about the system
+test_files: []
+