process-group 1.0.1 → 1.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 28a68aa53cd296412dd77cdca5a9c8b000269439
-  data.tar.gz: 49777327e43bbddda6e17a2b13776227693d115d
+SHA256:
+  metadata.gz: a2ef7e85dc264aa4d6254170467cd4fc1e47d2c5f552b3c55528370142526452
+  data.tar.gz: 7e8d6ccb53689d31a427484cfab31bb783a6896de2208c2780f664f3b6e5e883
 SHA512:
-  metadata.gz: 508765b5658d4fbb032c7f43f36a5a9c26e4fbbfc379295398d3ac08e9da12bab9440cb9002bd052d9eaaba5abbbd9ee970f8a290ceaab144ad682e53e95ebfb
-  data.tar.gz: 0f7d655bd81259b92c757342ff71aee743209e33dbb3c1a71e4b4facd0c4dac5de706a01735c4afd964feb6b52429e8d6b07e706db992408a7da81f599b5a4e9
+  metadata.gz: 2106bb6e1e7f2f7f20a63781d82b95786305b53005bdff44cd0bdc5e1a2ff13c6efefc26c715f3d76919b683309afac6016e18dbdbc374afb736a36c9b1c4a1c
+  data.tar.gz: 8e96440ab717809e09c06f11ea3e9bb8596f31613804b04a11a84266a55008fe22d42a47129798062cad0ebc9dd54dc3ea0652664a36b535a0cc3ae4d4f1c1af

data/lib/process/group.rb

@@ -19,75 +19,107 @@
 # THE SOFTWARE.
 
 require 'fiber'
+require 'process/terminal'
 
 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
-		# Executes a command using Process.spawn with the given arguments and options.
+		def self.wait(**options, &block)
+			group = Group.new(**options)
+			
+			group.wait(&block)
+		end
+		
 		class Command
-			def initialize(arguments, options, fiber = Fiber.current)
-				@arguments = arguments
+			def initialize(foreground: false, **options)
 				@options = options
-			
-				@fiber = fiber
+				@foreground = foreground
+				
+				@fiber = Fiber.current
+				@pid = nil
 			end
-		
-			attr :arguments
+			
 			attr :options
-		
-			def run(options = {})
-				@pid = Process.spawn(*@arguments, @options.merge(options))
-				
-				return @pid
+			
+			attr :pid
+			
+			def foreground?
+				@foreground
 			end
-		
+			
 			def resume(*arguments)
 				@fiber.resume(*arguments)
 			end
+			
+			def kill(signal = :INT)
+				Process.kill(signal, @pid)
+			end
 		end
 		
-		# Runs a given block using a forked process.
-		class Fork
-			def initialize(block, options, fiber = Fiber.current)
-				@options = options
+		# Executes a command using Process.spawn with the given arguments and options.
+		class Spawn < Command
+			def initialize(arguments, **options)
+				@arguments = arguments
+				
+				super(**options)
+			end
+			
+			attr :arguments
+			
+			def call(**options)
+				options = @options.merge(options)
 				
-				raise ArgumentError.new("Fork requires a block!") unless @block = block
+				@pid = Process.spawn(*@arguments, **options)
+			end
+		end
+		
+		# Runs a given block using a forked process.
+		class Fork < Command
+			def initialize(block, **options)
+				@block = block
 				
-				@fiber = fiber
+				super(**options)
 			end
 			
-			def run(options = {})
+			def call(**options)
+				options = @options.merge(options)
+				
 				@pid = Process.fork(&@block)
 				
 				if options[:pgroup] == true
 					# Establishes the child process as a process group leader:
 					Process.setpgid(@pid, 0)
-				else
+				elsif pgroup = options[:pgroup]
 					# Set this process as part of the existing process group:
-					Process.setpgid(@pid, options[:pgroup])
+					Process.setpgid(@pid, pgroup)
 				end
 				
 				return @pid
 			end
-		
+			
 			def resume(*arguments)
 				@fiber.resume(*arguments)
 			end
 		end
 		
 		# Create a new process group. Can specify `limit:` which limits the maximum number of concurrent processes.
-		def initialize(limit: nil)
+		def initialize(limit: nil, terminal: Terminal::Device.new?)
 			raise ArgumentError.new("Limit must be nil (unlimited) or > 0") unless limit == nil or limit > 0
 			
 			@pid = Process.pid
 			
+			@terminal = terminal
+			
 			@queue = []
 			@limit = limit
-		
+			
 			@running = {}
 			@fiber = nil
-		
+			
 			@pgid = nil
+			
+			# Whether we can actively schedule tasks or not:
+			@waiting = false
 		end
 		
 		# A table of currently running processes.
@@ -102,29 +134,39 @@ module Process
 			
 			-@pgid
 		end
-
+		
+		def queued?
+			@queue.size > 0
+		end
+		
 		# Are there processes currently running?
 		def running?
 			@running.size > 0
 		end
-
+		
 		# Run a process in a new fiber, arguments have same meaning as Process#spawn.
-		def run(*arguments)
+		def run(*arguments, **options)
 			Fiber.new do
-				exit_status = self.spawn(*arguments)
+				exit_status = self.spawn(*arguments, **options)
 				
 				yield exit_status if block_given?
 			end.resume
 		end
 		
+		def async
+			Fiber.new do
+				yield self
+			end.resume
+		end
+		
 		# Run a specific command as a child process.
 		def spawn(*arguments, **options)
-			append! Command.new(arguments, options)
+			append! Spawn.new(arguments, **options)
 		end
 		
 		# Fork a block as a child process.
 		def fork(**options, &block)
-			append! Fork.new(block, options)
+			append! Fork.new(block, **options)
 		end
 		
 		# Whether or not #spawn, #fork or #run can be scheduled immediately.
@@ -141,20 +183,26 @@ module Process
 			not available?
 		end
 		
-		# Wait for all running and queued processes to finish.
+		# Wait for all running and queued processes to finish. If you provide a block, it will be invoked before waiting, but within canonical signal handling machinery.
 		def wait
 			raise ArgumentError.new("Cannot call Process::Group#wait from child process!") unless @pid == Process.pid
 			
-			while running?
-				process, status = wait_one
-				
-				schedule!
+			waiting do
+				yield(self) if block_given?
 				
-				process.resume(status)
+				while running?
+					process, status = wait_one
+					
+					schedule!
+					
+					process.resume(status)
+				end
 			end
 			
 			# No processes, process group is no longer valid:
 			@pgid = nil
+			
+			return self
 		rescue Interrupt
 			# If the user interrupts the wait, interrupt the process group and wait for them to finish:
 			self.kill(:INT)
@@ -182,13 +230,33 @@ module Process
 			end
 		end
 		
+		def to_s
+			"#<#{self.class} running=#{@running.size} queued=#{@queue.size} limit=#{@limit} pgid=#{@pgid}>"
+		end
+		
 		private
 		
+		# The waiting loop, schedule any outstanding tasks:
+		def waiting
+			@waiting = true
+			
+			# Schedule any queued tasks:
+			schedule!
+			
+			yield
+		ensure
+			@waiting = false
+		end
+		
+		def waiting?
+			@waiting
+		end
+		
 		# Append a process to the queue and schedule it for execution if possible.
 		def append!(process)
 			@queue << process
 			
-			schedule!
+			schedule! if waiting?
 			
 			Fiber.yield
 		end
@@ -197,14 +265,18 @@ module Process
 		def schedule!
 			while available? and @queue.size > 0
 				process = @queue.shift
-			
+				
 				if @running.size == 0
-					pid = process.run(:pgroup => true)
+					pid = process.call(:pgroup => true)
 					
 					# The process group id is the pid of the first process:
 					@pgid = pid
 				else
-					pid = process.run(:pgroup => @pgid)
+					pid = process.call(:pgroup => @pgid)
+				end
+				
+				if @terminal and process.foreground?
+					@terminal.foreground = pid
 				end
 				
 				@running[pid] = process
@@ -214,6 +286,9 @@ module Process
 		# Wait for all children to exit but without resuming any controlling fibers.
 		def wait_all
 			wait_one while running?
+			
+			# Clear any queued tasks:
+			@queue.clear
 		end
 		
 		# Wait for one process, should only be called when a child process has finished, otherwise would block.

data/lib/process/group/version.rb

@@ -20,6 +20,6 @@
 
 module Process
 	class Group
-		VERSION = "1.0.1"
+		VERSION = "1.2.3"
 	end
 end

metadata

@@ -1,45 +1,73 @@
 --- !ruby/object:Gem::Specification
 name: process-group
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.2.3
 platform: ruby
 authors:
 - Samuel Williams
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2016-01-09 00:00:00.000000000 Z
+date: 2020-06-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: process-terminal
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
-  type: :development
+        version: 0.2.0
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: bake-bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 3.4.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bake-modernize
+  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: bundler
+  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: 3.4.0
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: covered
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -52,37 +80,34 @@ dependencies:
     - - ">="
       - !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"
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.9.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.9.0
+description:
 email:
-- samuel.williams@oriontransfer.co.nz
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".simplecov"
-- ".travis.yml"
-- Gemfile
-- README.md
-- Rakefile
-- examples/terminal.rb
 - lib/process/group.rb
 - lib/process/group/version.rb
-- process-group.gemspec
-- 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
 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
@@ -97,15 +122,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.4.6
-signing_key: 
+rubygems_version: 3.1.2
+signing_key:
 specification_version: 4
-summary: Run processes concurrently in separate fibers with predictable behaviour.
-test_files:
-- 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
+summary: Run and manage multiple processes in separate fibers with predictable behaviour.
+test_files: []

data/.gitignore

@@ -1,17 +0,0 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
-Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp

data/.rspec

@@ -1,2 +0,0 @@
---color 
---format documentation 

data/.simplecov

@@ -1,9 +0,0 @@
-
-SimpleCov.start do
-	add_filter "/spec/"
-end
-
-if ENV['TRAVIS']
-	require 'coveralls'
-	Coveralls.wear!
-end

data/.travis.yml

@@ -1,14 +0,0 @@
-language: ruby
-sudo: false
-rvm:
-  - 2.0.0
-  - 2.1.8
-  - 2.2.4
-  - 2.3.0
-  - ruby-head
-  - rbx-2
-env: COVERAGE=true
-matrix:
-  allow_failures:
-    - rvm: "rbx-2"
-

data/Gemfile

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

data/README.md

@@ -1,182 +0,0 @@
-# Process::Group
-
-`Process::Group` allows for multiple fibers to run system processes concurrently with minimal overhead.
-
-[![Build Status](https://secure.travis-ci.org/ioquatix/process-group.svg)](http://travis-ci.org/ioquatix/process-group)
-[![Code Climate](https://codeclimate.com/github/ioquatix/process-group.svg)](https://codeclimate.com/github/ioquatix/process-group)
-[![Coverage Status](https://coveralls.io/repos/ioquatix/process-group/badge.svg)](https://coveralls.io/r/ioquatix/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/ioquatix/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:
-	group = Process::Group.new
-	
-	# 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:
-	group.wait
-
-The `group.wait` call is an explicit synchronisation 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.
-
-	group = Process::Group.new
-	
-	# 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")
-	
-	# Wait for fiber to complete:
-	group.wait
-
-`Group#spawn` is theoretically identical to `Process#spawn` except the processes are run concurrently if possible.
-
-### Specify Options
-
-You can specify options to `Group#run` and `Group#spawn` just like `Process::spawn`:
-
-	group = Process::Group.new
-	
-	env = {'FOO' => 'BAR'}
-	
-	# Arguments are essentially the same as Process::spawn.
-	group.run(env, "sleep 1", chdir: "/tmp")
-	
-	group.wait
-
-### 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. A number of options exist.
-
-	# 'facter' gem - found a bit slow to initialise, but most widely supported.
-	require 'facter'
-	group = Process::Group.new(limit: Facter.processorcount)
-	
-	# 'system' gem - found very fast, less wide support (but nothing really important).
-	require 'system'
-	group = Process::Group.new(limit: System::CPU.count)
-	
-	# 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:
-
-	group.kill(:TERM)
-
-If there are no running processes, this is a no-op (rather than an error).
-
-#### 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:
-
-	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,8 +0,0 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new(:spec) do |task|
-	task.rspec_opts = ["--require", "simplecov"] if ENV['COVERAGE']
-end
-
-task :default => :spec

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,28 +0,0 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require '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_development_dependency "bundler", "~> 1.3"
-	spec.add_development_dependency "rspec", "~> 3.4.0"
-	spec.add_development_dependency "rake"
-end

data/spec/process/group/fork_spec.rb

@@ -1,65 +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'
-
-module Process::Group::ForkSpec
-	describe Process::Group do
-		it "should fork and write to pipe" do
-			group = Process::Group.new
-		
-			input, output = IO.pipe
-		
-			Fiber.new do
-				result = group.fork do
-					output.puts "Hello World"
-				
-					exit(1)
-				end
-				
-				expect(result.exitstatus).to be == 1
-			end.resume
-		
-			output.close
-		
-			group.wait
-		
-			expect(input.read).to be == "Hello World\n"
-		end
-		
-		it "should not throw interrupt from fork" do
-			group = Process::Group.new
-		
-			Fiber.new do
-				result = group.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:
-			group.wait
-		end
-	end
-end

data/spec/process/group/interrupt_spec.rb

@@ -1,150 +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'
-
-module Process::Group::InterruptSpec
-	describe Process::Group do
-		it "should raise interrupt exception" do
-			group = Process::Group.new
-			checkpoint = ""
-		
-			Fiber.new do
-				checkpoint += 'X'
-			
-				result = group.fork { sleep 0.1 }
-			
-				expect(result).to be == 0
-			
-				checkpoint += 'Y'
-			
-				# Simulate the user pressing Ctrl-C after 0.5 seconds:
-				raise Interrupt
-			end.resume
-		
-			Fiber.new do
-				checkpoint += 'A'
-			
-				# This never returns:
-				result = group.fork { sleep 0.2 }
-			
-				checkpoint += 'B'
-			end.resume
-		
-			expect(group).to receive(:kill).with(:INT).once
-			expect(group).to receive(:kill).with(:TERM).once
-			
-			expect do
-				group.wait
-			end.to raise_error(Interrupt)
-			
-			expect(checkpoint).to be == 'XAY'
-		end
-		
-		it "should raise an exception" do
-			group = Process::Group.new
-			checkpoint = ""
-		
-			Fiber.new do
-				checkpoint += 'X'
-			
-				result = group.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 = group.fork { sleep 0.2 }
-			
-				checkpoint += 'B'
-			end.resume
-		
-			expect do
-				expect(group).to receive(:kill).with(:TERM).once
-			
-				group.wait
-			end.to raise_error(RuntimeError)
-		
-			expect(checkpoint).to be == 'XAY'
-		end
-		
-		class Timeout < StandardError
-		end
-	
-		it "should pass back out exceptions" do
-			group = Process::Group.new
-			checkpoint = ""
-		
-			Fiber.new do
-				# Wait for 2 seconds, let other processes run:
-				group.fork { sleep 2 }
-				checkpoint += 'A'
-				#puts "Finished waiting #1..."
-		
-				# If no other processes are running, we are done:
-				Fiber.yield unless group.running?
-				checkpoint += 'B'
-				#puts "Sending SIGINT..."
-		
-				# Send SIGINT to currently running processes:
-				group.kill(:INT)
-		
-				# Wait for 2 seconds, let other processes run:
-				group.fork { sleep 2 }
-				checkpoint += 'C'
-				#puts "Finished waiting #2..."
-		
-				# If no other processes are running, we are done:
-				Fiber.yield unless group.running?
-				checkpoint += 'D'
-				#puts "Sending SIGTERM..."
-		
-				# Send SIGTERM to currently running processes:
-				group.kill(:TERM)
-		
-				# Raise an Timeout exception which is pased back out:
-				raise Timeout
-			end.resume
-	
-			# Run some other long task:
-			group.run("sleep 10")
-		
-			start_time = Time.now
-		
-			# Wait for fiber to complete:
-			expect do
-				group.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
-end

data/spec/process/group/io_spec.rb

@@ -1,56 +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'
-
-module Process::Group::IOSpec
-	describe Process::Group do
-		it "should read line on separate thread" do
-			group = Process::Group.new
-		
-			input, output = IO.pipe
-		
-			Fiber.new do
-				result = group.fork do
-					3.times do
-						output.puts "Hello World"
-						sleep 0.1
-					end
-				
-					exit(0)
-				end
-				
-				expect(result).to be == 0
-			end.resume
-			
-			output.close
-			
-			lines = nil
-			io_thread = Thread.new do
-				lines = input.read
-			end
-			
-			group.wait
-			
-			io_thread.join
-			expect(lines).to be == ("Hello World\n" * 3)
-		end
-	end
-end

data/spec/process/group/load_spec.rb

@@ -1,46 +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'
-
-module Process::Group::LoadSpec
-	describe Process::Group do
-		it "should only run a limited number of processes" do
-			group = Process::Group.new(limit: 5)
-			
-			expect(group.available?).to be_truthy
-			expect(group.blocking?).to be_falsey
-			
-			5.times do
-				Fiber.new do
-					result = group.fork do
-						exit(0)
-					end
-					
-					expect(result.exitstatus).to be == 0
-				end.resume
-			end
-			
-			expect(group.blocking?).to be_truthy
-			
-			group.wait
-		end
-	end
-end

data/spec/process/group/process_spec.rb

@@ -1,57 +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.
-
-module Process::Group::ProcessSpec
-	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
-end

data/spec/process/group/spawn_spec.rb

@@ -1,109 +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'
-
-module Process::Group::SpawnSpec
-	describe Process::Group do
-		it "should execute fibers concurrently" do
-			group = Process::Group.new
-			
-			start_time = Time.now
-			
-			Fiber.new do
-				result = group.fork { sleep 1.0 }
-				
-				expect(result).to be == 0
-			end.resume
-			
-			Fiber.new do
-				result = group.fork { sleep 2.0 }
-				
-				expect(result).to be == 0
-			end.resume
-			
-			group.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
-			group = Process::Group.new
-		
-			start_time = Time.now
-		
-			group.run("sleep 1") do |exit_status|
-				expect(exit_status).to_not be 0
-			end
-		
-			group.run("sleep 2") do |exit_status|
-				expect(exit_status).to_not be 0
-			end
-		
-			group.kill(:KILL)
-		
-			group.wait
-		
-			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
-			group = Process::Group.new
-		
-			env = {'FOO' => 'BAR'}
-		
-			# Make a pipe to receive output from child process:
-			input, output = IO.pipe
-		
-			group.run(env, "echo $FOO", out: output) do |exit_status|
-				output.close
-			end
-		
-			group.wait
-		
-			expect(input.read).to be == "BAR\n"
-		end
-		
-		it "should yield exit status" do
-			group = Process::Group.new
-		
-			start_time = Time.now
-		
-			group.run("sleep 1")
-		
-			group.run("sleep 1") do |exit_status|
-				expect(exit_status).to be == 0
-			end
-		
-			group.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
-end