process-group 1.2.1 → 1.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3f61fd5af23be851198506a9872307595aef290fe9264c0edd62b8036f143b2
-  data.tar.gz: a4f52c431b3b123bf4ca0cdaacb778706b35099a5be7deb17359ff260bd927f0
+  metadata.gz: 91f32e8039a65dede8fceb0bd2c5554142555ca7825f12d93d1329eb094789f0
+  data.tar.gz: 40d8f02f6f3ebd88cd5a4d5cbe8fb88e0e4fe54aefd5b3813c0b049f40415561
 SHA512:
-  metadata.gz: 04c5f7734d1e0894d7b5c0c477cf67999629ba159a910a96c17f3e951e84b278faa9b0a2274af650fc4b3e430c76de9326f1e5267643bdefec4d593c0a1e7cac
-  data.tar.gz: 6f35d68540b6fbb413db465a7befb284713d85bb9105cd9924eb48b8b540be91ca0d312f9398fe4ecc8e86c8708ce6da08bd1b715021230aa0a994a9aff98282
+  metadata.gz: 9e9947d56c5bd3999f2f16ff3bf2df9b6d63cce82a2070adcaab0943637d3836ac3a4a1488ac388af72bac5c189fe9a78f26f259f7250b8a0bc6f36c48d3f0bf
+  data.tar.gz: c8dfd88cfba5f4a06fe00e41d725bd7eb91536e70ac34e40042225040d449cfdb2386a9f4eecdfedb30396b49301f8cadd5a2e536a4d0e4514e054e2cdd02c3f

data/lib/process/group/version.rb

@@ -20,6 +20,6 @@
 
 module Process
 	class Group
-		VERSION = "1.2.1"
+		VERSION = "1.2.4"
 	end
 end

data/lib/process/group.rb

@@ -25,7 +25,7 @@ module Process
 	# A group of tasks which can be run asynchrnously using fibers. Someone must call Group#wait to ensure that all fibers eventually resume.
 	class Group
 		def self.wait(**options, &block)
-			group = Group.new(options)
+			group = Group.new(**options)
 			
 			group.wait(&block)
 		end
@@ -50,6 +50,10 @@ module Process
 			def resume(*arguments)
 				@fiber.resume(*arguments)
 			end
+			
+			def kill(signal = :INT)
+				Process.kill(signal, @pid)
+			end
 		end
 		
 		# Executes a command using Process.spawn with the given arguments and options.
@@ -123,7 +127,7 @@ module Process
 		
 		# The maximum number of processes to run concurrently, or zero 
 		attr_accessor :limit
-
+		
 		# The id of the process group, only valid if processes are currently running.
 		def id
 			raise RuntimeError.new("No processes in group, no group id available.") if @running.size == 0
@@ -293,11 +297,11 @@ module Process
 			
 			# Wait for processes in this group:
 			pid, status = Process.wait2(-@pgid, flags)
-		
+			
 			return if flags & Process::WNOHANG and pid == nil
-		
+			
 			process = @running.delete(pid)
-		
+			
 			# This should never happen unless something very odd has happened:
 			raise RuntimeError.new("Process id=#{pid} is not part of group!") unless process
 			

metadata

@@ -1,14 +1,44 @@
 --- !ruby/object:Gem::Specification
 name: process-group
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.2.4
 platform: ruby
 authors:
 - Samuel Williams
-autorequire: 
+- Dustin Zeisler
+- Olle Jonsson
+autorequire:
 bindir: bin
-cert_chain: []
-date: 2019-11-12 00:00:00.000000000 Z
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEhDCCAuygAwIBAgIBATANBgkqhkiG9w0BAQsFADA3MTUwMwYDVQQDDCxzYW11
+  ZWwud2lsbGlhbXMvREM9b3Jpb250cmFuc2Zlci9EQz1jby9EQz1uejAeFw0yMTA4
+  MTYwNjMzNDRaFw0yMjA4MTYwNjMzNDRaMDcxNTAzBgNVBAMMLHNhbXVlbC53aWxs
+  aWFtcy9EQz1vcmlvbnRyYW5zZmVyL0RDPWNvL0RDPW56MIIBojANBgkqhkiG9w0B
+  AQEFAAOCAY8AMIIBigKCAYEAyXLSS/cw+fXJ5e7hi+U/TeChPWeYdwJojDsFY1xr
+  xvtqbTTL8gbLHz5LW3QD2nfwCv3qTlw0qI3Ie7a9VMJMbSvgVEGEfQirqIgJXWMj
+  eNMDgKsMJtC7u/43abRKx7TCURW3iWyR19NRngsJJmaR51yGGGm2Kfsr+JtKKLtL
+  L188Wm3f13KAx7QJU8qyuBnj1/gWem076hzdA7xi1DbrZrch9GCRz62xymJlrJHn
+  9iZEZ7AxrS7vokhMlzSr/XMUihx/8aFKtk+tMLClqxZSmBWIErWdicCGTULXCBNb
+  E/mljo4zEVKhlTWpJklMIhr55ZRrSarKFuW7en0+tpJrfsYiAmXMJNi4XAYJH7uL
+  rgJuJwSaa/dMz+VmUoo7VKtSfCoOI+6v5/z0sK3oT6sG6ZwyI47DBq2XqNC6tnAj
+  w+XmCywiTQrFzMMAvcA7rPI4F0nU1rZId51rOvvfxaONp+wgTi4P8owZLw0/j0m4
+  8C20DYi6EYx4AHDXiLpElWh3AgMBAAGjgZowgZcwCQYDVR0TBAIwADALBgNVHQ8E
+  BAMCBLAwHQYDVR0OBBYEFB6ZaeWKxQjGTI+pmz7cKRmMIywwMC4GA1UdEQQnMCWB
+  I3NhbXVlbC53aWxsaWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MC4GA1UdEgQnMCWB
+  I3NhbXVlbC53aWxsaWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MA0GCSqGSIb3DQEB
+  CwUAA4IBgQBVoM+pu3dpdUhZM1w051iw5GfiqclAr1Psypf16Tiod/ho//4oAu6T
+  9fj3DPX/acWV9P/FScvqo4Qgv6g4VWO5ZU7z2JmPoTXZtYMunRAmQPFL/gSUc6aK
+  vszMHIyhtyzRc6DnfW2AiVOjMBjaYv8xXZc9bduniRVPrLR4J7ozmGLh4o4uJp7w
+  x9KCFaR8Lvn/r0oJWJOqb/DMAYI83YeN2Dlt3jpwrsmsONrtC5S3gOUle5afSGos
+  bYt5ocnEpKSomR9ZtnCGljds/aeO1Xgpn2r9HHcjwnH346iNrnHmMlC7BtHUFPDg
+  Ts92S47PTOXzwPBDsrFiq3VLbRjHSwf8rpqybQBH9MfzxGGxTaETQYOd6b4e4Ag6
+  y92abGna0bmIEb4+Tx9rQ10Uijh1POzvr/VTH4bbIPy9FbKrRsIQ24qDbNJRtOpE
+  RAOsIl+HOBTb252nx1kIRN5hqQx272AJCbCjKx8egcUQKffFVVCI0nye09v5CK+a
+  HiLJ8VOFx6w=
+  -----END CERTIFICATE-----
+date: 2022-05-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: process-terminal
@@ -25,7 +55,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.2.0
 - !ruby/object:Gem::Dependency
-  name: covered
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -39,7 +69,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: covered
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -58,61 +88,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.4.0
+        version: 3.9.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.4.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: "\tManages a unix process group for running multiple processes, keeps
-  track of multiple processes and leverages fibers to provide predictable behaviour
-  in complicated process-based scripts.\n"
+        version: 3.9.0
+description:
 email:
-- samuel.williams@oriontransfer.co.nz
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
-- Gemfile
-- README.md
-- Rakefile
-- examples/terminal.rb
 - lib/process/group.rb
 - lib/process/group/version.rb
-- process-group.gemspec
-- spec/process/group/foreground_spec.rb
-- spec/process/group/fork_spec.rb
-- spec/process/group/interrupt_spec.rb
-- spec/process/group/io_spec.rb
-- spec/process/group/load_spec.rb
-- spec/process/group/process_spec.rb
-- spec/process/group/spawn_spec.rb
-- spec/process/group/wait_spec.rb
-- spec/spec_helper.rb
 homepage: https://github.com/ioquatix/process-group
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  funding_uri: https://github.com/sponsors/ioquatix/
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -127,17 +124,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
-signing_key: 
+rubygems_version: 3.1.6
+signing_key:
 specification_version: 4
-summary: Run processes concurrently in separate fibers with predictable behaviour.
-test_files:
-- spec/process/group/foreground_spec.rb
-- spec/process/group/fork_spec.rb
-- spec/process/group/interrupt_spec.rb
-- spec/process/group/io_spec.rb
-- spec/process/group/load_spec.rb
-- spec/process/group/process_spec.rb
-- spec/process/group/spawn_spec.rb
-- spec/process/group/wait_spec.rb
-- spec/spec_helper.rb
+summary: Run and manage multiple processes in separate fibers with predictable behaviour.
+test_files: []

data/.gitignore

@@ -1,12 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-
-# rspec failure tracking
-.rspec_status

data/.rspec

@@ -1,4 +0,0 @@
---format documentation
---backtrace
---warnings
---require spec_helper

data/.travis.yml

@@ -1,14 +0,0 @@
-language: ruby
-dist: xenial
-cache: bundler
-
-matrix:
-  include:
-    - rvm: 2.3
-    - rvm: 2.4
-    - rvm: 2.5
-    - rvm: 2.6
-    - rvm: 2.6
-      os: osx
-    - rvm: 2.6
-      env: COVERAGE=BriefSummary,Coveralls

data/Gemfile

@@ -1,8 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in process-pool.gemspec
-gemspec
-
-group :test do
-	gem 'irb'
-end

data/README.md

@@ -1,219 +0,0 @@
-# Process::Group
-
-`Process::Group` allows for multiple fibers to run system processes concurrently with minimal overhead.
-
-```ruby
-Process::Group.wait do |group|
-	group.run("ls", "-lah") {|status| puts status.inspect}
-	group.run("echo", "Hello World") {|status| puts status.inspect}
-end
-```
-
-[![Build Status](https://secure.travis-ci.com/socketry/process-group.svg)](http://travis-ci.com/socketry/process-group)
-[![Coverage Status](https://coveralls.io/repos/socketry/process-group/badge.svg)](https://coveralls.io/r/socketry/process-group)
-[![Documentation](http://img.shields.io/badge/yard-docs-blue.svg)](http://www.rubydoc.info/gems/process-group)
-[![Code](http://img.shields.io/badge/github-code-blue.svg)](https://github.com/socketry/process-group)
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-	gem 'process-group'
-
-And then execute:
-
-	$ bundle
-
-Or install it yourself as:
-
-	$ gem install process-group
-
-## Usage
-
-The simplest concurrent usage is as follows:
-
-	# Create a new process group:
-	Process::Group.wait do |group|
-		# Run the command (non-blocking):
-		group.run("sleep 1") do |exit_status|
-			# Running in a separate fiber, will execute this code once the process completes:
-			puts "Command finished with status: #{exit_status}"
-		end
-		
-		# Do something else here:
-		sleep(1)
-		
-		# Wait for all processes in group to finish.
-	end
-
-The `group.wait` call is an explicit synchronization point, and if it completes successfully, all processes/fibers have finished successfully. If an error is raised in a fiber, it will be passed back out through `group.wait` and this is the only failure condition. Even if this occurs, all children processes are guaranteed to be cleaned up.
-
-### Explicit Fibers
-
-Items within a single fiber will execute sequentially. Processes (e.g. via `Group#spawn`) will run concurrently in multiple fibers.
-
-```ruby
-Process::Group.wait do |group|
-	# Explicity manage concurrency in this fiber:
-	Fiber.new do
-		# These processes will be run sequentially:
-		group.spawn("sleep 1")
-		group.spawn("sleep 1")
-	end.resume
-
-	# Implicitly run this task concurrently as the above fiber:
-	group.run("sleep 2")
-end
-```
-
-`Group#spawn` is theoretically identical to `Process#spawn` except the processes are run concurrently if possible.
-
-### Explicit Wait
-
-The recommended approach to use process group is to call `Process::Group.wait` with a block which invokes tasks. This block is wrapped in appropriate `rescue Interrupt` and `ensure` blocks which guarantee that the process group is cleaned up:
-
-```ruby
-Process::Group.wait do |group|
-	group.run("sleep 10")
-end
-```
-
-It is also possible to invoke this machinery and reuse the process group simply by instantiating the group and calling wait explicitly:
-
-```ruby
-group = Process::Group.new
-
-group.wait do
-	group.run("sleep 10")
-end
-```
-
-It is also possible to queue tasks for execution outside the wait block. But by design, it's only possible to execute tasks within the wait block. Tasks added outside a wait block will be queued up for execution when `#wait` is invoked:
-
-```ruby
-group = Process::Group.new
-
-group.run("sleep 10")
-
-# Run command here:
-group.wait
-```
-
-### Specify Options
-
-You can specify options to `Group#run` and `Group#spawn` just like `Process::spawn`:
-
-```ruby
-Process::Group.wait do |group|
-	env = {'FOO' => 'BAR'}
-	
-	# Arguments are essentially the same as Process::spawn.
-	group.run(env, "sleep 1", chdir: "/tmp")
-end
-```
-
-### Process Limit
-
-The process group can be used as a way to spawn multiple processes, but sometimes you'd like to limit the number of parallel processes to something relating to the number of processors in the system. By default, there is no limit on the number of processes running concurrently.
-
-```ruby
-# limit based on the number of processors:
-require 'etc'
-group = Process::Group.new(limit: Etc.nprocessors)
-
-# hardcoded - set to n (8 < n < 32) and let the OS scheduler worry about it:
-group = Process::Group.new(limit: 32)
-
-# unlimited - default:
-group = Process::Group.new
-```
-
-### Kill Group
-
-It is possible to send a signal (kill) to the entire process group:
-
-```ruby
-group.kill(:TERM)
-```
-
-If there are no running processes, this is a no-op (rather than an error). [Proper handling of SIGINT/SIGQUIT](http://www.cons.org/cracauer/sigint.html) explains how to use signals correctly.
-
-#### Handling Interrupts
-
-`Process::Group` transparently handles `Interrupt` when raised within a `Fiber`. If `Interrupt` is raised, all children processes will be sent `kill(:INT)` and we will wait for all children to complete, but without resuming the controlling fibers. If `Interrupt` is raised during this process, children will be sent `kill(:TERM)`. After calling `Interrupt`, the fibers will not be resumed.
-
-### Process Timeout
-
-You can run a process group with a time limit by using a separate child process:
-
-```ruby
-group = Process::Group.new
-
-class Timeout < StandardError
-end
-
-Fiber.new do
-	# Wait for 2 seconds, let other processes run:
-	group.fork { sleep 2 }
-	
-	# If no other processes are running, we are done:
-	Fiber.yield unless group.running?
-	
-	# Send SIGINT to currently running processes:
-	group.kill(:INT)
-	
-	# Wait for 2 seconds, let other processes run:
-	group.fork { sleep 2 }
-	
-	# If no other processes are running, we are done:
-	Fiber.yield unless group.running?
-	
-	# Send SIGTERM to currently running processes:
-	group.kill(:TERM)
-	
-	# Raise an Timeout exception which is based back out:
-	raise Timeout
-end.resume
-
-# Run some other long task:
-group.run("sleep 10")
-
-# Wait for fiber to complete:
-begin
-	group.wait
-rescue Timeout
-	puts "Process group was terminated forcefully."
-end
-```
-
-## Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
-
-## License
-
-Released under the MIT license.
-
-Copyright, 2014, by [Samuel G. D. Williams](http://www.codeotaku.com/samuel-williams).
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

data/Rakefile

@@ -1,6 +0,0 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new(:test)
-
-task :default => :test

data/examples/terminal.rb

@@ -1,43 +0,0 @@
-#!/usr/bin/env ruby
-#
-# Copyright, 2014, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require_relative '../lib/process/group'
-
-group = Process::Group.new
-
-5.times do
-	Fiber.new do
-		result = group.fork do
-			begin
-				sleep 1 while true
-			rescue Interrupt
-				puts "Interrupted in child #{Process.pid}"
-			end
-		end
-	end.resume
-end
-
-begin
-	group.wait
-rescue Interrupt
-	puts "Interrupted in parent #{Process.pid}"
-end

data/process-group.gemspec

@@ -1,29 +0,0 @@
-
-require_relative 'lib/process/group/version'
-
-Gem::Specification.new do |spec|
-	spec.name          = "process-group"
-	spec.version       = Process::Group::VERSION
-	spec.authors       = ["Samuel Williams"]
-	spec.email         = ["samuel.williams@oriontransfer.co.nz"]
-	spec.description   = <<-EOF
-	Manages a unix process group for running multiple processes, keeps track of multiple processes and leverages fibers to provide predictable behaviour in complicated process-based scripts.
-	EOF
-	spec.summary       = %q{Run processes concurrently in separate fibers with predictable behaviour.}
-	spec.homepage      = "https://github.com/ioquatix/process-group"
-	spec.license       = "MIT"
-
-	spec.files         = `git ls-files`.split($/)
-	spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-	spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-	spec.require_paths = ["lib"]
-	
-	spec.required_ruby_version = '>= 2.0'
-	
-	spec.add_dependency "process-terminal", "~> 0.2.0"
-	
-	spec.add_development_dependency "covered"
-	spec.add_development_dependency "bundler"
-	spec.add_development_dependency "rspec", "~> 3.4.0"
-	spec.add_development_dependency "rake"
-end

data/spec/process/group/foreground_spec.rb

@@ -1,34 +0,0 @@
-# Copyright, 2015, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'process/group'
-
-RSpec.describe Process::Group do
-	it "can run a process in the foreground" do
-		output, input = IO.pipe
-		
-		subject.wait do
-			subject.run("irb", foreground: true, in: output)
-			
-			input.puts("exit")
-			input.close
-		end
-	end
-end

data/spec/process/group/fork_spec.rb

@@ -1,60 +0,0 @@
-# Copyright, 2012, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'process/group'
-
-RSpec.describe Process::Group do
-	it "should fork and write to pipe" do
-		input, output = IO.pipe
-	
-		Fiber.new do
-			result = subject.fork do
-				output.puts "Hello World"
-			
-				exit(1)
-			end
-			
-			# We need to close output so that input.read will encounter end of stream.
-			output.close
-			
-			expect(result.exitstatus).to be == 1
-		end.resume
-		
-		subject.wait
-		
-		expect(input.read).to be == "Hello World\n"
-	end
-	
-	it "should not throw interrupt from fork" do
-		Fiber.new do
-			result = subject.fork do
-				# Don't print out a backtrace when Ruby invariably exits due to the execption below:
-				$stderr.reopen('/dev/null', 'w')
-				
-				raise Interrupt
-			end
-		
-			expect(result.exitstatus).not_to be == 0
-		end.resume
-	
-		# Shouldn't raise any errors:
-		subject.wait
-	end
-end

data/spec/process/group/interrupt_spec.rb

@@ -1,146 +0,0 @@
-# Copyright, 2012, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'process/group'
-
-RSpec.describe Process::Group do
-	it "should raise interrupt exception" do
-		checkpoint = ""
-		
-		Fiber.new do
-			checkpoint += 'X'
-		
-			result = subject.fork { sleep 0.1 }
-		
-			expect(result).to be == 0
-		
-			checkpoint += 'Y'
-		
-			# Simulate the user pressing Ctrl-C after a short time:
-			raise Interrupt
-		end.resume
-	
-		Fiber.new do
-			checkpoint += 'A'
-			
-			# This never returns:
-			result = subject.fork do
-				# We do this to exit immediately.. otherwise Ruby will print a backtrace and that's a bit confusing.
-				trap(:INT) { exit!(0) }
-				sleep(0.2)
-			end
-		
-			checkpoint += 'B'
-		end.resume
-	
-		expect(subject).to receive(:kill).with(:INT).once.and_call_original
-		expect(subject).to receive(:kill).with(:TERM).once.and_call_original
-		
-		expect do
-			subject.wait
-		end.to raise_error(Interrupt)
-		
-		expect(checkpoint).to be == 'XAY'
-	end
-	
-	it "should raise an exception" do
-		checkpoint = ""
-	
-		Fiber.new do
-			checkpoint += 'X'
-		
-			result = subject.fork { sleep 0.1 }
-			expect(result).to be == 0
-		
-			checkpoint += 'Y'
-		
-			# Raises a RuntimeError
-			fail "Error"
-		end.resume
-	
-		Fiber.new do
-			checkpoint += 'A'
-		
-			# This never returns:
-			result = subject.fork { sleep 0.2 }
-		
-			checkpoint += 'B'
-		end.resume
-	
-		expect do
-			expect(subject).to receive(:kill).with(:TERM).once
-		
-			subject.wait
-		end.to raise_error(RuntimeError)
-	
-		expect(checkpoint).to be == 'XAY'
-	end
-
-	it "should pass back out exceptions" do
-		checkpoint = ""
-	
-		Fiber.new do
-			# Wait for 2 seconds, let other processes run:
-			subject.fork { sleep 2 }
-			checkpoint += 'A'
-			#puts "Finished waiting #1..."
-	
-			# If no other processes are running, we are done:
-			Fiber.yield unless subject.running?
-			checkpoint += 'B'
-			#puts "Sending SIGINT..."
-	
-			# Send SIGINT to currently running processes:
-			subject.kill(:INT)
-	
-			# Wait for 2 seconds, let other processes run:
-			subject.fork { sleep 2 }
-			checkpoint += 'C'
-			#puts "Finished waiting #2..."
-	
-			# If no other processes are running, we are done:
-			Fiber.yield unless subject.running?
-			checkpoint += 'D'
-			#puts "Sending SIGTERM..."
-	
-			# Send SIGTERM to currently running processes:
-			subject.kill(:TERM)
-
-			# Raise an Timeout exception which is pased back out:
-			raise StandardError.new("Should never get here!")
-		end.resume
-
-		# Run some other long task:
-		subject.run("sleep 10")
-	
-		start_time = Time.now
-	
-		# Wait for fiber to complete:
-		expect do
-			subject.wait
-			checkpoint += 'E'
-		end.not_to raise_error
-	
-		end_time = Time.now
-	
-		expect(checkpoint).to be == 'ABCE'
-		expect(end_time - start_time).to be_within(0.2).of 4.0
-	end
-end

data/spec/process/group/io_spec.rb

@@ -1,52 +0,0 @@
-# Copyright, 2012, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'process/group'
-
-RSpec.describe Process::Group do
-	it "should read line on separate thread" do
-		input, output = IO.pipe
-	
-		Fiber.new do
-			result = subject.fork do
-				3.times do
-					output.puts "Hello World"
-					sleep 0.1
-				end
-			
-				exit(0)
-			end
-			
-			output.close
-			
-			expect(result).to be == 0
-		end.resume
-		
-		lines = nil
-		io_thread = Thread.new do
-			lines = input.read
-		end
-		
-		subject.wait
-		
-		io_thread.join
-		expect(lines).to be == ("Hello World\n" * 3)
-	end
-end

data/spec/process/group/load_spec.rb

@@ -1,42 +0,0 @@
-# Copyright, 2015, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'process/group'
-
-RSpec.describe Process::Group.new(limit: 5) do
-	it "should only run a limited number of processes" do
-		expect(subject.available?).to be_truthy
-		expect(subject.blocking?).to be_falsey
-		
-		5.times do
-			Fiber.new do
-				result = subject.fork do
-					exit(0)
-				end
-				
-				expect(result.exitstatus).to be == 0
-			end.resume
-		end
-		
-		subject.wait do
-			expect(subject.blocking?).to be_truthy
-		end
-	end
-end

data/spec/process/group/process_spec.rb

@@ -1,55 +0,0 @@
-# Copyright, 2015, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-RSpec.describe Process do
-	it "default fork exit status should be 0" do
-		pid = fork do
-		end
-		
-		Process.waitpid(pid)
-		
-		expect($?.exitstatus).to be == 0
-	end
-	
-	it "should fork and return exit status correctly" do
-		pid = fork do
-			exit(1)
-		end
-		
-		Process.waitpid(pid)
-		
-		expect($?.exitstatus).to be == 1
-	end
-	
-	# This is currently broken on Rubinius.
-	it "should be okay to use fork within a fiber" do
-		pid = nil
-		
-		Fiber.new do
-			pid = fork do
-				exit(2)
-			end
-		end.resume
-		
-		Process.waitpid(pid)
-		
-		expect($?.exitstatus).to be == 2
-	end
-end

data/spec/process/group/spawn_spec.rb

@@ -1,99 +0,0 @@
-# Copyright, 2012, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'process/group'
-
-RSpec.describe Process::Group do
-	it "should execute fibers concurrently" do
-		start_time = Time.now
-		
-		Fiber.new do
-			result = subject.fork { sleep 1.0 }
-			
-			expect(result).to be == 0
-		end.resume
-		
-		Fiber.new do
-			result = subject.fork { sleep 2.0 }
-			
-			expect(result).to be == 0
-		end.resume
-		
-		subject.wait
-		
-		end_time = Time.now
-		
-		# Check that the execution time was roughly 2 seconds:
-		expect(end_time - start_time).to be_within(0.1).of(2.0)
-	end
-	
-	it "should kill commands" do
-		start_time = Time.now
-	
-		subject.run("sleep 1") do |exit_status|
-			expect(exit_status).to_not be 0
-		end
-	
-		subject.run("sleep 2") do |exit_status|
-			expect(exit_status).to_not be 0
-		end
-	
-		subject.wait do
-			subject.kill(:KILL)
-		end
-	
-		end_time = Time.now
-	
-		# Check that processes killed almost immediately:
-		expect(end_time - start_time).to be < 0.2
-	end
-	
-	it "should pass environment to child process" do
-		env = {'FOO' => 'BAR'}
-	
-		# Make a pipe to receive output from child process:
-		input, output = IO.pipe
-	
-		subject.run(env, "echo $FOO", out: output) do |exit_status|
-			output.close
-		end
-	
-		subject.wait
-	
-		expect(input.read).to be == "BAR\n"
-	end
-	
-	it "should yield exit status" do
-		start_time = Time.now
-	
-		subject.run("sleep 1")
-	
-		subject.run("sleep 1") do |exit_status|
-			expect(exit_status).to be == 0
-		end
-	
-		subject.wait
-	
-		end_time = Time.now
-	
-		# Check that the execution time was roughly 1 second:
-		expect(end_time - start_time).to be_within(0.1).of(1.0)
-	end
-end

data/spec/process/group/wait_spec.rb

@@ -1,85 +0,0 @@
-# Copyright, 2012, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'process/group'
-
-RSpec.describe Process::Group do
-	it "should invoke child task normally" do
-		start_time = Time.now
-		
-		child_exit_status = nil
-		
-		subject.wait do
-			subject.run("exit 0") do |exit_status|
-				child_exit_status = exit_status
-			end
-		end
-		
-		expect(child_exit_status).to be == 0
-	end
-	
-	it "should kill child task if process is interrupted" do
-		start_time = Time.now
-		
-		child_exit_status = nil
-		
-		expect do
-			subject.wait do
-				subject.run("sleep 10") do |exit_status|
-					child_exit_status = exit_status
-				end
-				
-				# Simulate the parent (controlling) process receiving an interrupt.
-				raise Interrupt
-			end
-		end.to raise_error(Interrupt)
-		
-		expect(child_exit_status).to_not be == 0
-	end
-	
-	it "should propagate Interrupt" do
-		expect(Process::Group).to receive(:new).once.and_call_original
-		
-		expect do
-			Process::Group.wait do |group|
-				raise Interrupt
-			end
-		end.to raise_error(Interrupt)
-	end
-	
-	it "should clear queue after wait" do
-		subject.limit = 1
-		
-		subject.run("sleep 10")
-		subject.run("sleep 10")
-		
-		expect(subject.running?).to be_falsey
-		expect(subject.queued?).to be_truthy
-		
-		expect do
-			subject.wait do
-				raise Interrupt
-			end
-		end.to raise_error(Interrupt)
-		
-		expect(subject.running?).to be_falsey
-		expect(subject.queued?).to be_falsey
-	end
-end

data/spec/spec_helper.rb

@@ -1,34 +0,0 @@
-# Copyright, 2019, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require "bundler/setup"
-require 'covered/rspec'
-
-RSpec.configure do |config|
-	# Enable flags like --only-failures and --next-failure
-	config.example_status_persistence_file_path = ".rspec_status"
-
-	# Disable RSpec exposing methods globally on `Module` and `main`
-	config.disable_monkey_patching!
-
-	config.expect_with :rspec do |c|
-		c.syntax = :expect
-	end
-end