sys-proctable 0.7.6 → 1.2.4

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,48 @@
+require 'rubygems'
+
+Gem::Specification.new do |spec|
+  spec.name       = 'sys-proctable'
+  spec.version    = '1.2.4'
+  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.rdoc',
+    'LICENSE',
+    'MANIFEST.rdoc',
+    'Rakefile',
+    'README.md',
+    'sys-proctable.gemspec'
+  ]
+
+  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
+    platforms are supported and, while different platforms may return
+    different information, the external interface is identical across
+    platforms.
+  EOF
+end

metadata

@@ -1,73 +1,156 @@
---- !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.4
 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
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEcDCCAtigAwIBAgIBATANBgkqhkiG9w0BAQsFADA/MREwDwYDVQQDDAhkamJl
+  cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+  MB4XDTE4MDMxODE1MjIwN1oXDTI4MDMxNTE1MjIwN1owPzERMA8GA1UEAwwIZGpi
+  ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
+  bTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBALgfaroVM6CI06cxr0/h
+  A+j+pc8fgpRgBVmHFaFunq28GPC3IvW7Nvc3Y8SnAW7pP1EQIbhlwRIaQzJ93/yj
+  u95KpkP7tA9erypnV7dpzBkzNlX14ACaFD/6pHoXoe2ltBxk3CCyyzx70mTqJpph
+  75IB03ni9a8yqn8pmse+s83bFJOAqddSj009sGPcQO+QOWiNxqYv1n5EHcvj2ebO
+  6hN7YTmhx7aSia4qL/quc4DlIaGMWoAhvML7u1fmo53CYxkKskfN8MOecq2vfEmL
+  iLu+SsVVEAufMDDFMXMJlvDsviolUSGMSNRTujkyCcJoXKYYxZSNtIiyd9etI0X3
+  ctu0uhrFyrMZXCedutvXNjUolD5r9KGBFSWH1R9u2I3n3SAyFF2yzv/7idQHLJJq
+  74BMnx0FIq6fCpu5slAipvxZ3ZkZpEXZFr3cIBtO1gFvQWW7E/Y3ijliWJS1GQFq
+  058qERadHGu1yu1dojmFRo6W2KZvY9al2yIlbkpDrD5MYQIDAQABo3cwdTAJBgNV
+  HRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUFZsMapgzJimzsbaBG2Tm8j5e
+  AzgwHQYDVR0RBBYwFIESZGpiZXJnOTZAZ21haWwuY29tMB0GA1UdEgQWMBSBEmRq
+  YmVyZzk2QGdtYWlsLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAW2tnYixXQtKxgGXq
+  /3iSWG2bLwvxS4go3srO+aRXZHrFUMlJ5W0mCxl03aazxxKTsVVpZD8QZxvK91OQ
+  h9zr9JBYqCLcCVbr8SkmYCi/laxIZxsNE5YI8cC8vvlLI7AMgSfPSnn/Epq1GjGY
+  6L1iRcEDtanGCIvjqlCXO9+BmsnCfEVehqZkQHeYczA03tpOWb6pon2wzvMKSsKH
+  ks0ApVdstSLz1kzzAqem/uHdG9FyXdbTAwH1G4ZPv69sQAFAOCgAqYmdnzedsQtE
+  1LQfaQrx0twO+CZJPcRLEESjq8ScQxWRRkfuh2VeR7cEU7L7KqT10mtUwrvw7APf
+  DYoeCY9KyjIBjQXfbj2ke5u1hZj94Fsq9FfbEQg8ygCgwThnmkTrrKEiMSs3alYR
+  ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
+  WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
+  -----END CERTIFICATE-----
+date: 
+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.rdoc
+- README.md
+- MANIFEST.rdoc
+files:
+- benchmarks/bench_ips_ps.rb
+- 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
-- CHANGES
-- README
-- MANIFEST
-- ext/sunos/sunos.c
-- ext/extconf.rb
-- ext/version.h
-- ext/sunos/sunos.h
-test_files: 
-- test/tc_sunos.rb
+- lib/windows/sys/proctable.rb
+- CHANGES.rdoc
+- LICENSE
+- MANIFEST.rdoc
+- Rakefile
+- README.md
+- sys-proctable.gemspec
+homepage: http://github.com/djberg96/sys-proctable
+licenses:
+- 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: []
-
-extra_rdoc_files: 
-- CHANGES
-- README
-- MANIFEST
-- doc/top.txt
-- doc/solaris.txt
-- ext/sunos/sunos.c
-executables: []
-
-extensions: 
-- ext/extconf.rb
+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: []
-
+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
+- 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

metadata.gz.sig

@@ -0,0 +1,7 @@
+������s���r���k��S�P�܁�&����%J0h�@�����h"�ۤ
+����LJ<��=�.����H)&��	�/ۈ�j����}��L���&S+�|)Y����$��h7�
+U
��4m
+�;��19��Wު�c@;�uc���s�2``#�F�K!\Ӓ��%��p�[�Y�R/9CX�G�0x����I�2<�9ES��������?{C��ߵ����T�׏`��)��pq�*�G��v')�$��?���$��	&,��
+�0�L:��-��ћ�|��J2�+64Fk_�T�*Qxk��� ���֪Y���8�l���tj{E�o�
+�;���׎�Y
+'S)!�_q���g<k�C�P����'b m_���E-�7g

data/MANIFEST

@@ -1,41 +0,0 @@
-CHANGES
-INSTALL
-MANIFEST
-Rakefile
-sys-proctable.gemspec
-
-doc/freebsd.txt
-doc/hpux.txt
-doc/linux.txt
-doc/solaris.txt
-doc/top.txt
-doc/windows.txt
-
-ext/extconf.rb
-ext/bsd/bsd.c
-ext/darwin/darwin.c
-ext/freebsd/freebsd.c
-ext/freebsd/freebsd.h
-ext/hpux/hpux.c
-ext/hpux/hpux.h
-ext/linux/linux.c
-ext/linux/linux.h
-ext/sunos/sunos.c
-ext/sunos/sunos.h
-ext/version.h
-
-examples/test_ps.rb
-
-lib/top.rb
-
-lib/sys/windows.rb
-
-test/tc_all.rb
-test/tc_freebsd.rb
-test/tc_hpux.rb
-test/tc_linux.rb
-test/tc_sunos.rb
-test/tc_top.rb
-test/tc_windows.rb
-test/tc_kvm_bsd.rb
-test/test_memleak.rb

data/README

@@ -1,140 +0,0 @@
-= Description
-   A Ruby interface for gathering process information.
-
-= Prerequisites
-=== Unix
-   Ruby 1.8.0 or later.
-=== MS Windows
-   Ruby 1.8.2 or later.
-
-= Supported Platforms
-* Windows NT family (NT, 2000, XP, etc)
-* Linux
-* FreeBSD (/proc or kvm)
-* Solaris
-* HP-UX
-* OS X
-
-= Installation
-* rake test (optional)
-* rake install
-
-= Synopsis
-   require 'sys/proctable'
-   include Sys
-
-   # Everything
-   ProcTable.ps{ |p|
-      puts p.pid.to_s
-      puts p.comm
-      ...
-   }
-
-   or
-
-   # 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 a.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.
-
-   If you're building C source code, the ts_all.rb file is autogenerated for
-   you.
-
-= Known Issues
-=== BSD
-   If you're building on FreeBSD, a standard /proc filesystem read approach is
-   used if mounted. Otherwise, a kvm interface is used. There are more fields
-   available with the kvm interface, but keep in mind that you need to be a
-   member of the kvm group (or root) to use this. You can tweak the extconf.rb
-   file manually if you want to force the issue.
-
-   Not all fields are available on FreeBSD 5.x (yet). OpenBSD and NetBSD are
-   not yet supported.
-
-=== 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
-   At the moment you do not get the full command line string. The code required
-   to get this information is obnoxious and I don't have any compelling desire
-   to add it. However, if you're willing to submit a patch I'll accept it.
-
-   You can find a good starting point with the OS X code found in Dan Urist's
-   Proc::ProcessTable module. You can find that module on CPAN. Point your
-   browser at http://search.cpan.org.
-
-=== Misc
-   If you build your library as a C extension (which is what will happen if
-   you run the 'build', 'test', or 'install' Rake tasks), then the windows.rb
-   file under 'lib/sys/' is renamed to 'windows.orig'. This is necessary to
-   prevent mkmf from auto-installing it during the 'make install' phase.
-
-   The 'clean' Rake task will rename it back to 'windows.rb'.
-
-=== Thread Safety
-   I am not currently using a thread-safe version of readdir().  I am not
-   especially concerned about it either.  If you are trying to read information
-   out of /proc from different threads at the same time there is something
-   seriously wrong with your code logic. Using readdir_r() still won't solve
-   all potential thread safety issues anyway.
-
-= Future Plans
-   I'm considering using a pure Ruby version for Linux. 
-
-   Research has indicated that the kvm approach is less favored than a sysctl
-   approach on BSD variants. I will try to add this interface in the 0.8.0
-   release.
-
-= Acknowledgements
-   This package is largely 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.
-
-   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. There are a few other major platforms
-   out there, namely AIX, OpenBSD, and IRIX, among others, that I would
-   like to see ports for. There are two ways you can help - either submit code
-   for your particular platform or give me an account on your platform so I can
-   develop on it.
-
-= More documentation
-   See the documentation under the 'doc' directory for your platform for more
-   information, including platform specific notes and issues.
-
-= License
-   Ruby's
-    
-= Copyright
-   (C) 2003-2007 Daniel J. Berger
-   All Rights Reserved.
-
-= Author
-   Daniel J. Berger
-   djberg96 at nospam at gmail dot com
-   imperator on IRC (Freenode)