sys-proctable 1.2.0 → 1.2.5

data/spec/sys_proctable_linux_spec.rb

@@ -10,12 +10,12 @@ require_relative 'sys_proctable_all_spec'
 
 describe Sys::ProcTable do
   let(:fields){ %w[
-      cmdline cwd exe pid name uid euid gid egid comm state ppid pgrp
-      session tty_num tpgid flags minflt cminflt majflt cmajflt utime
-      stime cutime cstime priority nice itrealvalue starttime vsize
-      rss rlim startcode endcode startstack kstkesp kstkeip signal blocked
-      sigignore sigcatch wchan nswap cnswap exit_signal processor environ
-      pctcpu pctmem nlwp cgroup smaps
+      cmdline cwd environ exe fd root pid name uid euid gid egid comm state ppid pgrp
+      session tty_nr tpgid flags minflt cminflt majflt cmajflt utime
+      stime cutime cstime priority nice num_threads itrealvalue starttime vsize
+      rss rlim rsslim startcode endcode startstack kstkesp kstkeip signal blocked
+      sigignore sigcatch wchan nswap cnswap exit_signal processor rt_priority
+      policy delayacct_blkio_ticks guest_time cguest_time pctcpu pctmem nlwp cgroup smaps
     ]
   }
 
@@ -147,6 +147,11 @@ describe Sys::ProcTable do
       expect(subject.nice).to be_kind_of(Numeric)
     end
 
+    it "contains a num_threads member and returns the expected value" do
+      expect(subject).to respond_to(:num_threads)
+      expect(subject.num_threads).to be_kind_of(Numeric)
+    end
+
     it "contains a itrealvalue member and returns the expected value" do
       expect(subject).to respond_to(:itrealvalue)
       expect(subject.itrealvalue).to be_kind_of(Numeric)
@@ -167,9 +172,10 @@ describe Sys::ProcTable do
       expect(subject.rss).to be_kind_of(Numeric)
     end
 
-    it "contains an rlim member and returns the expected value" do
-      expect(subject).to respond_to(:rlim)
-      expect(subject.rlim).to be_kind_of(Numeric)
+    it "contains an rsslim member and returns the expected value" do
+      expect(subject).to respond_to(:rsslim)
+      expect(subject.rsslim).to be_kind_of(Numeric)
+      expect(subject.rsslim).to eq(subject.rlim)
     end
 
     it "contains an startcode member and returns the expected value" do
@@ -252,6 +258,21 @@ describe Sys::ProcTable do
       expect(subject.policy).to be_kind_of(Integer)
     end
 
+    it "contains a delayacct_blkio_ticks member and returns the expected value" do
+      expect(subject).to respond_to(:delayacct_blkio_ticks)
+      expect(subject.delayacct_blkio_ticks).to be_kind_of(Integer)
+    end
+
+    it "contains a guest_time member and returns the expected value" do
+      expect(subject).to respond_to(:guest_time)
+      expect(subject.guest_time).to be_kind_of(Integer)
+    end
+
+    it "contains a cguest_time member and returns the expected value" do
+      expect(subject).to respond_to(:cguest_time)
+      expect(subject.cguest_time).to be_kind_of(Integer)
+    end
+
     it "contains a name member and returns the expected value" do
       expect(subject).to respond_to(:name)
       expect(subject.name).to be_kind_of(String)
@@ -307,4 +328,12 @@ describe Sys::ProcTable do
       expect(subject.smaps).to be_kind_of(Sys::ProcTable::Smaps)
     end
   end
+
+  context "fields" do
+    it "has a fields method that returns the expected results" do
+      expect(described_class).to respond_to(:fields)
+      expect(described_class.fields).to be_kind_of(Array)
+      expect(described_class.fields).to match_array(fields)
+    end
+  end
 end

data/sys-proctable.gemspec

@@ -2,9 +2,9 @@ require 'rubygems'
 
 Gem::Specification.new do |spec|
   spec.name       = 'sys-proctable'
-  spec.version    = '1.2.0'
+  spec.version    = '1.2.5'
   spec.author     = 'Daniel J. Berger'
-  spec.license    = 'Apache 2.0'
+  spec.license    = 'Apache-2.0'
   spec.email      = 'djberg96@gmail.com'
   spec.homepage   = 'http://github.com/djberg96/sys-proctable'
   spec.summary    = 'An interface for providing process table information'
@@ -15,19 +15,29 @@ Gem::Specification.new do |spec|
     "benchmarks/**/*.rb",
     "examples/**/*.rb",
     "lib/**/*.rb",
-    'CHANGES',
-    'MANIFEST',
+    'CHANGES.rdoc',
+    'LICENSE',
+    'MANIFEST.rdoc',
     'Rakefile',
-    'README',
+    'README.md',
     'sys-proctable.gemspec'
   ]
 
-  spec.extra_rdoc_files  = ['CHANGES', 'README', 'MANIFEST', 'doc/top.txt']
+  spec.extra_rdoc_files = ['CHANGES.rdoc', 'README.md', 'MANIFEST.rdoc']
 
   spec.add_dependency('ffi')
   spec.add_development_dependency('rspec')
   spec.add_development_dependency('rake')
 
+  spec.metadata = {
+    'homepage_uri'      => 'https://github.com/djberg96/sys-proctable',
+    'bug_tracker_uri'   => 'https://github.com/djberg96/sys-proctable/issues',
+    'changelog_uri'     => 'https://github.com/djberg96/sys-proctable/blob/master/CHANGES.rdoc',
+    'documentation_uri' => 'https://github.com/djberg96/sys-proctable/wiki',
+    'source_code_uri'   => 'https://github.com/djberg96/sys-proctable',
+    'wiki_uri'          => 'https://github.com/djberg96/sys-proctable/wiki'
+  }
+
   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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sys-proctable
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.5
 platform: ruby
 authors:
 - Daniel J. Berger
@@ -12,30 +12,30 @@ cert_chain:
   -----BEGIN CERTIFICATE-----
   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
-  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
+  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
-  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
+  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
   -----END CERTIFICATE-----
-date: 2018-02-20 00:00:00.000000000 Z
+date: 
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -89,11 +89,11 @@ email: djberg96@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
-- CHANGES
-- README
-- MANIFEST
-- doc/top.txt
+- CHANGES.rdoc
+- README.md
+- MANIFEST.rdoc
 files:
+- benchmarks/bench_ips_ps.rb
 - benchmarks/bench_ps.rb
 - examples/example_ps.rb
 - lib/aix/sys/proctable.rb
@@ -109,15 +109,22 @@ files:
 - lib/sys/proctable/version.rb
 - lib/sys/top.rb
 - lib/windows/sys/proctable.rb
-- CHANGES
-- MANIFEST
+- CHANGES.rdoc
+- LICENSE
+- MANIFEST.rdoc
 - Rakefile
-- README
+- README.md
 - sys-proctable.gemspec
 homepage: http://github.com/djberg96/sys-proctable
 licenses:
-- Apache 2.0
-metadata: {}
+- Apache-2.0
+metadata:
+  homepage_uri: https://github.com/djberg96/sys-proctable
+  bug_tracker_uri: https://github.com/djberg96/sys-proctable/issues
+  changelog_uri: https://github.com/djberg96/sys-proctable/blob/master/CHANGES.rdoc
+  documentation_uri: https://github.com/djberg96/sys-proctable/wiki
+  source_code_uri: https://github.com/djberg96/sys-proctable
+  wiki_uri: https://github.com/djberg96/sys-proctable/wiki
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -133,12 +140,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: An interface for providing process table information
 test_files:
+- spec/spec_helper.rb
 - spec/sys_proctable_aix_spec.rb
 - spec/sys_proctable_all_spec.rb
 - spec/sys_proctable_darwin_spec.rb

data/README

@@ -1,120 +0,0 @@
-== Description
-  A Ruby interface for gathering process information.
-
-== Prerequisites
-* Test::Unit 2.x (development only)
-
-== Supported Platforms
-* Windows 2000 or later
-* Linux 2.6+
-* FreeBSD
-* Solaris 8+
-* HP-UX 10+
-* OS X 10.7+
-* AIX 5.3+
-
-== Installation
-  gem install sys-proctable
-
-  You may need to specify a platform in some cases. For example:
-
-  gem install sys-proctable --platform mswin32 # Windows
-  gem install sys-proctable --platform sunos   # Solaris
-  gem install sys-proctable --platform linux   # Linux
-  gem install sys-proctable --platform freebsd # FreeBSD
-  gem install sys-proctable --platform darwin  # OS X
-
-== Synopsis
-  require 'sys/proctable'
-  include Sys
-
-  # Everything
-  ProcTable.ps{ |p|
-    puts p.pid.to_s
-    puts p.comm
-    # ...
-  }
-
-  # Just one process
-  s = ProcTable.ps(2123)
-  puts s.pid.to_s
-  puts s.comm
-  # ...
-
-  # Return the results as an array of ProcTableStructs
-  a = ProcTable.ps
-  a.each do |p|
-    puts p.pid
-    # ...
-  end
-
-== Notes 
-  Windows users may pass a host name as a second argument to get process
-  information from a different host. This relies on the WMI service running.
-
-== Known Issues
-=== FreeBSD
-  A kvm interface is used. That means the owner of the process using the
-  sys-proctable library needs to be a member of the kvm group (or root).
-
-=== Bundler
-  Bundler seems to have trouble installing the proper gem because of the
-  platform specific gem names. To deal with that, run this command first:
-
-    bundle config specific_platform true
-
-  You can follow the issue at:
-
-    https://github.com/bundler/bundler/issues/5536  
-
-=== Solaris
-  The cmdline member on Solaris is limited to 80 characters unless you (or
-  your program) own the process. This is a Solaris design flaw/feature.
-
-=== OS X
-  The libproc interface is used. That means you will only get list of
-  processes that you have access to. To get a full listing, run as root.
-
-== Future Plans
-  Add support for NetBSD and OpenBSD.
-  Convert remaining C code (just HP-UX at this point) to FFI.
-
-== Acknowledgements
-  This library was originally based on the Perl module Proc::ProcessTable
-  by Dan Urist. Many ideas, as well as large chunks of code, were taken
-  from his work. So, a big THANK YOU goes out to Dan Urist.
-
-  A big thanks also goes out to Mike Hall who was very helpful with ideas,
-  logic and testing.
-
-  Thanks also go to Sean Chittenden for providing an account on one of his
-  FreeBSD machines. This is how the FreeBSD support was (initially) added.
-
-  Thanks go to James Hranicky for providing a patch that grabs name, eid,
-  euid, gid and guid info in the Linux version, along with some general
-  debugging help.
-   
-  Thanks go to David Felstead for the original OS X code. Thanks also go
-  to Matthias Zirnstein for adding the original cmdline support for OS X.
-
-  Finally I'd like to thank all the folks who have submitted bug reports
-  and/or patches.
-
-== Help Wanted
-  I do not have access to all platforms. If your platform is not supported
-  then you will need to either submit a patch or give me a remote account
-  on a box with a compiler so that I can write the code.
-
-== More documentation
-  See the documentation under the 'doc' directory for more information,
-  including platform specific notes and issues.
-
-== License
-  Apache 2.0
-    
-== Copyright
-  (C) 2003-2016 Daniel J. Berger
-  All Rights Reserved.
-
-== Author
-  Daniel J. Berger

data/doc/top.txt

@@ -1,47 +0,0 @@
-= Description
-   A simple 'top' interface for Ruby
-
-= Prerequisites
-   Requires the "sys/proctable" package (which should be installed along
-   with this package).
-
-= Synopsis
-   require "sys/top"
-
-   Sys::Top.top(5).each{ |ps|
-      p ps
-   }
-	
-= Constants
-VERSION
-   Returns the version number of this package as a String.
-	
-= Class Methods
-Sys::Top.top(number=10, field="pctcpu")
-   Returns an array of ProcTableStruct's.  The size of the array (i.e. the
-   number of processes) that it returns is based on +number+, and sorted by
-   +pctcpu+.  By default, the size and field values are 10 and "pctcpu",
-   respectively.
-
-= Notes
-   Not all fields are available on all platforms.  Please check your
-   platform specific documentation for which fields are available.
-	
-= Bugs
-   None that I'm aware of.  Please log bug reports on the project page at
-   http://www.rubyforge.org/projects/sysutils
-	
-= License
-   Artistic 2.0
-	
-= Copyright
-   (C) 2004-2009 Daniel J. Berger
-   All Rights Reserved.
-    
-= Warranty
-   This package is provided "as is" and without any express or
-   implied warranties, including, without limitation, the implied
-   warranties of merchantability and fitness for a particular purpose.
-
-= Author
-   Daniel J. Berger