process-daemon 0.5.5 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5ece8e79345bfaabb606ac9b0b2be85dc176ff1d
-  data.tar.gz: f199756be6f1625ee83a19795a111f67e8672406
+  metadata.gz: ce61de8f6a1e9c039282f457fed948aa8221d709
+  data.tar.gz: e44c53039d96fc318d894527010a5f378c4fe490
 SHA512:
-  metadata.gz: 718589f9efa869b8256c065f74b8e6b234722a8e6862060f0fa1faf4f6b46fd92d3952f702e160d4ad9d1a3f0778c75d19e8609bb98ba7685af180b90d44eae2
-  data.tar.gz: c5063b89bda0d750da4298b318d91cdd914cb6c225e06562a4ca6b3975f7fa5c507a6b81812ae2f4788119fc1c562075e5286caf6fb8ddd944e5944e756bca59
+  metadata.gz: 8530411f7ca42fc9726424da6fc39358d2f6ca32fae5e67e8a6ec94682d2f2f4f7dbd7094c8367ab772f4762fadb89d495266be281d1d84e8121cc4bbcef7cd9
+  data.tar.gz: 883851f2915344371a49de317a9d6fd057b7b70ec638a3a4a6a9c438baf17c3ad73fc17ecabe9896a8c0591c9b7e86e20d55ba786ea20e467fe0dd805475e4fd

data/.rspec

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

data/.simplecov

@@ -0,0 +1,15 @@
+
+SimpleCov.start do
+	add_filter "/spec/"
+end
+
+# Work correctly across forks:
+pid = Process.pid
+SimpleCov.at_exit do
+	SimpleCov.result.format! if Process.pid == pid
+end
+
+if ENV['TRAVIS']
+	require 'coveralls'
+	Coveralls.wear!
+end

data/.travis.yml

@@ -1,5 +1,11 @@
 language: ruby
+sudo: false
 rvm:
-  - 1.9
-  - 2.0
+  - 2.2
   - 2.1
+  - 2.0
+  - rbx-2
+matrix:
+  allow_failures:
+    - rvm: rbx-2 
+env: COVERAGE=true

data/Gemfile

@@ -4,5 +4,6 @@ source 'https://rubygems.org'
 gemspec
 
 group :test do
-	gem "minitest"
+	gem 'simplecov'
+	gem 'coveralls', require: false
 end

data/README.md

@@ -2,24 +2,61 @@
 
 `Process::Daemon` is a stable and helpful base class for long running tasks and daemons. Provides standard `start`, `stop`, `restart`, `status` operations.
 
-[![Build Status](https://travis-ci.org/ioquatix/process-daemon.svg)](https://travis-ci.org/ioquatix/process-daemon)
+[![Build Status](https://travis-ci.org/ioquatix/process-daemon.svg?branch=master)](https://travis-ci.org/ioquatix/process-daemon)
+[![Code Climate](https://codeclimate.com/github/ioquatix/process-daemon.png)](https://codeclimate.com/github/ioquatix/process-daemon)
+[![Coverage Status](https://coveralls.io/repos/ioquatix/process-daemon/badge.svg?branch=master)](https://coveralls.io/r/ioquatix/process-daemon?branch=master)
+[![Documentation](http://img.shields.io/badge/yard-docs-blue.svg)](http://www.rubydoc.info/gems/process-daemon)
+[![Code](http://img.shields.io/badge/github-code-blue.svg)](https://github.com/ioquatix/process-daemon)
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
-    gem 'process-daemon'
+		gem 'process-daemon'
 
 And then execute:
 
-    $ bundle
+		$ bundle
 
 Or install it yourself as:
 
-    $ gem install process-daemon
+		$ gem install process-daemon
 
 ## Usage
 
+A process daemon has a specific structure:
+
+	class MyDaemon < Process::Daemon
+		def startup
+			# Called when the daemon is initialized in it's own process. Should return quickly.
+		end
+		
+		def run
+			# Do the actual work. Does not need to be implemented, e.g. if using threads or other background processing mechanisms.
+		end
+		
+		def shutdown
+			# Stop everything that was setup in startup.
+		end
+	end
+	
+	# Make this file executable and have a command line interface:
+	MyDaemon.daemonize
+
+### Working directory
+
+By default, daemons run in the current working directory. They setup paths according to the following logic:
+
+	working_directory = "."
+	log_directory = #{working_directory}/log
+	log_file_path = #{log_directory}/#{name}.log
+	runtime_directory = #{working_directory}/run
+	process_file_path = #{runtime_directory}/#{name}.pid
+
+After calling `prefork`, the working directory is expanded to a full path and should not be changed.
+
+### WEBRick Server
+
 Create a file for your daemon, e.g. `daemon.rb`:
 
 	#!/usr/bin/env ruby
@@ -28,13 +65,7 @@ Create a file for your daemon, e.g. `daemon.rb`:
 	
 	# Very simple XMLRPC daemon
 	class XMLRPCDaemon < Process::Daemon
-		def working_directory
-			File.expand_path("../tmp", __FILE__)
-		end
-	
 		def startup
-			puts "Starting server..."
-			
 			@rpc_server = WEBrick::HTTPServer.new(
 				:Port => 31337,
 				:BindAddress => "0.0.0.0"
@@ -47,19 +78,17 @@ Create a file for your daemon, e.g. `daemon.rb`:
 			end
 			
 			@rpc_server.mount("/RPC2", @listener)
-			
-			begin
-				@rpc_server.start
-			rescue Interrupt
-				puts "Daemon interrupted..."
-			ensure
-				@rpc_server.shutdown
-			end
 		end
 		
-		def shutdown
-			puts "Stopping the RPC server..."
-			@rpc_server.stop
+		def run
+			# This is the correct way to cleanly shutdown the server:
+			trap(:INT) do
+				@rpc_server.shutdown
+			end
+			
+			@rpc_server.start
+		ensure
+			@rpc_server.shutdown
 		end
 	end
 	
@@ -67,6 +96,35 @@ Create a file for your daemon, e.g. `daemon.rb`:
 
 Then run `daemon.rb start`. To stop the daemon, run `daemon.rb stop`.
 
+### Celluloid Actor
+
+`Process::Daemon` is the perfect place to spawn your [celluloid](https://celluloid.io) actors.
+
+	require 'celluloid'
+	require 'process/daemon'
+	
+	class MyActor
+		include Celluloid::Actor
+		
+		def long_running
+			sleep 1000
+		end
+	end
+	
+	class MyDaemon < Process::Daemon
+		def startup
+			@actor = MyActor.new
+			
+			@actor.async.long_running_process
+		end
+		
+		def shutdown
+			@actor.terminate
+		end
+	end
+	
+	MyDaemon.daemonize
+
 ## Contributing
 
 1. Fork it
@@ -79,7 +137,7 @@ Then run `daemon.rb start`. To stop the daemon, run `daemon.rb stop`.
 
 Released under the MIT license.
 
-Copyright, 2014, by [Samuel G. D. Williams](http://www.codeotaku.com/samuel-williams).
+Copyright, 2015, 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

data/Rakefile

@@ -1,6 +1,8 @@
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 
-RSpec::Core::RakeTask.new(:spec)
+RSpec::Core::RakeTask.new(:spec) do |task|
+	task.rspec_opts = ["--require", "simplecov"] if ENV['COVERAGE']
+end
 
 task :default => :spec

data/lib/process/daemon.rb

@@ -22,35 +22,19 @@ require 'fileutils'
 
 require_relative 'daemon/controller'
 
+require_relative 'daemon/notification'
+
 require_relative 'daemon/log_file'
 require_relative 'daemon/process_file'
 
 module Process
-	# This class is the base daemon class. If you are writing a daemon, you should inherit from this class.
-	#
-	# The basic structure of a daemon is as follows:
-	# 	
-	# 	class Server < Process::Daemon
-	# 		def startup
-	# 			# Long running process, e.g. web server, game server, etc.
-	# 		end
-	# 		
-	# 		def shutdown
-	# 			# Stop the process above, usually called on SIGINT.
-	# 		end
-	# 	end
-	# 	
-	# 	Server.daemonize
-	#
-	# The base directory specifies a path such that:
-	#   working_directory = "."
-	#   log_directory = #{working_directory}/log
-	#   log_file_path = #{log_directory}/#{name}.log
-	#   runtime_directory = #{working_directory}/run
-	#   process_file_path = #{runtime_directory}/#{name}.pid
+	# Provides the infrastructure for spawning a daemon.
 	class Daemon
+		# Initialize the daemon in the given working root.
 		def initialize(working_directory = ".")
 			@working_directory = working_directory
+			
+			@shutdown_notification = Notification.new
 		end
 		
 		# Return the name of the daemon
@@ -109,30 +93,20 @@ module Process
 
 			return false
 		end
-
+		
 		# The main function to setup any environment required by the daemon
 		def prefork
-			# We freeze the working directory because it can't change after forking:
-			@working_directory = File.expand_path(working_directory)
+			# Ignore any previously setup signal handler for SIGINT:
+			trap(:INT, :DEFAULT)
 			
-			def self.working_directory
-				@working_directory
-			end
+			# We update the working directory to a full path:
+			@working_directory = File.expand_path(working_directory)
 			
 			FileUtils.mkdir_p(log_directory)
 			FileUtils.mkdir_p(runtime_directory)
 		end
-
-		# The main function to start the daemon
-		def startup
-		end
-
-		# The main function to stop the daemon
-		def shutdown
-			# Interrupt all children processes, preferably to stop them so that they are not left behind.
-			Process.kill(:INT, 0)
-		end
 		
+		# The process title of the daemon.
 		attr :title
 		
 		# Set the process title - only works after daemon has forked.
@@ -146,15 +120,46 @@ module Process
 			end
 		end
 		
+		# Request that the sleep_until_interrupted function call returns.
+		def request_shutdown
+			@shutdown_notification.signal
+		end
+		
+		# Call this function to sleep until the daemon is sent SIGINT.
+		def sleep_until_interrupted
+			trap(:INT) do
+				self.request_shutdown
+			end
+
+			@shutdown_notification.wait
+		end
+		
+		# This function must setup the daemon quickly and return.
+		def startup
+		end
+		
+		# If you want to implement a long running process you override this method. You may like to call super but it is not necessary to use the supplied interruption machinery.
 		def run
-			
+			sleep_until_interrupted
+		end
+		
+		# This function should terminate any active processes in the daemon and return as quickly as possible.
+		def shutdown
+		end
+		
+		# The entry point from the newly forked process.
+		def spawn
 			self.title = self.name
 			
-			trap("INT") do
-				shutdown
+			self.startup
+			
+			begin
+				self.run
+			rescue Interrupt
+				$stderr.puts "Daemon interrupted, proceeding to shutdown."
 			end
 			
-			startup
+			self.shutdown
 		end
 		
 		# A shared instance of the daemon.
@@ -176,17 +181,17 @@ module Process
 			controller(options).daemonize(argv)
 		end
 		
-		# Start the daemon instance.
+		# Start the shared daemon instance.
 		def self.start
 			controller.start
 		end
 		
-		# Stop the daemon instance.
+		# Stop the shared daemon instance.
 		def self.stop
 			controller.stop
 		end
 		
-		# Check if the daemon is runnning or not.
+		# Check if the shared daemon instance is runnning or not.
 		def self.status
 			controller.status
 		end

data/lib/process/daemon/controller.rb

@@ -81,7 +81,7 @@ module Process
 					$stderr.sync = true
 
 					begin
-						@daemon.run
+						@daemon.spawn
 					rescue Exception => error
 						$stderr.puts "=== Daemon Exception Backtrace @ #{Time.now.to_s} ==="
 						$stderr.puts "#{error.class}: #{error.message}"
@@ -153,15 +153,22 @@ module Process
 				
 				return daemon_state
 			end
-
+			
+			# The pid of the daemon if it is available. The pid may be invalid if the daemon has crashed.
 			def pid
 				ProcessFile.recall(@daemon)
 			end
 
 			# How long to wait between checking the daemon process when shutting down:
 			STOP_PERIOD = 0.1
+			
+			# The number of attempts to stop the daemon using SIGTERM. On the last attempt, SIGKILL is used.
+			STOP_ATTEMPTS = 5
+			
+			# The factor which controls how long we sleep between attempts to kill the process. Only applies to processes which don't stop immediately.
+			STOP_WAIT_FACTOR = 3.0
 
-			# Stops the daemon process.
+			# Stops the daemon process. This function initially sends SIGINT. It waits STOP_PERIOD and checks if the daemon is still running. If it is, it sends SIGTERM, and then waits a bit longer. It tries STOP_ATTEMPTS times until it basically assumes the daemon is stuck and sends SIGKILL.
 			def stop
 				@output.puts Rainbow("Stopping #{@daemon.name} daemon...").blue
 
@@ -176,42 +183,63 @@ module Process
 				# Check if the @daemon is already stopped...
 				unless ProcessFile.running(@daemon)
 					@output.puts Rainbow("Pid #{pid} is not running. Has daemon crashed?").red
-
 					@daemon.tail_log($stderr)
-
 					return
 				end
 
-				# Interrupt the process group:
 				pgid = -Process.getpgid(pid)
-				Process.kill("INT", pgid)
 
-				(@stop_timeout / STOP_PERIOD).to_i.times do
-					sleep STOP_PERIOD if ProcessFile.running(@daemon)
-				end
-
-				# Kill/Term loop - if the @daemon didn't die easily, shoot
-				# it a few more times.
-				attempts = 5
-				while ProcessFile.running(@daemon) and attempts > 0
-					sig = (attempts <= 2) ? "KILL" : "TERM"
-
-					@output.puts Rainbow("Sending #{sig} to process group #{pgid}...").red
-					Process.kill(sig, pgid)
-
-					attempts -= 1
-					sleep 1
+				unless stop_by_interrupt(pgid)
+					stop_by_terminate_or_kill(pgid)
 				end
 
 				# If after doing our best the @daemon is still running (pretty odd)...
 				if ProcessFile.running(@daemon)
 					@output.puts Rainbow("Daemon appears to be still running!").red
 					return
+				else
+					@output.puts Rainbow("Daemon has left the building.").green
 				end
 
 				# Otherwise the @daemon has been stopped.
 				ProcessFile.clear(@daemon)
 			end
+			
+			private
+			
+			def stop_by_interrupt(pgid)
+				running = true
+				
+				# Interrupt the process group:
+				Process.kill("INT", pgid)
+
+				(@stop_timeout / STOP_PERIOD).ceil.times do
+					if running = ProcessFile.running(@daemon)
+						sleep STOP_PERIOD
+					end
+				end
+				
+				return running
+			end
+			
+			def stop_by_terminate_or_kill(pgid)
+				# TERM/KILL loop - if the daemon didn't die easily, shoot it a few more times.
+				(STOP_ATTEMPTS+1).times do |attempt|
+					break unless ProcessFile.running(@daemon)
+
+					# SIGKILL gets sent on the last attempt.
+					signal_name = (attempt < STOP_ATTEMPTS) ? "TERM" : "KILL"
+
+					@output.puts Rainbow("Sending #{signal_name} to process group #{pgid}...").red
+
+					Process.kill(signal_name, pgid)
+
+					# We iterate quickly to start with, and slow down if the process seems unresponsive.
+					timeout = STOP_PERIOD + (attempt.to_f / STOP_ATTEMPTS) * STOP_WAIT_FACTOR
+					@output.puts Rainbow("Waiting for #{timeout.round(1)}s for daemon to terminate...").blue
+					sleep(timeout)
+				end
+			end
 		end
 	end
 end

data/lib/process/daemon/log_file.rb

@@ -20,6 +20,7 @@
 
 module Process
 	class Daemon
+		# This is a special file instance which provides the ability to read a log file from the end backwards.
 		class LogFile < File
 			# Yields the lines of a log file in reverse order, once the yield statement returns true, stops, and returns the lines in order.
 			def tail_log

data/lib/process/daemon/notification.rb

@@ -0,0 +1,59 @@
+# 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
+	class Daemon
+		# This is a one shot cross-process notification mechanism using pipes. It can also be used in the same process if required, e.g. the self-pipe trick.
+		class Notification
+			def initialize
+				@output, @input = IO.pipe
+				
+				@signalled = false
+			end
+			
+			# Signal the notification.
+			def signal
+				@signalled = true
+				
+				@input.puts
+			end
+			
+			# Was this notification signalled?
+			def signalled?
+				@signalled
+			end
+			
+			# Wait/block until a signal is received. Optional timeout.
+			# @param timeout [Integer] the time to wait in seconds.
+			def wait(timeout: nil)
+				if timeout
+					read_ready, _, _ = IO.select([@output], [], [], timeout)
+					
+					return false unless read_ready and read_ready.any?
+				end
+				
+				@signalled or @output.read(1)
+				
+				# Just in case that this was split across multiple processes.
+				@signalled = true
+			end
+		end
+	end
+end

data/lib/process/daemon/privileges.rb

@@ -22,6 +22,7 @@ require 'etc'
 
 module Process
 	class Daemon
+		# Provides functions for changing the current user.
 		module Privileges
 			# Set the user of the current process. Supply either a user ID
 			# or a user name.
@@ -41,4 +42,4 @@ module Process
 			end
 		end
 	end
-end
+end

data/lib/process/daemon/version.rb

@@ -20,6 +20,6 @@
 
 module Process
 	class Daemon
-		VERSION = "0.5.5"
+		VERSION = "0.6.1"
 	end
 end

data/process-daemon.gemspec

@@ -9,8 +9,9 @@ Gem::Specification.new do |spec|
 	spec.authors       = ["Samuel Williams"]
 	spec.email         = ["samuel.williams@oriontransfer.co.nz"]
 	spec.summary       = %q{`Process::Daemon` is a stable and helpful base class for long running tasks and daemons. Provides standard `start`, `stop`, `restart`, `status` operations.}
-	spec.homepage      = ""
+	spec.homepage      = "https://github.com/ioquatix/process-daemon"
 	spec.license       = "MIT"
+	spec.has_rdoc      = "yard"
 
 	spec.files         = `git ls-files`.split($/)
 	spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
@@ -22,6 +23,6 @@ Gem::Specification.new do |spec|
 	spec.add_dependency "rainbow", "~> 2.0"
 	
 	spec.add_development_dependency "bundler", "~> 1.3"
-	spec.add_development_dependency "rspec", "~> 3.0.0.rc1"
+	spec.add_development_dependency "rspec", "~> 3.3.0"
 	spec.add_development_dependency "rake"
 end

data/spec/process/daemon/daemon.rb

@@ -1,4 +1,24 @@
 #!/usr/bin/env ruby
+#
+# 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/daemon'
 
@@ -28,19 +48,17 @@ class XMLRPCDaemon < Process::Daemon
 		end
 		
 		@rpc_server.mount("/RPC2", @listener)
-		
-		begin
-			@rpc_server.start
-		rescue Interrupt
-			puts "Daemon interrupted..."
-		ensure
-			@rpc_server.shutdown
-		end
 	end
 	
-	def shutdown
-		puts "Stopping the RPC server..."
-		@rpc_server.stop
+	def run
+		# This is the correct way to cleanly shutdown the server:
+		trap(:INT) do
+			@rpc_server.shutdown
+		end
+		
+		@rpc_server.start
+	ensure
+		@rpc_server.shutdown
 	end
 end
 

data/spec/process/daemon/daemon_spec.rb

@@ -1,6 +1,4 @@
-#!/usr/bin/env ruby
-
-# Copyright (c) 2007, 2009, 2011 Samuel G. D. Williams. <http://www.oriontransfer.co.nz>
+# Copyright, 2007, 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
@@ -55,22 +53,19 @@ module Process::Daemon::DaemonSpec
 			end
 
 			@rpc_server.mount("/RPC2", @listener)
-
-			begin
-				puts "Daemon starting..."
-				@rpc_server.start
-				puts "Daemon stopping..."
-			rescue Interrupt
-				puts "Daemon interrupted..."
-			ensure
-				puts "Daemon shutdown..."
+		end
+		
+		def run
+			# This is the correct way to cleanly shutdown the server, apparently:
+			trap(:INT) do
 				@rpc_server.shutdown
 			end
-		end
-
-		def shutdown
-			puts "Stopping the RPC server..."
-			@rpc_server.stop
+			
+			puts "RPC server starting..."
+			@rpc_server.start
+		ensure
+			puts "Stop accepting new connections to RPC server..."
+			@rpc_server.shutdown
 		end
 	end
 
@@ -79,7 +74,7 @@ module Process::Daemon::DaemonSpec
 			File.expand_path("../tmp", __FILE__)
 		end
 
-		def startup
+		def run
 			sleep 1 while true
 		end
 	end

data/spec/process/daemon/notification_spec.rb

@@ -0,0 +1,96 @@
+# 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 'process/daemon/notification'
+
+module Process::Daemon::NotificationSpec
+	describe Process::Daemon::Notification do
+		it "can be signalled multiple times" do
+			notification = Process::Daemon::Notification.new
+			
+			expect(notification.signalled?).to be_falsey
+			
+			notification.signal
+			
+			expect(notification.signalled?).to be_truthy
+			
+			notification.signal
+			notification.signal
+			
+			expect(notification.signalled?).to be_truthy
+		end
+		
+		it "can be signalled within trap context and across processes" do
+			notification = Process::Daemon::Notification.new
+			
+			pid = fork do
+				trap(:INT) do
+					notification.signal
+					exit(0)
+				end
+				
+				sleep
+			end
+			
+			Process.kill(:INT, pid)
+			
+			notification.wait(timeout: 1.0)
+			
+			expect(notification.signalled?).to be_truthy
+			
+			# Clean up zombie process
+			Process.waitpid(pid)
+		end
+		
+		it "should receive signal in child process" do
+			notification = Process::Daemon::Notification.new
+			
+			pid = fork do
+				if notification.wait(timeout: 60)
+					exit(0)
+				else
+					exit(1)
+				end
+			end
+			
+			notification.signal
+			
+			Process.waitpid(pid)
+			
+			expect($?.exitstatus).to be == 0
+		end
+		
+		it "should not receive signal in child process and time out" do
+			notification = Process::Daemon::Notification.new
+			
+			pid = fork do
+				if notification.wait(timeout: 0.01)
+					exit(0)
+				else
+					exit(1)
+				end
+			end
+			
+			Process.waitpid(pid)
+			
+			expect($?.exitstatus).to be == 1
+		end
+	end
+end

data/spec/process/daemon/privileges_spec.rb

@@ -0,0 +1,40 @@
+# 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 'process/daemon'
+require 'process/daemon/privileges'
+
+module Process::Daemon::PrivilegesSpec
+	describe Process::Daemon::Privileges do
+		let(:daemon) {SleepDaemon.instance}
+		
+		it "should save report current user" do
+			expect(Process::Daemon::Privileges.current_user).to be == `whoami`.chomp
+		end
+		
+		it "should change current user" do
+			current_user = Process::Daemon::Privileges.current_user
+			
+			Process::Daemon::Privileges.change_user(current_user)
+			
+			expect(Process::Daemon::Privileges.current_user).to be == current_user
+		end
+	end
+end

data/spec/process/daemon/process_file_spec.rb

@@ -0,0 +1,62 @@
+# 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 'process/daemon'
+require 'process/daemon/process_file'
+
+module Process::Daemon::ProcessFileSpec
+	class SleepDaemon < Process::Daemon
+		def working_directory
+			File.expand_path("../tmp", __FILE__)
+		end
+
+		def startup
+			sleep 1 while true
+		end
+	end
+
+	describe Process::Daemon::ProcessFile do
+		let(:daemon) {SleepDaemon.instance}
+		
+		it "should save pid" do
+			Process::Daemon::ProcessFile.store(daemon, $$)
+			
+			expect(Process::Daemon::ProcessFile.recall(daemon)).to be == $$
+		end
+		
+		it "should clear pid" do
+			Process::Daemon::ProcessFile.clear(daemon)
+			
+			expect(Process::Daemon::ProcessFile.recall(daemon)).to be nil
+		end
+		
+		it "should be running" do
+			Process::Daemon::ProcessFile.store(daemon, $$)
+			
+			expect(Process::Daemon::ProcessFile.status(daemon)).to be :running
+		end
+		
+		it "should not be running" do
+			Process::Daemon::ProcessFile.clear(daemon)
+			
+			expect(Process::Daemon::ProcessFile.status(daemon)).to be :stopped
+		end
+	end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: process-daemon
 version: !ruby/object:Gem::Version
-  version: 0.5.5
+  version: 0.6.1
 platform: ruby
 authors:
 - Samuel Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-29 00:00:00.000000000 Z
+date: 2015-08-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rainbow
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0.rc1
+        version: 3.3.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0.rc1
+        version: 3.3.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -74,6 +74,8 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rspec"
+- ".simplecov"
 - ".travis.yml"
 - Gemfile
 - README.md
@@ -81,13 +83,17 @@ files:
 - lib/process/daemon.rb
 - lib/process/daemon/controller.rb
 - lib/process/daemon/log_file.rb
+- lib/process/daemon/notification.rb
 - lib/process/daemon/privileges.rb
 - lib/process/daemon/process_file.rb
 - lib/process/daemon/version.rb
 - process-daemon.gemspec
 - spec/process/daemon/daemon.rb
 - spec/process/daemon/daemon_spec.rb
-homepage: ''
+- spec/process/daemon/notification_spec.rb
+- spec/process/daemon/privileges_spec.rb
+- spec/process/daemon/process_file_spec.rb
+homepage: https://github.com/ioquatix/process-daemon
 licenses:
 - MIT
 metadata: {}
@@ -115,3 +121,7 @@ summary: "`Process::Daemon` is a stable and helpful base class for long running
 test_files:
 - spec/process/daemon/daemon.rb
 - spec/process/daemon/daemon_spec.rb
+- spec/process/daemon/notification_spec.rb
+- spec/process/daemon/privileges_spec.rb
+- spec/process/daemon/process_file_spec.rb
+has_rdoc: yard