systeminformation 0.1.0

data/.document

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

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Stefan Maier
+
+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,24 @@
+= SystemInformation
+
+This gem provides information on the system it is running on. 
+
+
+== Usage
+See SystemInformation.
+
+== Limitations
+At the moment only implementations for Linux exits. Implementations for other operating system are appreciated.
+
+== 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) 2010 Stefan Maier. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,52 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "systeminformation"
+    gem.summary = %Q{Provides information about the system}
+    gem.description = %Q{Provides information about cpu, memory, network throughput, current load and usercount}
+    gem.email = "stefanmaier@gmail.com"
+    gem.homepage = "http://github.com/tliff/systeminformation"
+    gem.authors = ["Stefan Maier"]
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "systeminformation #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

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

data/lib/systeminformation.rb

@@ -0,0 +1,108 @@
+require 'lib/systeminformation/os.rb'
+
+module SystemInformation
+  #Returns what operating system is running.
+  #Valid return values are :linux, :solaris, :bsd, :darwin, :windows and :unknown
+  def self.os
+    OS::os
+  end
+  
+  # Returns a hash of
+  #  {
+  #    "cpuid" => {
+  #      :idle => 1.0, 
+  #      :user => 0.0,
+  #      ...
+  #    },
+  #    ...
+  #  }
+  #
+  # The numerical values for each cpu sum up to 1.
+  #
+  # _Note:_ Since cpu utilisation is only defined for a time interval, the
+  # first call to this methods does not return meaningful data. It should be
+  # discarded and after a short time reexecuted. Subsequent calls will use
+  # the previous call as reference.
+  def self.cpu
+    if OS::linux?
+      @@cpu ||= Linux::CPU.new
+      @@cpu.utilization
+    end    
+  end
+  
+  
+  # Returns a hash of
+  #  {
+  #    :load_1 =>0.0,
+  #    :load_5 =>0.0,
+  #    :load_15 =>0.0,
+  #    :procs_running =>0.0,
+  #    :procs_total =>0.0
+  #  }
+  #
+  def self.load
+    if OS::linux?
+      Linux::Load.load
+    end    
+  end
+  
+  # Returns a hash of
+  #  {
+  #    "eth0" => {
+  #      :rbytes => 0.0,
+  #      :rpackets=>0.0,
+  #      :sbytes=>0.0,
+  #      :spackets=>0.0
+  #    },
+  #   ...
+  #  }
+  #
+  # values are bytes/second or packets/second respectively
+  #
+  # _Note:_ Since network throughput is only defined for a time interval, the
+  # first call to this methods does not return meaningful data. It should be
+  # discarded and after a short time reexecuted. Subsequent calls will use
+  # the previous call as reference.
+  def self.net
+    if OS::linux?
+      @@net ||= Linux::Net.new
+      @@net.throughput
+    end    
+  end
+  # Returns a hash of
+  #  items = {
+  #    :free=>23340,
+  #    :cached=>106052,
+  #    :buffers=>10864,
+  #    :total=>505492,
+  #    :swaptotal=>916472,
+  #    :swapfree=>782652,
+  #    :used=>365236,
+  #    :swapused=>133820
+  #  }
+  #
+  # The unit is kilobyte blocks.
+  def self.memory
+    if OS::linux?
+      Linux::Memory.usage
+    end
+  end
+  
+  # Returns the number of currently logged in users as an integer
+  def self.users
+    if OS::unix?
+      Unix::Users.loggedin
+    end
+  end
+  
+end
+
+os = [:unix, :linux]
+os.each do |o|
+  if SystemInformation::OS::os == o
+    Dir.glob(File.dirname(__FILE__) + "/systeminformation/#{o.to_s}/*.rb") do |i| 
+      require i 
+    end    
+  end
+end
+

data/lib/systeminformation/linux/cpu.rb

@@ -0,0 +1,47 @@
+module SystemInformation
+  module Linux
+    class CPU
+      def initialize
+        @prev_data = read_data
+      end
+      
+      def utilization
+        new_data = read_data
+        returnhash = {}
+        new_data.keys.each do |key|
+          difference = @prev_data[key].zip(new_data[key]).map{|i| i[1].to_f - i[0].to_f}
+          difference
+          sum = difference.inject{|a,b| a+b}
+
+          difference.map!{|i| i/sum}.map!{|i| i.nan? ? 0 : i}
+          returnhash[key] = {
+            :user => difference[0],
+            :nice => difference[1],
+            :system => difference[2],
+            :idle => difference[3],
+            :running => difference[4],
+            :iowait => difference[5],
+            :irq => difference[6],
+            :softirq => difference[7]
+          }
+        end
+        @prev_data = new_data
+        return returnhash
+      end
+      
+      private
+      def read_data
+        data = {}
+        File.open('/proc/stat','r') do |f|
+          f.readlines.select{|l| l =~ /^(cpu\d*) /}.each do |l|
+            cpu, *rest = l.split
+            data[cpu] = rest
+          end
+        end
+        data
+      end
+      
+      
+    end
+  end
+end

data/lib/systeminformation/linux/load.rb

@@ -0,0 +1,15 @@
+module SystemInformation
+  module Linux
+    module Load
+      def self.load
+        data = {}
+        File.open('/proc/loadavg','r') do |f|
+          line = f.readline
+          data[:load_1], data[:load_5], data[:load_15], processes = line.split
+          data[:procs_runnning], data[:procs_total] = processes.split('/')
+        end
+        return data
+      end
+    end
+  end
+end

data/lib/systeminformation/linux/memory.rb

@@ -0,0 +1,29 @@
+module SystemInformation
+  module Linux
+    module Memory
+      def self.usage
+        items = {
+          :free => 'MemFree',
+          :cached => 'Cached',
+          :buffers => 'Buffers',
+          :total => 'MemTotal',
+          :swaptotal => 'SwapTotal',
+          :swapfree => 'SwapFree'
+        }
+
+        File.open('/proc/meminfo','r') do |f|
+          f.readlines.each do |l|
+            items.each_pair do |i, k|
+              if matches = Regexp.new("#{k}: +([0-9]+)").match(l)
+                items[i] = matches[1].to_i
+              end
+            end
+          end
+          items[:used] = items[:total] - items[:free] - items[:cached] - items[:buffers]
+          items[:swapused] = items[:swaptotal] - items[:swapfree]
+        end
+        return items
+      end
+    end
+  end
+end

data/lib/systeminformation/linux/net.rb

@@ -0,0 +1,41 @@
+module SystemInformation
+  module Linux
+    class Net
+      def initialize
+        @prev_data = get_data
+	@prev_time = Time.now
+      end
+      
+      def throughput
+        new_data = get_data
+        difference ={}
+	delta = Time.now - @prev_time
+        @prev_data.keys.each{|k|
+          difference[k] = @prev_data[k].zip(new_data[k]).map{|i| (i[1].to_f - i[0].to_f)/delta}
+        }
+        @prev_data = new_data
+	@prev_time = Time.now
+        result={}
+        difference.each{|k,body|
+          result[k] = {:rbytes => body[0], :rpackets => body[1], :sbytes => body[2], :spackets => body[3]}
+        }
+        result
+      end
+      
+      private
+      def get_data
+        delta = nil
+        data = {}
+        File.open('/proc/net/dev','r') do |f|
+          f.readlines.select{|l| l =~ /:/}.each do |l|
+            l.gsub!(/ +/,' ').strip!
+            id, body = l.split(':')
+            body = body.strip.split
+            data[id] = [body[0],body[1],body[8],body[9]]
+          end
+        end
+        data
+      end
+    end
+  end
+end

data/lib/systeminformation/os.rb

@@ -0,0 +1,37 @@
+if /java/.match(RUBY_PLATFORM)
+  require 'java'
+  import 'java.lang.System'
+end
+
+
+module SystemInformation
+  module OS
+    def self.os
+      return @os if @os
+      name = RUBY_PLATFORM
+      @os = case name
+      when /linux/
+        :linux
+      when /solaris/
+        :solaris
+      when /bsd/
+        :bsd
+      when /darwin/ 
+        :darwin
+      when /win/
+        :windows
+      else
+        :unknown
+      end
+    end
+
+    def self.unix?
+      [:linux, :bsd, :darwin, :solaris].member?(os)
+    end
+    
+    def self.linux?
+      os == :linux
+    end
+    
+  end
+end

data/lib/systeminformation/unix/users.rb

@@ -0,0 +1,13 @@
+module SystemInformation
+  module Linux
+    module Users
+      def self.loggedin
+        count = 0
+        IO.popen('who') do |p|
+          count = p.readlines.size
+        end
+        return count
+      end
+    end
+  end
+end

data/systeminformation.gemspec

@@ -0,0 +1,51 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{systeminformation}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Stefan Maier"]
+  s.date = %q{2010-06-07}
+  s.description = %q{Provides information about cpu, memory, network throughput, current load and usercount}
+  s.email = %q{stefanmaier@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "lib/systeminformation.rb",
+     "lib/systeminformation/linux/cpu.rb",
+     "lib/systeminformation/linux/load.rb",
+     "lib/systeminformation/linux/memory.rb",
+     "lib/systeminformation/linux/net.rb",
+     "lib/systeminformation/os.rb",
+     "lib/systeminformation/unix/users.rb",
+     "systeminformation.gemspec"
+  ]
+  s.homepage = %q{http://github.com/tliff/systeminformation}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Provides information about the system}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification 
+name: systeminformation
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Stefan Maier
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-07 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: Provides information about cpu, memory, network throughput, current load and usercount
+email: stefanmaier@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/systeminformation.rb
+- lib/systeminformation/linux/cpu.rb
+- lib/systeminformation/linux/load.rb
+- lib/systeminformation/linux/memory.rb
+- lib/systeminformation/linux/net.rb
+- lib/systeminformation/os.rb
+- lib/systeminformation/unix/users.rb
+- systeminformation.gemspec
+has_rdoc: true
+homepage: http://github.com/tliff/systeminformation
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Provides information about the system
+test_files: []
+