sys-proctable 0.9.1-universal-freebsd

data/lib/sys/top.rb

@@ -0,0 +1,32 @@
+require 'sys/proctable'
+require 'rbconfig'
+
+# The Sys module serves as a namespace only
+module Sys
+
+  # The Top class serves as a toplevel name for the 'top' method.
+  class Top
+
+    # The version of the sys-top library
+    VERSION = '1.0.3'
+
+    # Returns an array of Struct::ProcTableStruct elements containing up
+    # to +num+ elements, sorted by +field+. The default number of elements
+    # is 10, while the default field is 'pctcpu'.
+    #
+    # Exception: the default sort field is 'pid' on Linux and Windows.
+    #
+    def self.top(num=10, field='pctcpu')
+      field = field.to_s if field.is_a?(Symbol)
+
+      windows = /mswin|win32|windows|dos|cygwin|mingw/i
+
+      # Sort by pid on Windows by default
+      if Config::CONFIG['host_os'].match(windows) && field == 'pctcpu'
+        field = 'pid'
+      end
+
+      Sys::ProcTable.ps.sort_by{ |obj| obj.send(field) || '' }[0..num-1]
+    end
+  end
+end

data/sys-proctable.gemspec

@@ -0,0 +1,39 @@
+require 'rubygems'
+require 'rbconfig'
+
+Gem::Specification.new do |spec|
+  spec.name       = 'sys-proctable'
+  spec.version    = '0.9.1'
+  spec.author     = 'Daniel J. Berger'
+  spec.license    = 'Artistic 2.0' 
+  spec.email      = 'djberg96@gmail.com'
+  spec.homepage   = 'http://www.rubyforge.org/projects/sysutils'
+  spec.platform   = Gem::Platform::CURRENT # Probably altered by Rake task
+  spec.summary    = 'An interface for providing process table information'
+  spec.test_files = ['test/test_sys_proctable_all.rb']
+   
+  # Additional files for your platform are added by the 'rake gem' task.
+  spec.files = [
+    'benchmarks/bench_ps.rb',
+    'examples/example_ps.rb',
+    'lib/sys/top.rb',
+    'CHANGES',
+    'MANIFEST',
+    'Rakefile',
+    'README',
+    'sys-proctable.gemspec'
+  ]
+
+  spec.rubyforge_project = 'sysutils'
+  spec.extra_rdoc_files  = ['CHANGES', 'README', 'MANIFEST', 'doc/top.txt']
+
+  spec.add_development_dependency('test-unit', '>= 2.1.2')
+
+  spec.description = <<-EOF
+    The sys-proctable library provides an interface for gathering information
+    about processes on your system, i.e. the process table. Most major
+    platforms are supported and, while different platforms may return
+    different information, the external interface is identical across
+    platforms.
+  EOF
+end

data/test/test_sys_proctable_all.rb

@@ -0,0 +1,85 @@
+#######################################################################
+# test_sys_proctable_all.rb
+#
+# Test suite for methods common to all platforms. Generally speaking
+# you should run this test case using the 'rake test' task.
+#######################################################################
+require 'rubygems'
+gem 'test-unit'
+
+require 'test/unit'
+require 'sys/proctable'
+require 'rbconfig'
+require 'test/test_sys_top'
+include Sys
+
+class TC_ProcTable_All < Test::Unit::TestCase
+  def self.startup
+    @@windows = Config::CONFIG['host_os'] =~ /windows|win32|msdos|mswin32|mingw|cygwin/i
+  end
+
+  def setup
+    @pid = @@windows ? 0 : 1
+  end
+
+  def test_version
+    assert_equal('0.9.1', ProcTable::VERSION)
+  end
+
+  def test_fields
+    assert_respond_to(ProcTable, :fields)
+    assert_nothing_raised{ ProcTable.fields }
+    assert_kind_of(Array, ProcTable.fields)
+    assert_kind_of(String, ProcTable.fields.first)
+  end
+
+  def test_ps
+    assert_respond_to(ProcTable, :ps)
+    assert_nothing_raised{ ProcTable.ps }
+    assert_nothing_raised{ ProcTable.ps{} }
+  end
+
+  def test_ps_with_pid
+    assert_nothing_raised{ ProcTable.ps(0) }
+  end
+
+  def test_ps_with_explicit_nil
+    assert_nothing_raised{ ProcTable.ps(nil) }
+    assert_kind_of(Array, ProcTable.ps(nil))
+  end
+
+  def test_ps_return_value
+    assert_kind_of(Array, ProcTable.ps)
+    assert_kind_of(Struct::ProcTableStruct, ProcTable.ps(@pid))
+    assert_equal(nil, ProcTable.ps(999999999))
+    assert_equal(nil, ProcTable.ps(999999999){})
+    assert_equal(nil, ProcTable.ps{})
+  end
+
+  def test_ps_returned_struct_is_frozen
+    assert_true(ProcTable.ps.first.frozen?)
+  end
+
+  def test_ps_expected_errors
+    assert_raises(TypeError){ ProcTable.ps('vim') }
+    omit_if(@@windows, 'ArgumentError check skipped on MS Windows')
+    assert_raises(ArgumentError){ ProcTable.ps(0, 'localhost') }
+  end
+
+  def test_new_not_allowed
+    assert_raise(NoMethodError){ Sys::ProcTable.new }
+  end
+
+  def test_error_class_defined
+    assert_not_nil(Sys::ProcTable::Error)
+    assert_kind_of(StandardError, Sys::ProcTable::Error.new)
+  end
+
+  def teardown
+    @pid  = nil
+  end
+
+  def self.teardown
+    @@windows = nil
+  end
+end

data/test/test_sys_proctable_bsd.rb

@@ -0,0 +1,212 @@
+################################################################
+# test_sys_proctable_bsd.rb
+#
+# Test suite for various BSD flavors for the sys-proctable
+# library. You should run these tests via 'rake test'.
+################################################################
+require 'rubygems'
+gem 'test-unit'
+
+require 'test/unit'
+require 'sys/proctable'
+require 'test/test_sys_proctable_all'
+include Sys
+
+class TC_Sys_ProcTable_BSD < Test::Unit::TestCase
+  def self.startup
+    @@fields = %w/
+      pid ppid pgid ruid rgid comm state pctcpu oncpu ttynum ttydev
+      wmesg time priority usrpri nice cmdline start
+      maxrss ixrss idrss isrss minflt majflt nswap inblock oublock
+      msgsnd msgrcv nsignals nvcsw nivcsw utime stime
+    /
+  end
+
+  def setup
+    @ptable = ProcTable.ps.last
+  end
+
+  def test_fields
+    assert_respond_to(ProcTable, :fields)
+    assert_kind_of(Array, ProcTable.fields)
+    assert_equal(@@fields, ProcTable.fields)
+  end
+
+  def test_pid
+    assert_respond_to(@ptable, :pid)
+    assert_kind_of(Fixnum, @ptable.pid)
+  end
+
+  def test_ppid
+    assert_respond_to(@ptable, :ppid)
+    assert_kind_of(Fixnum, @ptable.ppid)
+  end
+
+  def test_pgid
+    assert_respond_to(@ptable, :pgid)
+    assert_kind_of(Fixnum, @ptable.pgid)
+  end
+
+  def test_ruid
+    assert_respond_to(@ptable, :ruid)
+    assert_kind_of(Fixnum, @ptable.ruid)
+  end
+
+  def test_rgid
+    assert_respond_to(@ptable, :rgid)
+    assert_kind_of(Fixnum, @ptable.rgid)
+  end
+
+  def test_comm
+    assert_respond_to(@ptable, :comm)
+    assert_kind_of(String, @ptable.comm)
+  end
+
+  def test_state
+    assert_respond_to(@ptable, :state)
+    assert_kind_of(String, @ptable.state)
+  end
+
+  def test_pctcpu
+    assert_respond_to(@ptable, :pctcpu)
+    assert_kind_of(Float, @ptable.pctcpu)
+  end
+
+  def test_oncpu
+    assert_respond_to(@ptable, :oncpu)
+    assert_kind_of(Fixnum, @ptable.oncpu)
+  end
+
+  def test_ttynum
+    assert_respond_to(@ptable, :ttynum)
+    assert_kind_of(Fixnum, @ptable.ttynum)
+  end
+
+  def test_ttydev
+    assert_respond_to(@ptable, :ttydev)
+    assert_kind_of(String, @ptable.ttydev)
+  end
+
+  def test_wmesg
+    assert_respond_to(@ptable, :wmesg)
+    assert_kind_of(String, @ptable.wmesg)
+  end
+
+  def test_time
+    assert_respond_to(@ptable, :time)
+    assert_kind_of(Fixnum, @ptable.time)
+  end
+
+  def test_priority
+    assert_respond_to(@ptable, :priority)
+    assert_kind_of(Fixnum, @ptable.priority)
+  end
+
+  def test_usrpri
+    assert_respond_to(@ptable, :usrpri)
+    assert_kind_of(Fixnum, @ptable.usrpri)
+  end
+
+  def test_nice
+    assert_respond_to(@ptable, :nice)
+    assert_kind_of(Fixnum, @ptable.nice)
+  end
+
+  def test_cmdline
+    assert_respond_to(@ptable, :cmdline)
+    assert_kind_of(String, @ptable.cmdline)
+  end
+
+  def test_start
+    assert_respond_to(@ptable, :start)
+    assert_kind_of(Time, @ptable.start)
+  end
+
+  def test_maxrss
+    assert_respond_to(@ptable, :maxrss)
+    assert_true(@ptable.maxrss.kind_of?(Fixnum) || @ptable.maxrss.nil?)
+  end
+
+  def test_ixrss
+    assert_respond_to(@ptable, :ixrss)
+    assert_true(@ptable.ixrss.kind_of?(Fixnum) || @ptable.ixrss.nil?)
+  end
+
+  def test_idrss
+    assert_respond_to(@ptable, :idrss)
+    assert_true(@ptable.idrss.kind_of?(Fixnum) || @ptable.idrss.nil?)
+  end
+
+  def test_isrss
+    assert_respond_to(@ptable, :isrss)
+    assert_true(@ptable.isrss.kind_of?(Fixnum) || @ptable.isrss.nil?)
+  end
+
+  def test_minflt
+    assert_respond_to(@ptable, :minflt)
+    assert_true(@ptable.minflt.kind_of?(Fixnum) || @ptable.minflt.nil?)
+  end
+
+  def test_majflt
+    assert_respond_to(@ptable, :majflt)
+    assert_true(@ptable.majflt.kind_of?(Fixnum) || @ptable.majflt.nil?)
+  end
+
+  def test_nswap
+    assert_respond_to(@ptable, :nswap)
+    assert_true(@ptable.nswap.kind_of?(Fixnum) || @ptable.nswap.nil?)
+  end
+
+  def test_inblock
+    assert_respond_to(@ptable, :inblock)
+    assert_true(@ptable.inblock.kind_of?(Fixnum) || @ptable.inblock.nil?)
+  end
+
+  def test_oublock
+    assert_respond_to(@ptable, :oublock)
+    assert_true(@ptable.oublock.kind_of?(Fixnum) || @ptable.oublock.nil?)
+  end
+
+  def test_msgsnd
+    assert_respond_to(@ptable, :msgsnd)
+    assert_true(@ptable.msgsnd.kind_of?(Fixnum) || @ptable.msgsnd.nil?)
+  end
+
+  def test_msgrcv
+    assert_respond_to(@ptable, :msgrcv)
+    assert_true(@ptable.msgrcv.kind_of?(Fixnum) || @ptable.msgrcv.nil?)
+  end
+
+  def test_nsignals
+    assert_respond_to(@ptable, :nsignals)
+    assert_true(@ptable.nsignals.kind_of?(Fixnum) || @ptable.nsignals.nil?)
+  end
+
+  def test_nvcsw
+    assert_respond_to(@ptable, :nvcsw)
+    assert_true(@ptable.nvcsw.kind_of?(Fixnum) || @ptable.nvcsw.nil?)
+  end
+
+  def test_nivcsw
+    assert_respond_to(@ptable, :nivcsw)
+    assert_true(@ptable.nivcsw.kind_of?(Fixnum) || @ptable.nivcsw.nil?)
+  end
+
+  def test_utime
+    assert_respond_to(@ptable, :utime)
+    assert_true(@ptable.utime.kind_of?(Fixnum) || @ptable.utime.nil?)
+  end
+
+  def test_stime
+    assert_respond_to(@ptable, :stime)
+    assert_true(@ptable.stime.kind_of?(Fixnum) || @ptable.stime.nil?)
+  end
+
+  def teardown
+    @ptable = nil
+  end
+
+  def self.shutdown
+    @@fields = nil
+  end
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification 
+name: sys-proctable
+version: !ruby/object:Gem::Version 
+  hash: 57
+  prerelease: 
+  segments: 
+  - 0
+  - 9
+  - 1
+  version: 0.9.1
+platform: universal-freebsd
+authors: 
+- Daniel J. Berger
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-03 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: test-unit
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 2
+        - 1
+        - 2
+        version: 2.1.2
+  type: :development
+  version_requirements: *id001
+description: "    The sys-proctable library provides an interface for gathering information\n    about processes on your system, i.e. the process table. Most major\n    platforms are supported and, while different platforms may return\n    different information, the external interface is identical across\n    platforms.\n"
+email: djberg96@gmail.com
+executables: []
+
+extensions: 
+- ext/bsd/extconf.rb
+extra_rdoc_files: 
+- CHANGES
+- README
+- MANIFEST
+- doc/top.txt
+- ext/bsd/sys/proctable.c
+files: 
+- benchmarks/bench_ps.rb
+- examples/example_ps.rb
+- lib/sys/top.rb
+- CHANGES
+- MANIFEST
+- Rakefile
+- README
+- sys-proctable.gemspec
+- test/test_sys_proctable_all.rb
+- doc/top.txt
+- ext/bsd/sys/proctable.c
+- test/test_sys_proctable_bsd.rb
+- ext/bsd/extconf.rb
+homepage: http://www.rubyforge.org/projects/sysutils
+licenses: 
+- Artistic 2.0
+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: sysutils
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: An interface for providing process table information
+test_files: 
+- test/test_sys_proctable_all.rb
+- test/test_sys_proctable_bsd.rb