proc-wait3 1.8.1 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a183dbb97844a741719f7e1b6827d11f433c36995607078ea25face079e05255
-  data.tar.gz: b56692543a16b3334fc2b64a849007a0bb95755534e4b09b4c1851c123711080
+  metadata.gz: 833ae8756453e432d042610abec187891cd8c53c9c03f942a247cc0f6488979b
+  data.tar.gz: 873ae57b81c82f55f9a34e975ae53eb71319d8c65fde352bfef7bd62f9000cb4
 SHA512:
-  metadata.gz: 1ef23ac082d86b18c7c8c39396343f98a7d6f1e7f64299cdd5a4f9ed5f0341caeb857a99533d031f665df861b808288c15d7cde0ceb5c443ef8d1b47ed17cdd3
-  data.tar.gz: b7b32cf67ff465561213cc99446b1c34b048524a0babb276c42e9a8811e06210945bc7db4c2bb4f73e8c97b76559e6dc883d6dcc85adba9c19f8193c343e0706
+  metadata.gz: 2798ca928c06bd913b04665f7adcd02ac73f2d6d742e30c7d08e15a56c7a284e9cd2cc3b2cb9d8c923fa82d1297fbe30488de848504ffef0cd3dd9a776a6146a
+  data.tar.gz: 28976b3335794b2cf0bd0002dafa58c5d3b8eec326d52bd085c34afebc79f3fff838b3c2da12779089d008b037dd7b7ae56b2b2c0f0299e95eb34bb163ff88af

data/{CHANGES.rdoc → CHANGES.md}

@@ -1,8 +1,14 @@
-== 1.8.1 - 8-Apr-2020
+## 1.9.0 - 7-Jan-2021
+* Switched from test-unit to rspec.
+* Skip some tests on Darwin because of EINTR errors.
+* Switched from rdoc to markdown since github isn't rendering rdoc properly.
+* Added a Gemfile.
+
+## 1.8.1 - 8-Apr-2020
 * Added a LICENSE file to the distribution as required by the Apache-2.0 license.
 * Add an explicit .rdoc extension to the README, CHANGES and MANIFEST files.
 
-== 1.8.0 - 20-Feb-2019
+## 1.8.0 - 20-Feb-2019
 * Changed license to Apache-2.0.
 * Now requires Ruby 2.2 or later.
 * Now checks for <bsd/string.h> header and include's it if found. This was
@@ -13,21 +19,21 @@
 * Removed some old macro checks/definitions that were no longer relevant.
 * Added a proc-wait3.rb file for convenience.
 
-== 1.7.3 - 21-Nov-2015
+## 1.7.3 - 21-Nov-2015
 * Fixed a bug where tv_usec was divided by 1k instead of 1e6. Thanks go to
   Jason Gladish for the spot.
 * This gem is now signed.
 * The gem related tasks in the Rakefile now assume Rubygems 2.x.
 
-== 1.7.2 - 5-Sep-2014
+## 1.7.2 - 5-Sep-2014
 * Added support for the RUSAGE_THREAD constant on Linux. Thanks go to
   Bruno Michel for the patch.
 
-== 1.7.1 - 24-Apr-2014
+## 1.7.1 - 24-Apr-2014
 * Explicitly check for and include sys/resource.h because Debian. Thanks
   go to Christos Trochalakis for the spot.
 
-== 1.7.0 - 6-Apr-2014
+## 1.7.0 - 6-Apr-2014
 * The wait3 and wait4 methods no longer set $? to a custom struct. The builtin
   variable is still set, but if you need the custom Struct::ProcStat information
   then use the $last_status global instead, or just use the return value. This
@@ -36,12 +42,12 @@
 * Some build warning fixes for BSD platforms.
 * Some test updates for BSD and Solaris.
 
-== 1.6.0 - 28-Aug-2011
+## 1.6.0 - 28-Aug-2011
 * Removed the getrlimit and setrlimit methods. Ruby has supported these methods
   since Ruby 1.8.5, so I think it's time to finally dump them.
 * Fixed two build warnings regarding unused variables and one 32/64 cast warning.
 
-== 1.5.6 - 7-Jan-2010
+## 1.5.6 - 7-Jan-2010
 * Checks are now made for the si_fd, si_utime, si_status and si_stime siginfo_t
   struct members. This addresses build failures on OS X 10.5 and later where
   those struct members went mysteriously MIA.
@@ -51,7 +57,7 @@
 * Updates to the README.
 * Source code moved to github.
 
-== 1.5.5 - 8-Aug-2009
+## 1.5.5 - 8-Aug-2009
 * Now compatible with Ruby 1.9.x.
 * License changed to Artistic 2.0.
 * Added test-unit 2.x as a development dependency.
@@ -62,7 +68,7 @@
 * Example files renamed to avoid any confusion with actual test files.
 * Several Rake tasks added to run individual example programs.
 
-== 1.5.4 - 7-Feb-2008
+## 1.5.4 - 7-Feb-2008
 * ALERT! ALERT! Now auto-patches your mkmf.rb file to add the 'have_const'
   method if it's not already found. This is necessary to determine if certain
   enum values exist on your system. Your original mkmf.rb is backed up first
@@ -73,7 +79,7 @@
 * Fixed the extconf.rb file so that it sets the target directory properly.
 * No source code changes (except for comment updates and a version bump).
 
-== 1.5.3 - 25-Oct-2006
+## 1.5.3 - 25-Oct-2006
 * Because not all platforms support automatically converting signal names
   into their equivalent numbers, the Process.pause method now accepts names
   or numbers.  It will raise an ArgumentError if you try to use a signal name
@@ -86,7 +92,7 @@
 * Internal fixes for platforms that don't support the strlcpy() function.
 * Minor update for the test_pause.rb example program.
 
-== 1.5.2 - 24-Jul-2006
+## 1.5.2 - 24-Jul-2006
 * Fixed the way I was handling whether or not Ruby already defined the various
   RLIMIT constants within wait3.c.
 * Fixed the way in which certain RLIM constants were being converted. I
@@ -95,7 +101,7 @@
 * Added the WAIT3_VERSION constant.
 * The getrlimit and setrlimit tests are now skipped for Ruby 1.8.5 or later.
 
-== 1.5.1 - 13-Jul-2006
+## 1.5.1 - 13-Jul-2006
 * Fixed bugs with improper values being set for some of the rlimit constants.
 * Cleaned up a few warnings related to signed-ness for the RLIM_xxx constants.
 * Now only sets the various rlimit constants if they're not already defined
@@ -103,21 +109,21 @@
 * Some internal cleanup.
 * Created a gemspec and added a gem to RubyForge.
 
-== 1.5.0 - 12-Jun-2006
+## 1.5.0 - 12-Jun-2006
 * Removed the '?' character from the various struct members, since Ruby
   no longer (properly) handles them.
 * Fixed a 64 bit bug related to rb_struct_define.
 * Added some more tests.
 
-== 1.4.3 - 28-Jun-2005
+## 1.4.3 - 28-Jun-2005
 * Added more #ifdef checks for some of the process flags which, it turns
   out, are not defined in earlier versions of Linux.
 
-== 1.4.2 - 14-Jun-2005
+## 1.4.2 - 14-Jun-2005
 * Fixed a syntax error that could cause the build to fail.
 * Removed some (but not all) possible warnings from gcc -Wall.
 
-== 1.4.1 - 13-Jun-2005
+## 1.4.1 - 13-Jun-2005
 * Added support for the Linux 2.6.9+ kernel (by adding more preprocessor
   constant checks, which may help with other platforms as well).
 * Moved project to RubyForge.
@@ -125,34 +131,34 @@
 * Removed the wait3.rd file.
 * Minor fix for the test_waitid.rb sample program.
 
-== 1.4.0 - 16-Feb-2005
+## 1.4.0 - 16-Feb-2005
 * Added the getrusage method.
 * Added test cases and documentation for getrusage.
 * Renamed a couple test files in the examples directory.
 
-== 1.3.0 - 14-Feb-2005
+## 1.3.0 - 14-Feb-2005
 * Added the pause and sigsend methods.
 * I had to modify the process type constants to include the "P_", because
   Ruby already has Process::GID and Process::UID defined.  That makes this
   release incompatible with previous versions.
 * Updated tests and documentation.
 
-== 1.2.0 - 7-Feb-2005
+## 1.2.0 - 7-Feb-2005
 * Added the Proc.waitid method (for those platforms that support it). 
 * Made the wait3.c file more rdoc friendly.
 * Added a test_waitid.rb file in the examples directory.
 
-== 1.1.1 - 10-Jan-2005
+## 1.1.1 - 10-Jan-2005
 * Eliminated some (harmless) warnings that cropped up in 1.8.2
 * Moved the "examples" directory to the toplevel directory.
 * Made docs slightly more rdoc friendly
 
-== 1.1.0 - 14-Sep-2004
+## 1.1.0 - 14-Sep-2004
 * Modified setup and source to handle the possibility that wait3() might
   be defined while wait4() is not (e.g. HPUX).
 * Modified the test scripts in the examples directory to play nice on HPUX
   and Darwin.
 * Added this file (oops).
 
-== 1.0.0 - 13-Sep-2004
+## 1.0.0 - 13-Sep-2004
 - Initial release

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org' do
+  gem 'rake'
+
+  group 'test' do
+    gem 'rspec', '~> 3.9'
+  end
+end

data/{MANIFEST.rdoc → MANIFEST.md}

@@ -1,8 +1,9 @@
-* CHANGES.rdoc
+* CHANGES.md
+* Gemfile
 * LICENSE
-* MANIFEST.rdoc
+* MANIFEST.md
 * Rakefile
-* README.rdoc
+* README.md
 * proc-wait3.gemspec
 * certs/djberg96_pub.pem
 * doc/wait3.txt

data/{README.rdoc → README.md}

@@ -1,28 +1,30 @@
-= Description
+## Description
 Adds the wait3, wait4, waitid, pause, sigsend, and getrusage methods to the Process module.
 
-= Installation
-  gem install proc-wait3
+## Installation
+`gem install proc-wait3`
 
-= Synopsis
-  require 'proc/wait3'
+## Synopsis
+```ruby
+require 'proc/wait3'
 
-  pid = fork{
-    sleep 1
-    exit 2
-  }
+pid = fork{
+  sleep 1
+  exit 2
+}
 
-  puts Time.now.to_s
-  Process.wait3
-  puts $?.exitstatus # => 2
+puts Time.now.to_s
+Process.wait3
+puts $?.exitstatus # => 2
+```
 
-= Tested Platforms
-  * Solaris
-  * Linux
-  * FreeBSD
-  * OS X
+## Tested Platforms
+* Solaris
+* Linux
+* FreeBSD
+* OS X
 
-= Warnings
+## Warnings
 Linux users who compile with gcc -Wall will notice a few warnings. These
 are harmless (and unavoidable atm).
 
@@ -30,8 +32,11 @@ Linux users may also notice warnings about implicit declarations. These
 are also harmless, and can be silenced by installing the libbsd-dev package
 first.
 
-= Integration with Ruby's process.c
+On Darwin these methods will likely fail with Errno::EINTR unless you pass
+the WNOHANG flag. I am not sure why, I can only speculate that the child is
+receiving a signal from either the Ruby interpreter or the operating system.
 
+## Integration with Ruby's process.c
 I considered simply providing a patch to the core process.c file, but I
 decided against it for two reasons.  First, I wanted to get something
 out more quickly rather than waiting for approval from the core developers
@@ -44,6 +49,5 @@ The overloaded methods are also overkill, and do nothing but save me the
 trouble of typing the word "status", since all they're for is comparing or
 operating on the status attribute.
 
-= Additional Documentation
-
+## Additional Documentation
 Please see the doc/wait3.txt file for detailed documentation.

data/Rakefile

@@ -1,20 +1,22 @@
 require 'rake'
 require 'rake/clean'
-require 'rake/testtask'
+require 'rspec/core/rake_task'
 require 'fileutils'
 require 'rbconfig'
 include RbConfig
 
 CLEAN.include(
-  '**/*.gem',               # Gem files
-  '**/*.rbc',               # Rubinius
-  '**/*.o',                 # C object file
-  '**/*.log',               # Ruby extension build log
-  '**/Makefile',            # C Makefile
-  '**/conftest.dSYM',       # OS X build directory
-  "**/*.#{CONFIG['DLEXT']}" # C shared object
+  '**/*.gem',                # Gem files
+  '**/*.rbc',                # Rubinius
+  '**/*.o',                  # C object file
+  '**/*.log',                # Ruby extension build log
+  '**/Makefile',             # C Makefile
+  '**/conftest.dSYM',        # OS X build directory
+  "**/*.#{CONFIG['DLEXT']}", # C shared object
+  '**/*.lock'                # Bundler
 )
 
+
 desc "Build the source (but don't install it)"
 task :build => [:clean] do |t|
   Dir.chdir('ext') do
@@ -30,7 +32,7 @@ namespace :gem do
     require 'rubygems/package'
     spec = eval(IO.read('proc-wait3.gemspec'))
     spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
-    Gem::Package.build(spec, true)
+    Gem::Package.build(spec)
   end
 
   desc "Install the proc-wait3 gem"
@@ -67,11 +69,9 @@ namespace :example do
   end
 end
 
-Rake::TestTask.new do |t|
-  task :test => [:build]
-  t.libs << 'ext'
-  t.warning = true
-  t.verbose = true
+desc "Run the test suite"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = '-Iext'
 end
 
-task :default => :test
+task :default => [:build, :spec]

data/ext/proc/wait3.c

@@ -954,8 +954,8 @@ void Init_wait3()
   rb_define_const(rb_mProcess, "RUSAGE_THREAD", INT2FIX(RUSAGE_THREAD));
 #endif
 
-  /* 1.8.1: The version of the proc-wait3 library */
-  rb_define_const(rb_mProcess, "WAIT3_VERSION", rb_str_freeze(rb_str_new2("1.8.1")));
+  /* 1.9.0: The version of the proc-wait3 library */
+  rb_define_const(rb_mProcess, "WAIT3_VERSION", rb_str_freeze(rb_str_new2("1.9.0")));
 
   /* Define this last in our Init_wait3 function */
   rb_define_readonly_variable("$last_status", &v_last_status);

data/proc-wait3.gemspec

@@ -2,27 +2,24 @@ require 'rubygems'
 
 Gem::Specification.new do |spec|
   spec.name       = 'proc-wait3'
-  spec.version    = '1.8.1'
+  spec.version    = '1.9.0'
   spec.author     = 'Daniel J. Berger'
   spec.license    = 'Apache-2.0'
   spec.email      = 'djberg96@gmail.com'
   spec.homepage   = 'https://github.com/djberg96/proc-wait3'
   spec.summary    = 'Adds wait3, wait4 and other methods to the Process module'
-  spec.test_file  = 'test/test_proc_wait3.rb'
+  spec.test_file  = 'spec/proc_wait3_spec.rb'
   spec.extensions = ['ext/extconf.rb']
   spec.files      = Dir['**/*'].reject{ |f| f.include?('git') }
   spec.cert_chain = Dir['certs/*']
 
-  spec.extra_rdoc_files  = ['CHANGES.rdoc', 'README.rdoc', 'MANIFEST.rdoc', 'ext/proc/wait3.c']
-
-  spec.add_development_dependency('test-unit')
   spec.add_development_dependency('rake')
-  spec.required_ruby_version = '>= 2.2'
+  spec.add_development_dependency('rspec', '~> 3.9')
 
   spec.metadata = {
     'homepage_uri'      => 'https://github.com/djberg96/proc-wait3',
     'bug_tracker_uri'   => 'https://github.com/djberg96/proc-wait3/issues',
-    'changelog_uri'     => 'https://github.com/djberg96/proc-wait3/blob/master/CHANGES',
+    'changelog_uri'     => 'https://github.com/djberg96/proc-wait3/blob/master/CHANGES.md',
     'documentation_uri' => 'https://github.com/djberg96/proc-wait3/wiki',
     'source_code_uri'   => 'https://github.com/djberg96/proc-wait3',
     'wiki_uri'          => 'https://github.com/djberg96/proc-wait3/wiki'

data/spec/proc_wait3_spec.rb

@@ -0,0 +1,234 @@
+#######################################################################
+# proc_wait3_spec.rb
+#
+# Test suite for the Ruby proc-wait3 library. You should run these
+# via the 'rake spec' task.
+#######################################################################
+require 'proc/wait3'
+require 'rspec'
+require 'rbconfig'
+
+RSpec.describe Process do
+  let(:solaris) { RbConfig::CONFIG['host_os'] =~ /sunos|solaris/i }
+  let(:darwin)  { RbConfig::CONFIG['host_os'] =~ /darwin|osx/i }
+  let(:hpux)    { RbConfig::CONFIG['host_os'] =~ /hpux/i }
+  let(:linux)   { RbConfig::CONFIG['host_os'] =~ /linux/i }
+  let(:freebsd) { RbConfig::CONFIG['host_os'] =~ /bsd/i }
+
+  let(:proc_stat_members) {
+    %i[
+      pid status utime stime maxrss ixrss idrss isrss minflt majflt nswap
+      inblock oublock msgsnd msgrcv nsignals nvcsw nivcsw stopped signaled
+      exited success coredump exitstatus termsig stopsig
+    ]
+  }
+
+  before do
+    @proc_stat = nil
+  end
+
+  example "version constant is set to expected value" do
+    expect(Process::WAIT3_VERSION).to eq('1.9.0')
+    expect(Process::WAIT3_VERSION).to be_frozen
+  end
+
+  example "wait3 method is defined" do
+    expect(Process).to respond_to(:wait3)
+  end
+
+  example "wait3 works as expected" do
+    skip 'wait3 test skipped on this platform' if darwin
+    fork{ sleep 0.5 }
+    expect{ Process.wait3 }.not_to raise_error
+  end
+
+  example "wait3 returns the expected proc status members" do
+    skip 'wait3 test skipped on this platform' if darwin
+    fork{ sleep 0.5 }
+    expect{ @proc_stat = Process.wait3 }.not_to raise_error
+    expect( @proc_stat.members).to eq(proc_stat_members)
+  end
+
+  example "wait3 with WNOHANG works as expected" do
+    fork{ sleep 0.5 }
+    expect{ Process.wait3(Process::WNOHANG) }.not_to raise_error
+  end
+
+  example "wait3 sets and returns $last_status to expected values" do
+    skip 'wait3 test skipped on this platform' if darwin
+    fork{ sleep 0.5 }
+    Process.wait3
+    expect($last_status).to be_kind_of(Struct::ProcStat)
+    expect($last_status).not_to be_nil
+  end
+
+  example "wait3 sets pid and status members of $?" do
+    skip 'wait3 test skipped on this platform' if darwin
+    fork{ sleep 0.5 }
+    Process.wait3
+    expect($?).not_to be_nil
+  end
+
+  example "wait3 returns frozen struct" do
+    skip 'wait3 test skipped on this platform' if darwin
+    fork{ sleep 0.5 }
+    struct = Process.wait3
+    expect(struct).to be_frozen
+  end
+
+  example "getdtablesize works as expected" do
+    skip 'getdtablesize skipped on this platform' unless solaris
+
+    expect(Process).to respond_to(:getdtablesize)
+    expect(Process.getdtablesize).to be_kind_of(Fixnum)
+    assert(Process.getdtablesize > 0)
+  end
+
+  example "wait4 method is defined" do
+    skip 'wait4 test skipped on this platform' if hpux
+    expect(Process).to respond_to(:wait4)
+  end
+
+  example "wait4 requires at least one argument" do
+    skip 'wait4 test skipped on this platform' if hpux
+    expect{ Process.wait4 }.to raise_error(ArgumentError)
+  end
+
+  example "wait4 works as expected" do
+    skip 'wait4 test skipped on this platform' if hpux || darwin
+
+    pid = fork{ sleep 0.5 }
+    expect{ @proc_stat = Process.wait4(pid) }.not_to raise_error
+    expect(@proc_stat).to be_kind_of(Struct::ProcStat)
+  end
+
+  example "wait4 sets and returns $last_status to expected values" do
+    skip 'wait4 test skipped on this platform' if hpux || darwin
+
+    pid = fork{ sleep 0.5 }
+    Process.wait4(pid)
+    expect($last_status).to be_kind_of(Struct::ProcStat)
+    expect($last_status).not_to be_nil
+  end
+
+  example "wait4 sets pid and status members of $?" do
+    skip 'wait4 test skipped on this platform' if hpux || darwin
+
+    pid = fork{ sleep 0.5 }
+    Process.wait4(pid)
+    expect($?).not_to be_nil
+  end
+
+  example "wait4 returns frozen struct" do
+    skip 'wait4 test skipped on this platform' if hpux || darwin
+
+    pid = fork{ sleep 0.5 }
+    struct = Process.wait4(pid)
+    expect(struct).to be_frozen
+  end
+
+  example "waitid method is defined" do
+    skip 'waitid test skipped on this platform' if hpux || darwin || freebsd
+
+    expect(Process).to respond_to(:waitid)
+  end
+
+  example "waitid method works as expected" do
+    skip 'waitid test skipped on this platform' if hpux || darwin || freebsd
+
+    pid = fork{ sleep 0.5 }
+    expect{ Process.waitid(Process::P_PID, pid, Process::WEXITED) }.not_to raise_error
+  end
+
+  example "waitid method raises expected errors if wrong argument type is passed" do
+    skip 'waitid test skipped on this platform' if hpux || darwin || freebsd
+
+    pid = fork{ sleep 0.5 }
+    expect{ Process.waitid("foo", pid, Process::WEXITED) }.to raise_error(TypeError)
+    expect{ Process.waitid(Process::P_PID, pid, "foo") }.to raise_error(TypeError)
+    expect{ Process.waitid(Process::P_PID, "foo", Process::WEXITED) }.to raise_error(TypeError)
+  end
+
+  example "waitid method raises expected error if invalid argument is passed" do
+    skip 'waitid test skipped on this platform' if hpux || darwin || freebsd
+
+    fork{ sleep 0.5 }
+    expect{ Process.waitid(Process::P_PID, 99999999, Process::WEXITED) }.to raise_error(Errno::ECHILD)
+  end
+
+  example "sigsend method is defined" do
+    skip 'sigsend test skipped on this platform' unless solaris
+
+    expect(Process).to respond_to(:sigsend)
+  end
+
+  example "sigsend works as expected" do
+    skip 'sigsend test skipped on this platform' unless solaris
+
+    pid = fork{ sleep 0.5 }
+    expect{ Process.sigsend(Process::P_PID, pid, 0) }.not_to raise_error
+  end
+
+  example "getrusage method is defined" do
+    expect(Process).to respond_to(:getrusage)
+  end
+
+  example "getrusage works as expected" do
+    fork{ sleep 0.5 }
+
+    expect{ Process.getrusage }.not_to raise_error
+    expect{ Process.getrusage(true) }.not_to raise_error
+  end
+
+  example "getrusage can get thread info on Linux" do
+    skip 'getrusage only tested on Linux' unless linux
+    expect{ Process.getrusage(Process::RUSAGE_THREAD) }.not_to raise_error
+  end
+
+  example "getrusage returns the expected struct" do
+    skip 'getrusage only tested on Linux' unless linux
+
+    fork{ sleep 0.5 }
+    expect(Process.getrusage).to be_kind_of(Struct::RUsage)
+    expect(Process.getrusage.stime).to be_kind_of(Float)
+    expect(Process.getrusage.utime).to be_kind_of(Float)
+  end
+
+  example "pause method is defined" do
+    expect(Process).to respond_to(:pause)
+  end
+
+  example "expected constants are defined" do
+    skip 'wait constant check skipped on this platform' if darwin || freebsd
+
+    expect(Process::WCONTINUED).not_to be_nil
+    expect(Process::WEXITED).not_to be_nil
+    expect(Process::WNOWAIT).not_to be_nil
+    expect(Process::WSTOPPED).not_to be_nil
+
+    skip 'WTRAPPED constant check skipped on this platform' if linux
+    expect(Process::WTRAPPED).not_to be_nil
+  end
+
+  example "expected process type flag constants are defined" do
+    skip 'process type flag check skipped on this platform' if linux || darwin || freebsd
+
+    expect(Process::P_ALL).not_to be_nil
+    expect(Process::P_CID).not_to be_nil
+    expect(Process::P_GID).not_to be_nil
+    expect(Process::P_PGID).not_to be_nil
+    expect(Process::P_PID).not_to be_nil
+    expect(Process::P_SID).not_to be_nil
+    expect(Process::P_UID).not_to be_nil
+
+    skip 'P_MYID constant check skipped on this platform' unless solaris
+    expect(Process::P_MYID).not_to be_nil
+  end
+
+  example "solaris-specific process type flags are defined on solaris" do
+    skip 'P_TASKID and P_PROJID constant check skipped on this platform' unless solaris
+
+    expect(Process::P_TASKID).not_to be_nil
+    expect(Process::P_PROJID).not_to be_nil
+  end
+end

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: proc-wait3
 version: !ruby/object:Gem::Version
-  version: 1.8.1
+  version: 1.9.0
 platform: ruby
 authors:
 - Daniel J. Berger
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -35,10 +35,10 @@ cert_chain:
   ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
   WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
   -----END CERTIFICATE-----
-date: 
+date: 2021-01-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: test-unit
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -52,19 +52,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.9'
 description: |2
       The proc-wait3 library adds the wait3, wait4, waitid, pause, sigsend,
       and getrusage methods to the Process module.
@@ -72,47 +72,37 @@ email: djberg96@gmail.com
 executables: []
 extensions:
 - ext/extconf.rb
-extra_rdoc_files:
-- CHANGES.rdoc
-- README.rdoc
-- MANIFEST.rdoc
-- ext/proc/wait3.c
+extra_rdoc_files: []
 files:
+- CHANGES.md
+- Gemfile
 - LICENSE
-- test
-- test/test_proc_wait3.rb
-- ext
-- ext/proc
-- ext/proc/wait3.c
-- ext/extconf.rb
+- MANIFEST.md
+- README.md
 - Rakefile
-- certs
 - certs/djberg96_pub.pem
-- examples
-- examples/example_wait4.rb
-- examples/example_wait3.rb
+- doc/wait3.txt
 - examples/example_getrusage.rb
 - examples/example_pause.rb
+- examples/example_wait3.rb
+- examples/example_wait4.rb
 - examples/example_waitid.rb
-- lib
+- ext/extconf.rb
+- ext/proc/wait3.c
 - lib/proc-wait3.rb
-- CHANGES.rdoc
-- doc
-- doc/wait3.txt
-- MANIFEST.rdoc
 - proc-wait3.gemspec
-- README.rdoc
+- spec/proc_wait3_spec.rb
 homepage: https://github.com/djberg96/proc-wait3
 licenses:
 - Apache-2.0
 metadata:
   homepage_uri: https://github.com/djberg96/proc-wait3
   bug_tracker_uri: https://github.com/djberg96/proc-wait3/issues
-  changelog_uri: https://github.com/djberg96/proc-wait3/blob/master/CHANGES
+  changelog_uri: https://github.com/djberg96/proc-wait3/blob/master/CHANGES.md
   documentation_uri: https://github.com/djberg96/proc-wait3/wiki
   source_code_uri: https://github.com/djberg96/proc-wait3
   wiki_uri: https://github.com/djberg96/proc-wait3/wiki
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -120,16 +110,16 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.2'
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
 summary: Adds wait3, wait4 and other methods to the Process module
 test_files:
-- test/test_proc_wait3.rb
+- spec/proc_wait3_spec.rb

data/test/test_proc_wait3.rb

@@ -1,227 +0,0 @@
-##################################################################
-# test_proc_wait3.rb
-#
-# Test suite for the Ruby proc-wait3 package. You should run this
-# via the 'test' rake task.
-##################################################################
-require 'proc/wait3'
-require 'test-unit'
-require 'rbconfig'
-
-class TC_Proc_Wait3 < Test::Unit::TestCase
-  def self.startup
-    @@solaris = RbConfig::CONFIG['host_os'] =~ /sunos|solaris/i
-    @@darwin  = RbConfig::CONFIG['host_os'] =~ /darwin|osx/i
-    @@hpux    = RbConfig::CONFIG['host_os'] =~ /hpux/i
-    @@linux   = RbConfig::CONFIG['host_os'] =~ /linux/i
-    @@freebsd = RbConfig::CONFIG['host_os'] =~ /bsd/i
-  end
-
-  def setup
-    @proc_stat = nil
-    @proc_stat_members = [
-      "pid", "status", "utime", "stime", "maxrss",
-      "ixrss", "idrss", "isrss", "minflt", "majflt", "nswap", "inblock",
-      "oublock", "msgsnd", "msgrcv", "nsignals", "nvcsw", "nivcsw",
-      "stopped", "signaled","exited","success","coredump","exitstatus",
-      "termsig", "stopsig"
-    ]
-
-    @proc_stat_members = @proc_stat_members.map{ |e| e.to_sym }
-  end
-
-  test "version constant is set to expected value" do
-    assert_equal('1.8.1', Process::WAIT3_VERSION)
-    assert_true(Process::WAIT3_VERSION.frozen?)
-  end
-
-  test "wait3 method is defined" do
-    assert_respond_to(Process, :wait3)
-  end
-
-  test "wait3 works as expected" do
-    fork{ sleep 0.5 }
-    assert_nothing_raised{ Process.wait3 }
-  end
-
-  test "wait3 returns the expected proc status membes" do
-    fork{ sleep 0.5 }
-    assert_nothing_raised{ @proc_stat = Process.wait3 }
-    assert_equal(@proc_stat_members, @proc_stat.members)
-  end
-
-  test "wait3 with WNOHANG works as expected" do
-    fork{ sleep 0.5 }
-    assert_nothing_raised{ Process.wait3(Process::WNOHANG) }
-  end
-
-  test "wait3 sets and returns $last_status to expected values" do
-    fork{ sleep 0.5 }
-    Process.wait3
-    assert_kind_of(Struct::ProcStat, $last_status)
-    assert_not_nil($last_status)
-  end
-
-  test "wait3 sets pid and status members of $?" do
-    fork{ sleep 0.5 }
-    Process.wait3
-    assert_not_nil($?)
-  end
-
-  test "wait3 returns frozen struct" do
-    fork{ sleep 0.5 }
-    struct = Process.wait3
-    assert_true(struct.frozen?)
-  end
-
-  test "getdtablesize works as expected" do
-    omit_unless(@@solaris, 'getdtablesize skipped on this platform')
-
-    assert_respond_to(Process, :getdtablesize)
-    assert_kind_of(Fixnum, Process.getdtablesize)
-    assert(Process.getdtablesize > 0)
-  end
-
-  test "wait4 method is defined" do
-    omit_if(@@hpux, 'wait4 test skipped on this platform')
-    assert_respond_to(Process,:wait4)
-  end
-
-  test "wait4 requires at least one argument" do
-    assert_raises(ArgumentError){ Process.wait4 }
-  end
-
-  test "wait4 works as expected" do
-    omit_if(@@hpux, 'wait4 test skipped on this platform')
-
-    pid = fork{ sleep 0.5 }
-    assert_nothing_raised{ @proc_stat = Process.wait4(pid) }
-    assert_kind_of(Struct::ProcStat, @proc_stat)
-  end
-
-  test "wait4 sets and returns $last_status to expected values" do
-    pid = fork{ sleep 0.5 }
-    Process.wait4(pid)
-    assert_kind_of(Struct::ProcStat, $last_status)
-    assert_not_nil($last_status)
-  end
-
-  test "wait4 sets pid and status members of $?" do
-    pid = fork{ sleep 0.5 }
-    Process.wait4(pid)
-    assert_not_nil($?)
-  end
-
-  test "wait4 returns frozen struct" do
-    pid = fork{ sleep 0.5 }
-    struct = Process.wait4(pid)
-    assert_true(struct.frozen?)
-  end
-
-  test "waitid method is defined" do
-    omit_if(@@hpux || @@darwin || @@freebsd, 'waitid test skipped on this platform')
-    assert_respond_to(Process, :waitid)
-  end
-
-  test "waitid method works as expected" do
-    omit_if(@@hpux || @@darwin || @@freebsd, 'waitid test skipped on this platform')
-    pid = fork{ sleep 0.5 }
-    assert_nothing_raised{ Process.waitid(Process::P_PID, pid, Process::WEXITED) }
-  end
-
-  test "waitid method raises expected errors if wrong argument type is passed" do
-    omit_if(@@hpux || @@darwin || @@freebsd, 'waitid test skipped on this platform')
-    pid = fork{ sleep 0.5 }
-    assert_raises(TypeError){ Process.waitid("foo", pid, Process::WEXITED) }
-    assert_raises(TypeError){ Process.waitid(Process::P_PID, pid, "foo") }
-    assert_raises(TypeError){ Process.waitid(Process::P_PID, "foo", Process::WEXITED) }
-  end
-
-  test "waitid method raises expected error if invalid argument is passed" do
-    omit_if(@@hpux || @@darwin || @@freebsd, 'waitid test skipped on this platform')
-    fork{ sleep 0.5 }
-    assert_raises(Errno::ECHILD, Errno::EINVAL){ Process.waitid(Process::P_PID, 99999999, Process::WEXITED) }
-  end
-
-  test "sigsend method is defined" do
-    omit_unless(@@solaris, 'sigsend test skipped on this platform')
-    assert_respond_to(Process, :sigsend)
-  end
-
-  test "sigsend works as expected" do
-    omit_unless(@@solaris, 'sigsend test skipped on this platform')
-    pid = fork{ sleep 0.5 }
-    assert_nothing_raised{ Process.sigsend(Process::P_PID, pid, 0) }
-  end
-
-  test "getrusage method is defined" do
-    assert_respond_to(Process, :getrusage)
-  end
-
-  test "getrusage works as expected" do
-    fork{ sleep 0.5 }
-    assert_nothing_raised{ Process.getrusage }
-    assert_nothing_raised{ Process.getrusage(true) }
-  end
-
-  test "getrusage can get thread info on Linux" do
-    omit_unless(@@linux)
-    assert_nothing_raised{ Process.getrusage(Process::RUSAGE_THREAD) }
-  end
-
-  test "getrusage returns the expected struct" do
-    fork{ sleep 0.5 }
-    assert_kind_of(Struct::RUsage, Process.getrusage)
-    assert_kind_of(Float, Process.getrusage.stime)
-    assert_kind_of(Float, Process.getrusage.utime)
-  end
-
-  test "pause method is defined" do
-    assert_respond_to(Process, :pause)
-  end
-
-  test "expected constants are defined" do
-    omit_if(@@darwin || @@freebsd, 'wait constant check skipped on this platform')
-
-    assert_not_nil(Process::WCONTINUED)
-    assert_not_nil(Process::WEXITED)
-    assert_not_nil(Process::WNOWAIT)
-    assert_not_nil(Process::WSTOPPED)
-
-    omit_if(@@linux, 'WTRAPPED constant check skipped on this platform')
-    assert_not_nil(Process::WTRAPPED)
-  end
-
-  test "expected process type flag constants are defined" do
-    omit_if(@@linux || @@darwin || @@freebsd, 'process type flag check skipped on this platform')
-
-    assert_not_nil(Process::P_ALL)
-    assert_not_nil(Process::P_CID)
-    assert_not_nil(Process::P_GID)
-    assert_not_nil(Process::P_MYID) unless @@solaris
-    assert_not_nil(Process::P_PGID)
-    assert_not_nil(Process::P_PID)
-    assert_not_nil(Process::P_SID)
-    assert_not_nil(Process::P_UID)
-  end
-
-  test "solaris-specific process type flags are defined on solaris" do
-    omit_unless(@@solaris, 'P_TASKID and P_PROJID constant check skipped on this platform')
-
-    assert_not_nil(Process::P_TASKID)
-    assert_not_nil(Process::P_PROJID)
-  end
-
-  def teardown
-    @proc_stat = nil
-    @proc_stat_members = nil
-  end
-
-  def self.shutdown
-    @@solaris  = nil
-    @@darwin   = nil
-    @@hpux     = nil
-    @@linux    = nil
-    @@freebsd  = nil
-  end
-end