insidious 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a06590a6526782e830ee32da0b2a75062e1d6135
+  data.tar.gz: e1f942f31bf0a442b8d2eecb7be8652e3e5447d4
+SHA512:
+  metadata.gz: d755c4f24aaa7c2ca630308e6902f63edb07c1388a9b85a2b02ad6f3f0f80c4337337b8eb06ae3d1e888fec478971743d7273ec213c6c09894bb99622276ead9
+  data.tar.gz: 17095faa0d8e2243e0ee67cc6f55538d784c301a1a568dab425c06cedeaec56afe95853c307c50f1f524c973ec6d7ba3e970615dadddc1fc19e3115bf5f15415

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 James White
+
+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/README.md

@@ -0,0 +1,36 @@
+Insidious [![Gem Version](http://img.shields.io/gem/v/insidious.svg)](https://rubygems.org/gems/insidious) [![Code Climate](http://img.shields.io/codeclimate/github/jamesrwhite/insidious.svg)](https://codeclimate.com/github/jamesrwhite/insidious)
+----------
+
+A simple and flexible ruby gem for managing daemons.
+
+### Usage
+
+Coming soon but for now check out [examples/insidious.rb](https://github.com/jamesrwhite/insidious/blob/master/examples/insidious.rb).
+
+### Credit
+
+insidious is a fork of [fallen](https://github.com/inkel/fallen) by [@inkel](https://github.com/inkel) and a lot of credit for this goes to him.
+
+### License
+
+The MIT License (MIT)
+
+Copyright (c) 2014 James White
+
+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

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+
+# Show a list of tasks by default
+task :default do
+  puts `rake --tasks`
+end

data/lib/insidious.rb

@@ -0,0 +1,166 @@
+class Insidious
+  attr_accessor :pid_file
+  attr_accessor :pid
+  attr_accessor :stdin
+  attr_accessor :stdout
+  attr_accessor :stderr
+
+  def initialize(options = {})
+    @daemonize = options[:daemonize].nil? ? true : options[:daemonize]
+    @pid_file = options[:pid_file]
+    @stdin = options[:stdin]
+    @stdout = options[:stdout]
+    @stderr = options[:stderr]
+  end
+
+  # Runs the daemon
+  #
+  # This will set up `INT` & `TERM` signal handlers to stop execution
+  # properly. When this signal handlers are called it will also call
+  # the #interrupt method and delete the pid file
+  def run!(&block)
+    begin
+      if @daemonize
+        Process.daemon(true, (stdin || stdout || stderr))
+      end
+
+      save_pid_file
+
+      block.call
+    rescue Interrupt, SignalException
+      interrupt
+    end
+  end
+
+  # Handles an interrupt (`SIGINT` or `SIGTERM`) properly as it
+  # deletes the pid file and calles the `stop` method.
+  def interrupt
+    File.delete(pid_file) if pid_file && File.exists?(pid_file)
+  end
+
+  # Starts the daemon
+  #
+  # If a PID file was provided it will try to store the current
+  # PID. If this files exists it will try to check if the stored PID
+  # is already running, in which case insidious will exit with an error
+  # code.
+  def start!(&block)
+    if pid_file && File.exists?(pid_file)
+      begin
+        Process.kill(0, pid)
+        STDERR.puts("Daemon is already running with PID #{pid}")
+        exit 2
+      rescue Errno::ESRCH
+        run!(&block)
+      end
+    else
+      if (pid_file.nil? && daemonize)
+        STDERR.puts('No PID file is set but daemonize is set to true')
+        exit 1
+      end
+
+      run!(&block)
+    end
+  end
+
+  # Stops the daemon execution
+  #
+  # This method only works when a PID file is given, otherwise it will
+  # exit with an error.
+  def stop!
+    if pid_file && File.exists?(pid_file)
+      begin
+        Process.kill(:INT, pid)
+        File.delete(pid_file)
+      rescue Errno::ESRCH
+        STDERR.puts("No daemon is running with PID #{pid}")
+        exit 3
+      end
+    else
+      STDERR.puts("Couldn't find the PID file: '#{pid_file}'")
+      exit 1
+    end
+  end
+
+  # Restarts the daemon
+  def restart!(&block)
+    stop!
+    start!(&block)
+  end
+
+  # Get the pid from the pid_file
+  def pid
+    File.read(@pid_file).strip.to_i
+  end
+
+  # Returns `true` if the daemon is running
+  def running?
+    # First check if we have a pid file and if it exists
+    if pid_file.nil? || !File.exists?(pid_file)
+      return false
+    end
+
+    begin
+      Process.getpgid(pid)
+      true
+    rescue Errno::ESRCH
+      false
+    end
+  end
+
+  # Returns true if insidious is running as a daemon which is the default
+  def daemon?
+    @daemonize
+  end
+
+  # Changes the working directory
+  #
+  # All paths will be relative to the working directory unless they're
+  # specified as absolute paths.
+  #
+  # @param [String] path of the new workng directory
+  def chdir!(path)
+    Dir.chdir(File.absolute_path(path))
+  end
+
+  # Set the path where the PID file will be created
+  def pid_file=(path)
+    @pid_file = File.absolute_path(path)
+  end
+
+  # Reopens `STDIN` for reading from `path`
+  #
+  # This path is relative to the working directory unless an absolute
+  # path is given.
+  def stdin=(path)
+    @stdin = File.absolute_path(path)
+    STDIN.reopen(@stdin)
+  end
+
+  # Reopens `STDOUT` for writing to `path`
+  #
+  # This path is relative to the working directory unless an absolute
+  # path is given.
+  def stdout=(path)
+    @stdout = File.absolute_path(path)
+    STDOUT.reopen(@stdout, 'a')
+  end
+
+  # Reopens `STDERR` for writing to `path`
+  #
+  # This path is relative to the working directory unless an absolute
+  # path is given.
+  def stderr=(path)
+    @stderr = File.absolute_path(path)
+    STDERR.reopen(stderr, 'a')
+  end
+
+  private
+
+  # Save the falen angel PID to the PID file specified in `pid_file`
+  def save_pid_file
+    File.open(pid_file, 'w') do |fp|
+      fp.write(Process.pid)
+    end if pid_file
+  end
+end

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: insidious
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- James White
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-02 00:00:00.000000000 Z
+dependencies: []
+description: 
+email:
+- dev.jameswhite@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- lib/insidious.rb
+homepage: https://github.com/jamesrwhite/insidious
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.3g
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A simple and flexible ruby gem for managing daemons.
+test_files: []