sys-proctable 0.9.1-universal-darwin

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_darwin.rb

@@ -0,0 +1,213 @@
+########################################################################
+# test_sys_proctable_darwin.rb
+#
+# Test suite for the Darwin version of the sys-proctable library. You
+# should run these tests via the 'rake test' task.
+########################################################################
+require 'rubygems'
+gem 'test-unit'
+
+require 'sys/proctable'
+require 'test/test_sys_proctable_all'
+include Sys
+
+class TC_ProcTable_Darwin < Test::Unit::TestCase
+  def self.startup
+    @@fields = %w/
+      pid ppid pgid ruid rgid comm state pctcpu oncpu tnum
+      tdev wmesg rtime priority usrpri nice cmdline starttime
+      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)
+    assert_true(@ptable.comm.length > 0)
+  end
+
+  def test_state
+    assert_respond_to(@ptable, :state)
+    assert_kind_of(String, @ptable.state)
+    assert_true(%w/idle run sleep stop zombie unknown/.include?(@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)
+    omit("oncpu always nil for now")
+  end
+
+  def test_tnum
+    assert_respond_to(@ptable, :tnum)
+    #assert_kind_of(Fixnum, @ptable.tnum)
+  end
+
+  def test_tdev
+    assert_respond_to(@ptable, :tdev)
+    #assert_kind_of(String, @ptable.tdev)
+  end
+
+  def test_wmesg
+    assert_respond_to(@ptable, :wmesg)
+    assert_kind_of(String, @ptable.wmesg)
+  end
+
+  def test_rtime
+    assert_respond_to(@ptable, :rtime)
+    assert_kind_of(Fixnum, @ptable.rtime)
+  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_starttime
+    assert_respond_to(@ptable, :starttime)
+    assert_kind_of(Time, @ptable.starttime)
+  end
+
+  def test_maxrss
+    assert_respond_to(@ptable, :maxrss)
+    assert_true([NilClass, Fixnum].include?(@ptable.maxrss.class))
+  end
+
+  def test_ixrss
+    assert_respond_to(@ptable, :ixrss)
+    assert_true([NilClass, Fixnum].include?(@ptable.ixrss.class))
+  end
+
+  def test_idrss
+    assert_respond_to(@ptable, :idrss)
+    assert_true([NilClass, Fixnum].include?(@ptable.idrss.class))
+  end
+
+  def test_isrss
+    assert_respond_to(@ptable, :isrss)
+    assert_true([NilClass, Fixnum].include?(@ptable.isrss.class))
+  end
+
+  def test_minflt
+    assert_respond_to(@ptable, :minflt)
+    assert_true([NilClass, Fixnum].include?(@ptable.minflt.class))
+  end
+
+  def test_majflt
+    assert_respond_to(@ptable, :majflt)
+    assert_true([NilClass, Fixnum].include?(@ptable.majflt.class))
+  end
+
+  def test_nswap
+    assert_respond_to(@ptable, :nswap)
+    assert_true([NilClass, Fixnum].include?(@ptable.nswap.class))
+  end
+
+  def test_inblock
+    assert_respond_to(@ptable, :inblock)
+    assert_true([NilClass, Fixnum].include?(@ptable.inblock.class))
+  end
+
+  def test_oublock
+    assert_respond_to(@ptable, :oublock)
+    assert_true([NilClass, Fixnum].include?(@ptable.oublock.class))
+  end
+
+  def test_msgsnd
+    assert_respond_to(@ptable, :msgsnd)
+    assert_true([NilClass, Fixnum].include?(@ptable.msgsnd.class))
+  end
+
+  def test_msgrcv
+    assert_respond_to(@ptable, :msgrcv)
+    assert_true([NilClass, Fixnum].include?(@ptable.msgrcv.class))
+  end
+
+  def test_nsignals
+    assert_respond_to(@ptable, :nsignals)
+    assert_true([NilClass, Fixnum].include?(@ptable.nsignals.class))
+  end
+
+  def test_nvcsw
+    assert_respond_to(@ptable, :nvcsw)
+    assert_true([NilClass, Fixnum].include?(@ptable.nvcsw.class))
+  end
+
+  def test_nivcsw
+    assert_respond_to(@ptable, :nivcsw)
+    assert_true([NilClass, Fixnum].include?(@ptable.nivcsw.class))
+  end
+
+  def test_utime
+    assert_respond_to(@ptable, :utime)
+    assert_true([NilClass, Fixnum].include?(@ptable.utime.class))
+  end
+
+  def test_stime
+    assert_respond_to(@ptable, :stime)
+    assert_true([NilClass, Fixnum].include?(@ptable.stime.class))
+  end
+
+  def teardown
+    @ptable = nil
+  end
+
+  def self.shutdown
+    @@fields = nil
+  end
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification 
+name: sys-proctable
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 9
+  - 1
+  version: 0.9.1
+platform: universal-darwin
+authors: 
+- Daniel J. Berger
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-08-20 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: test-unit
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        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/darwin/extconf.rb
+extra_rdoc_files: 
+- CHANGES
+- README
+- MANIFEST
+- doc/top.txt
+- ext/darwin/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/darwin/sys/proctable.c
+- test/test_sys_proctable_darwin.rb
+- ext/darwin/extconf.rb
+has_rdoc: true
+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 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: sysutils
+rubygems_version: 1.3.7
+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_darwin.rb