sys-proctable 0.7.6 → 1.2.0

data/spec/sys_top_spec.rb

@@ -0,0 +1,51 @@
+##############################################################################
+# sys_top_spec.rb
+#
+# Test suite for the sys-top library that is included with this distribution.
+##############################################################################
+require 'rspec'
+require 'sys/top'
+
+describe Sys::Top do
+  context "constants" do
+    it "sets the version to the expected value" do
+      expect(Sys::Top::VERSION).to eql('1.0.5')
+    end
+  end
+
+  context "top" do
+    it "defines a top method" do
+      expect(described_class).to respond_to(:top) 
+    end
+
+    it "returns an array" do
+      expect(described_class.top).to be_kind_of(Array)
+    end
+
+    it "works with no arguments" do
+      expect{ described_class.top }.to_not raise_error
+    end
+
+    it "accepts a maximum of two arguments" do
+      expect{ described_class.top(1, 'foo', 2) }.to raise_error(ArgumentError)
+    end
+
+    it "accepts optional arguments" do
+      expect{ described_class.top(5) }.to_not raise_error
+      expect{ described_class.top(5, 'cmdline') }.to_not raise_error
+    end
+
+    it "returns the expected results with no arguments" do
+      expect(described_class.top.size).to eql(10)
+      expect(described_class.top.first).to be_kind_of(Struct::ProcTableStruct)
+    end
+
+    it "returns the expected result with a size argument" do
+      expect(described_class.top(5).size).to eql(5)
+    end
+
+    it "returns the expected result with a size and sort_by argument" do
+      expect(described_class.top(5, :cmdline).size).to eql(5)
+    end
+  end
+end

data/sys-proctable.gemspec

@@ -0,0 +1,38 @@
+require 'rubygems'
+
+Gem::Specification.new do |spec|
+  spec.name       = 'sys-proctable'
+  spec.version    = '1.2.0'
+  spec.author     = 'Daniel J. Berger'
+  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'
+  spec.test_files = FileList['spec/**/*.rb']
+  spec.cert_chain = ['certs/djberg96_pub.pem']
+   
+  spec.files = FileList[
+    "benchmarks/**/*.rb",
+    "examples/**/*.rb",
+    "lib/**/*.rb",
+    'CHANGES',
+    'MANIFEST',
+    'Rakefile',
+    'README',
+    'sys-proctable.gemspec'
+  ]
+
+  spec.extra_rdoc_files  = ['CHANGES', 'README', 'MANIFEST', 'doc/top.txt']
+
+  spec.add_dependency('ffi')
+  spec.add_development_dependency('rspec')
+  spec.add_development_dependency('rake')
+
+  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

metadata

@@ -1,73 +1,149 @@
---- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.4
-specification_version: 1
+--- !ruby/object:Gem::Specification
 name: sys-proctable
-version: !ruby/object:Gem::Version 
-  version: 0.7.6
-date: 2007-07-11 00:00:00 -06:00
-summary: An interface for providing process table information
-require_paths: 
-- lib
-email: djberg96@gmail.com
-homepage: http://www.rubyforge.org/projects/sysutils
-rubyforge_project: sysutils
-description: An interface for providing process table information
-autorequire: 
-default_executable: 
-bindir: bin
-has_rdoc: true
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: 1.8.0
-  version: 
+version: !ruby/object:Gem::Version
+  version: 1.2.0
 platform: ruby
-signing_key: 
-cert_chain: 
-post_install_message: 
-authors: 
+authors:
 - Daniel J. Berger
-files: 
-- doc/freebsd.txt
-- doc/hpux.txt
-- doc/linux.txt
-- doc/solaris.txt
-- doc/top.txt
-- doc/windows.txt
-- test/tc_all.rb
-- test/tc_freebsd.rb
-- test/tc_hpux.rb
-- test/tc_kvm_bsd.rb
-- test/tc_linux.rb
-- test/tc_sunos.rb
-- test/tc_top.rb
-- test/tc_windows.rb
-- test/test_memleak.rb
-- lib/sys/top.rb
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEcDCCAtigAwIBAgIBATANBgkqhkiG9w0BAQsFADA/MREwDwYDVQQDDAhkamJl
+  cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+  MB4XDTE4MDIxOTIzMjIxMloXDTI4MDIxNzIzMjIxMlowPzERMA8GA1UEAwwIZGpi
+  ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
+  bTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBAOFYobQ3ovXNC4RexrdP
+  malr3eyK6lvQuS5DOQpHQrT3sRbrhAy5c2effNmznnUzDDGnHs+ZKkAeVmUDIi+K
+  lfXjV8uPEkLMXUpDndg9rbmQmfie07ixCdE9JYRPwfMTcE+jbtUyZqEUIg7XYmuJ
+  j28bgsq7I9SMOPS9I+3DiEK50NzGd1ixA+RW8yfApC0jU6KkBQBekETvgQ2OOEH+
+  RwoQqLQ2OpujQsmiofRyvpm3i8DNaQ5Awx7dnCrX9M98KxKHrBuAGARUQl6xh7nU
+  vebWtf6p348oBopTwav0fulZ7zF54B0zVWUTBwHP4q9ulOfHYjqUUfu6NixtNisd
+  Qv4Dp82Qi12aeTd4KGBlbnNHSM+SENKlOydE3+ROEUHK+G6LjccwxBHtFMCjCjaD
+  PAH4f+RtfeuBFUJDzQKrM4dfosVHnAoILL4jv4rJNDvkdj7TD2qF1MZblbhc2R5W
+  Ap4PN2gtzmPAyAe1PXf6dT/Jd2b4GNgxYXLCDOufZDviLQIDAQABo3cwdTAJBgNV
+  HRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUhSCp+aIknYPSqLCGAaPvJN4n
+  BZYwHQYDVR0RBBYwFIESZGpiZXJnOTZAZ21haWwuY29tMB0GA1UdEgQWMBSBEmRq
+  YmVyZzk2QGdtYWlsLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAQCx5R3MfmTTZAd9+
+  RjqLjSzoaFEnqrhZCpuHzY9xEHmSldwHlzwLy60i4CHP7GySmlzTNZNJmPEG0ev5
+  YGXeRygkbN0x2pvCPdXHwcU4POTlM2JDntLIjWxNkOI9l9QNixuBrliqQ7UCMRkz
+  z+2K66CGGps2pGEPYU1hp0vjn4bQOyM1tPx5GothXvY5E8nd5mWuBjl3EmDLSIeC
+  AEA054SX5fumB3x83fLXQMl4Yw9nje/d8PkJgOUJOfCi5+P2I/YJ5YhjHpozvspN
+  cphsPbIxhkkKY+8YKXQRoHZPNuu0QdMHH6gvYTdjLmz9s4MICkp0Kg5UmWL96oCR
+  IZqb0JCjioPrrG3n/WV/ix5rPQ9MffHVPDFRD4wlbazwYn+A+KB0TxXJndHY9e6x
+  u7vZCyU93PFHpp/w270tu8VbayZSbmxF/oCsRuzWD0+xVsgLejqfWBbyGqwis995
+  p1I1Aujksa9wuoPhNNl8J4zKV1YtYorUDA44xq1iJEUE+ChB
+  -----END CERTIFICATE-----
+date: 2018-02-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |2
+      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.
+email: djberg96@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
 - CHANGES
 - README
 - MANIFEST
-- ext/sunos/sunos.c
-- ext/extconf.rb
-- ext/version.h
-- ext/sunos/sunos.h
-test_files: 
-- test/tc_sunos.rb
-rdoc_options: []
-
-extra_rdoc_files: 
+- doc/top.txt
+files:
+- benchmarks/bench_ps.rb
+- examples/example_ps.rb
+- lib/aix/sys/proctable.rb
+- lib/darwin/sys/proctable.rb
+- lib/freebsd/sys/proctable.rb
+- lib/linux/sys/proctable.rb
+- lib/linux/sys/proctable/cgroup_entry.rb
+- lib/linux/sys/proctable/smaps.rb
+- lib/sunos/sys/proctable.rb
+- lib/sys-proctable.rb
+- lib/sys-top.rb
+- lib/sys/proctable.rb
+- lib/sys/proctable/version.rb
+- lib/sys/top.rb
+- lib/windows/sys/proctable.rb
 - CHANGES
-- README
 - MANIFEST
-- doc/top.txt
-- doc/solaris.txt
-- ext/sunos/sunos.c
-executables: []
-
-extensions: 
-- ext/extconf.rb
+- Rakefile
+- README
+- sys-proctable.gemspec
+homepage: http://github.com/djberg96/sys-proctable
+licenses:
+- Apache 2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-dependencies: []
-
+rubyforge_project: 
+rubygems_version: 2.6.11
+signing_key: 
+specification_version: 4
+summary: An interface for providing process table information
+test_files:
+- spec/sys_proctable_aix_spec.rb
+- spec/sys_proctable_all_spec.rb
+- spec/sys_proctable_darwin_spec.rb
+- spec/sys_proctable_freebsd_spec.rb
+- spec/sys_proctable_linux_spec.rb
+- spec/sys_proctable_sunos_spec.rb
+- spec/sys_proctable_windows_spec.rb
+- spec/sys_top_spec.rb

data/doc/freebsd.txt

@@ -1,90 +0,0 @@
-= Description
-   sys-proctable
-
-   A Ruby interface to the 'ps' command.  This is a C extension, not parsed
-   output.  For FreeBSD, data is read directly out of the /proc filesystem.
-
-= Synopsis
-   require 'sys/proctable'
-   include Sys
-
-   # Everything
-   ProcTable.ps{ |p|
-      puts p.pid.to_s
-      puts p.comm
-      ...
-   }
-
-   or
-
-   # Just one process
-   p = ProcTable.ps(2123)
-   puts p.pid.to_s
-   puts p.comm
-   ...
-
-   or
-
-   # Return the results as an array of ProcTableStructs
-   a = ProcTable.ps()
-   a.each do |p|
-      puts a.pid
-      ...
-   end
-
-= Constants
-VERSION
-   Returns the current version number for this package (as a string).
-
-= Class Methods
-ProcTable.fields
-   Returns an array of fields available on the current OS.
-
-ProcTable.ps(pid = nil)
-ProcTable.ps{ |s| ... }
-   If no pid's or processes are included as arguments, in block form it
-   returns a struct of type ProcTableStruct for every process in the proc
-   table.  Otherwise it returns an array of ProcTableStruct's.
-
-   If a pid argument is provided, a single ProcTable struct is returned, or
-   nil if the pid is not found.
-
-= Exception Classes
-ProcTableError < StandardError
-   Raised if the /proc field is unreadable and/or unmounted.
-
-= Supported fields
-   You can view the supported fields with the "fields()" class method.
-    
-= Future Plans
-   Add a pure-ruby version as an alternative
-   Add support for other *BSD flavors
-   Add ttydev info
-   Add a sysctl version
-
-= Known Bugs
-   The kvm version for FreeBSD 5.x does not support all of the fields that
-   the 4.x version supports.
-    
-   If you find any other bugs please log them on the project
-   page at http://www.rubyforge.org/projects/sysutils
-
-= License
-   Ruby's
-
-= Copyright
-   (C) 2003-2006 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
-   djberg96 at nospam at gmail dot com
-   imperator on IRC (Freenode)
-
-= See Also
-   ps, proc

data/doc/hpux.txt

@@ -1,77 +0,0 @@
-= Description
-   sys-proctable
-
-   A Ruby version of the 'ps' command.  This is a C extension, not parsed
-   output.  For HP-UX, proc structs are grabbed via the pstat_getproc() call.
-
-= Synopsis
-   require 'sys/proctable'
-   include Sys
-
-   # Everything
-   ProcTable.ps{ |p|
-      puts p.pid.to_s
-      puts p.comm
-      ...
-   }
-
-   or
-
-   # Return the results as an array of ProcTableStructs
-   a = ProcTable.ps()
-   a.each do |p|
-      puts a.pid
-      ...
-   end
-
-= Constants
-VERSION
-   Returns the current version number for this package (as a string).
-
-= Class Methods
-ProcTable.fields
-   Returns an array of fields available on the current OS.
-
-ProcTable.ps(pid=nil)
-ProcTable.ps{ |s| ... }
-   Returns a struct of type ProcTableStruct for every process in the proc
-   table in block form.  Otherwise it returns an array of ProcTableStruct's.
-
-   If a pid is provided then a single ProcTable struct is returned, or nil
-   if the pid is not found.
-
-= Supported fields
-   You can view the supported fields with the "fields()" class method.
-
-= Future Plans
-   Have the flags field return a meaningful value.
-
-= Notes
-   The "comm" field isn't really part of the psinfo struct.  It is just a copy
-   (i.e. is identical to) the "fname" field.  I added it to provide a degree
-   of consistency between all of the platforms.  I will also make a point
-   of adding it to any future platform releases.
-
-= Known Bugs
-   None that I'm aware of.  Please log any bugs on the project page at
-   http://www.rubyforge.org/projects/sysutils
-
-= License
-   Ruby's
-
-= Copyright
-   (C) 2003-2006 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
-   djberg96 at nospam at gmail dot com
-   imperator on IRC (Freenode)
-
-= See Also
-   ps, proc