run_in_background 0.0.8

data/lib/run_in_background/version.rb

@@ -0,0 +1,5 @@
+module BBFS
+  module RunInBackground 
+    VERSION = "0.0.8"
+  end
+end

data/lib/run_in_background.rb

@@ -0,0 +1,433 @@
+# Author: Genady Petelko (nukegluk@gmail.com)
+# Description: The file contains implementation of 'RunInBackground' module.
+
+require 'params'
+require 'log'
+
+module BBFS
+  # This library provides a basic cross-platform functionality to run arbitrary ruby scripts
+  # in background and control them. <br>Supported platforms: Windows, Linux, Mac
+  #   NOTE UAC (User Account Control) should be disabled to use library on Windows 7:
+  #   * Click on the Windows Icon
+  #   * Click on the Control Panel
+  #   * Type in UAC in the search box (up-right corner of your window)
+  #   * Click on "Change User Account Control settings"
+  #   * Drag the slider down to either "Notify me when programs try to make changes to my computer"
+  #     or to disable it completely
+  #   * Reboot your computer when you're ready
+  # == General Limitations:
+  # *  Only ruby scripts can be run in background.
+  # *  No multiple instances with the same name.
+  # == Notes:
+  # *  Linux/Mac specific methods have _linux suffix
+  # *  Windows specific methods have _windows suffix
+  # *  While enhancing windows code, take care that paths are in windows format,
+  #    <br>e.i. with "\\" file separator while ruby by default uses a "/"
+  # *  Additional functionality such as restart, reload, etc. will be added on demand
+  # *  Remains support to provide platform specific options for start.
+  #    <br>For more information regarding such options
+  #    see documentation for win32-sevice (Windows), daemons (Linux/Mac)
+  # == Linux Notes:
+  # *  <tt>pid_dir</tt> parameter contains absolute path to directory where pid files will be stored.
+  #    <br>If directory doesn't exists then it will be created.
+  #    <br>User should have a read/write permissions to this location.
+  #    <br>Default location: <tt>$HOME/.bbfs/pids</tt>
+  # *  User should check that default pid directory is free from pid files of "killed" daemons.
+  #    <br>It may happen, for example, when system finished in abnormal way then pid files were
+  #    not deleted by daemons library.
+  #    <br>In such case incorrect results can be received, for example for <tt>exists?</tt> method
+  #    <br>One of the suggested methods can be before starting a daemon to check with <tt>exists?</tt>
+  #    method whether daemon already exists and with <tt>running?</tt> method does it running.
+  module RunInBackground
+    Params.string('bg_command', nil, 'Server\'s command. Commands are: start, delete and nil for' \
+                  ' not running in background.')
+    Params.string('service_name', File.basename($0), 'Background service name.')
+
+    # Maximal time in seconds to wait until OS will finish a requested operation,
+    # e.g. daemon start/delete.
+    TIMEOUT = 20
+
+    if RUBY_PLATFORM =~ /linux/ or RUBY_PLATFORM =~ /darwin/
+      begin
+        require 'daemons'
+        require 'fileutils'
+      rescue LoadError
+        require 'rubygems'
+        require 'daemons'
+        require 'fileutils'
+      end
+
+      OS = :LINUX
+      Params.string('pid_dir', File.expand_path(File.join(Dir.home, '.bbfs', 'pids')),
+        'Absolute path to directory, where pid files will be stored. ' + \
+        'User should have a read/write permissions to this location. ' + \
+        'If absent then it will be created. ' + \
+        'It\'s actual only for Linux/Mac. ' + \
+        'For more information see documentation on daemons module. ' +\
+        'Default location is: $HOME/.bbfs/pids')
+
+      if Dir.exists? Params['pid_dir']
+        unless File.directory? Params['pid_dir']
+         raise IOError.new("pid directory #{Params['pid_dir']} should be a directory")
+        end
+        unless File.readable?(Params['pid_dir']) && File.writable?(Params['pid_dir'])
+          raise IOError.new("you should have read/write permissions to pid dir: #{Params['pid_dir']}")
+        end
+      else
+        ::FileUtils.mkdir_p Params['pid_dir']
+      end
+    elsif RUBY_PLATFORM =~ /mingw/ or RUBY_PLATFORM =~ /ms/ or RUBY_PLATFORM =~ /win/
+      require 'rbconfig'
+      begin
+        require 'win32/service'
+        require 'win32/daemon'
+      rescue LoadError
+        require 'rubygems'
+        require 'win32/service'
+        require 'win32/daemon'
+      end
+      include Win32
+
+      OS = :WINDOWS
+      # Get ruby interpreter path. Need it to run ruby binary.
+      # <br>TODO check whether this code works with Windows Ruby Version Management (e.g. Pik)
+      RUBY_INTERPRETER_PATH = File.join(Config::CONFIG["bindir"],
+                                        Config::CONFIG["RUBY_INSTALL_NAME"] +
+                                            Config::CONFIG["EXEEXT"]).tr!('/','\\')
+
+      # Path has to be absolute cause Win32-Service demands it.
+      wrapper = File.join(File.dirname(__FILE__), "..", "bin", File.basename(__FILE__, ".rb"), "daemon_wrapper")
+      # Wrapper script, that can receive commands from Windows Service Control and run user script,
+      # <br> provided as it's argument
+      WRAPPER_SCRIPT = File.expand_path(wrapper).tr!('/','\\')
+    else
+      raise "Unsupported platform #{RUBY_PLATFORM}"
+    end
+
+    # Start a service/daemon.
+    # <br>It important to delete it after usage.
+    # ==== Arguments
+    # * <tt>binary_path</tt> - absolute path to the script that should be run in background
+    #     NOTE for Linux script should be executable and with UNIX end-of-lines (LF).
+    # * <tt>binary_args</tt> - Array (not nil) of script's command line arguments
+    # * <tt>name</tt> - service/daemon name.
+    #     NOTE should be unique
+    # * <tt>opts_specific</tt> - Hash of platform specific options (only for more specific usage)
+    #    For more information regarding such options see documentation for
+    #    win32-sevice (Windows), daemons (Linux/Mac)
+    # ==== Example (LINUX)
+    # <tt>  RunInBackground.start "/home/user/test_app", [], "daemon_test", {:monitor => true}</tt>
+    def RunInBackground.start binary_path, binary_args, name, opts_specific = {}
+      Log.debug1("executable that should be run as daemon/service: #{binary_path}")
+      Log.debug1("arguments: #{binary_args}")
+      Log.debug1("specific options: #{opts_specific}")
+
+      if binary_path == nil or binary_args == nil or name == nil
+        Log.error("binary path, binary args, name arguments must be defined")
+        raise ArgumentError.new("binary path, binary args, name arguments must be defined")
+      end
+
+      if OS == :WINDOWS
+        new_binary_path = String.new(binary_path)
+        new_binary_args = Array.new(binary_args)
+        wrap_windows new_binary_path, new_binary_args
+        start_windows new_binary_path, new_binary_args, name, opts_specific
+      else  # OS == LINUX
+        start_linux binary_path, binary_args, name, opts_specific
+      end
+
+      0.upto(TIMEOUT) do
+        if exists?(name) && running?(name)
+          puts "daemon/service #{name} started\n"
+          Log.info("daemon/service #{name} started")
+          return
+        end
+        sleep 1
+      end
+      # if got here then something gone wrong and daemon/service wasn't started in timely manner
+      delete name if exists? name
+      Log.error("daemon/service #{name} wasn't started in timely manner")
+      sleep(Params['log_param_max_elapsed_time_in_seconds_from_last_flush'] + 0.5)
+      raise "daemon/service #{name} wasn't started in timely manner"
+    end
+
+    def RunInBackground.start_linux binary_path, binary_args, name, opts = {}
+      unless File.executable? binary_path
+        raise ArgumentError.new("#{binary_path} is not executable.")
+      end
+
+      if opts.has_key? :dir
+        raise ArgumentError.new("No support for user-defined pid directories. See help")
+      end
+
+      opts[:app_name] = name
+      opts[:ARGV] = ['start']
+      (opts[:ARGV] << '--').concat(binary_args) if !binary_args.nil? && binary_args.size > 0
+      opts[:dir] = Params['pid_dir']
+      opts[:dir_mode] = :normal
+
+      Log.debug1("binary path: #{binary_path}")
+      Log.debug1("opts: #{opts}")
+
+      # Current process, that creates daemon, will transfer control to the Daemons library.
+      # So to continue working with current process, daemon creation initiated from separate process.
+      pid = fork do
+        Daemons.run binary_path, opts
+      end
+      Process.waitpid pid
+    end
+
+    def RunInBackground.start_windows binary_path, binary_args, name, opts = {}
+      raise ArgumentError.new("#{binary_path} doesn't exist'") unless File.exists? binary_path
+
+      # path that contains spaces must be escaped to be interpreted correctly
+      binary_path = %Q{"#{binary_path}"} if binary_path =~ / /
+      binary_path.tr!('/','\\')
+      # service should be run with the same load path as a current application
+      load_path = get_load_path
+      binary_args_str = binary_args.join ' '
+
+      opts[:binary_path_name] = \
+        "#{RUBY_INTERPRETER_PATH} #{load_path} #{binary_path} #{binary_args_str}"
+      # quotation marks must be escaped cause of ARGV parsing
+      opts[:binary_path_name] = opts[:binary_path_name].gsub '"', '"\\"'
+      opts[:service_name] = name
+      opts[:description] = name unless opts.has_key? :description
+      opts[:display_name] = name unless opts.has_key? :display_name
+      opts[:service_type] = Service::WIN32_OWN_PROCESS unless opts.has_key? :service_type
+      opts[:start_type] = Service::DEMAND_START unless opts.has_key? :start_type
+
+      # NOTE most of examples uses these dependencies. Meanwhile no explanations were found
+      opts[:dependencies] = ['W32Time','Schedule'] unless opts.has_key? :dependencies
+      # NOTE most of examples uses this option as defined beneath. The default is nil.
+      #opts[:load_order_group] = 'Network' unless opts.has_key? :load_order_group
+
+      Log.debug1("create service options: #{opts}")
+      Service.create(opts)
+      begin
+        Service.start(opts[:service_name])
+      rescue
+        Service.delete(opts[:service_name]) if Service.exists?(opts[:service_name])
+        raise
+      end
+    end
+
+    # Rerun current script in background.
+    # <br>Current process will be closed.
+    # <br>It suggested to remove from ARGV any command line arguments that point
+    # to run script in background, <br>otherwise an unexpexted result can be received
+    def RunInBackground.start! name, opts = {}
+      # $0 is the executable name.
+      start(File.expand_path($0), ARGV, name, opts)
+      sleep Params['log_param_max_elapsed_time_in_seconds_from_last_flush'] + 0.5
+      exit!
+    end
+
+    # Run in background script that was written as Windows Service, i.e. can receive signals
+    # from Service Control.
+    # <br>The code that is run in this script should be an extension of Win32::Daemon class.
+    # <br>For more information see Win32::Daemon help and examples.
+    # <br>No need  to wrap such a script.
+    def RunInBackground.start_win32service binary_path, binary_args, name, opts_specific = {}
+      Log.debug1("executable that should be run as service: #{binary_path}")
+      Log.debug1("arguments: #{binary_args}")
+      Log.debug1("specific options: #{opts_specific}")
+
+      if OS == :WINDOWS
+        start_windows binary_path, binary_args, name, opts_specific
+      else  # OS == :LINUX
+        raise NotImplementedError.new("Unsupported method on #{OS}")
+      end
+      0.upto(TIMEOUT) do
+        if exists?(name) && running?(name)
+          puts "windows service #{name} started\n"
+          Log.info("windows service #{name} started")
+          return
+        end
+        sleep 1
+      end
+      # if got here then something gone wrong and daemon/service wasn't started in timely manner
+      delete name if exists? name
+      Log.error("daemon/service #{name} wasn't started in timely manner")
+      sleep(Params['log_param_max_elapsed_time_in_seconds_from_last_flush'] + 0.5)
+      raise "daemon/service #{name} wasn't started in timely manner"
+    end
+
+    # Wrap an arbitrary ruby script withing script that can be run as Windows Service.
+    # ==== Arguments
+    # * <tt>binary_path</tt> - absolute path of the script that should be run in background
+    # * <tt>binary_args</tt> - array (not nil) of scripts command line arguments
+    #
+    #  NOTE binary_path and binary_args contents will be change
+    def RunInBackground.wrap_windows binary_path, binary_args
+      raise ArgumentError.new("#{binary_path} doesn't exists") unless File.exists? binary_path
+
+      # service should be run with the same load path as a current application
+      load_path = get_load_path
+      # path that contains spaces must be escaped to be interpreted correctly
+      binary_path = %Q{"#{binary_path}"} if binary_path =~ / /
+      binary_args.insert(0, RUBY_INTERPRETER_PATH, load_path, binary_path.tr('/','\\'))
+      binary_path.replace(WRAPPER_SCRIPT)
+    end
+
+    # NOTE if this method will become public then may be needed to change appropriately wrapper script
+    def RunInBackground.stop name
+      if not exists? name
+        raise ArgumentError.new("Daemon #{name} doesn't exists")
+      elsif OS == :WINDOWS
+        Service.stop(name)
+      else  # OS == :LINUX
+        opts = {:app_name => name,
+                :ARGV => ['stop'],
+                :dir_mode => :normal,
+                :dir => Params['pid_dir']
+               }
+        # Current process, that creates daemon, will transfer control to the Daemons library.
+        # So to continue working with current process, daemon creation initiated from separate process.
+        # It looks that it holds only for start command
+        #pid = fork do
+        Daemons.run "", opts
+        #end
+        #Process.waitpid pid
+      end
+    end
+
+    # Delete service/daemon.
+    # <br>If running then stop and delete.
+    def RunInBackground.delete name
+      if not exists? name
+        raise ArgumentError.new("Daemon #{name} doesn't exists")
+      elsif running? name
+        stop name
+      end
+      if OS == :WINDOWS
+        Service.delete name
+      else  # OS == :LINUX
+        opts = {:app_name => name,
+                :ARGV => ['zap'],
+                :dir_mode => :normal,
+                :dir => Params['pid_dir']
+               }
+        # Current process, that creates daemon, will transfer control to the Daemons library.
+        # So to continue working with current process, daemon creation initiated from separate process.
+        # It looks that it holds only for start command
+        #pid = fork do
+        Daemons.run "", opts
+        #end
+        #Process.waitpid pid
+      end
+      0.upto(TIMEOUT) do
+        unless exists? name
+          puts "daemon/service #{name} deleted\n"
+          Log.info("daemon/service #{name} deleted")
+          return
+        end
+        sleep 1
+      end
+      # if got here then something gone wrong and daemon/service wasn't deleted in timely manner
+      Log.error("daemon/service #{name} wasn't deleted in timely manner")
+      sleep(Params['log_param_max_elapsed_time_in_seconds_from_last_flush'] + 0.5)
+      raise "daemon/service #{name} wasn't deleted in timely manner"
+    end
+
+    def RunInBackground.exists? name
+      if name == nil
+        raise ArgumentError.new("service/daemon name argument must be defined")
+      elsif OS == :WINDOWS
+        Service.exists? name
+      else  # OS == :LINUX
+        pid_files = Daemons::PidFile.find_files(Params['pid_dir'], name)
+        pid_files != nil && pid_files.size > 0
+      end
+    end
+
+    def RunInBackground.running? name
+      if not exists? name
+        raise ArgumentError.new("Daemon #{name} doesn't exists")
+      elsif OS == :WINDOWS
+        Service.status(name).current_state == 'running'
+      else  # OS == :LINUX
+        Daemons::Pid.running? name
+      end
+    end
+
+    # Returns absolute standard form of the path.
+    # It includes path separators accepted on this OS
+    def RunInBackground.get_abs_std_path path
+      path = File.expand_path path
+      path = path.tr('/','\\') if OS == :WINDOWS
+      path
+    end
+
+    # Returns load path as it provided in command line.
+    def RunInBackground.get_load_path
+      load_path = Array.new
+      $:.each do |location|
+        load_path << %Q{-I"#{get_abs_std_path(location)}"}
+      end
+      load_path.join ' '
+    end
+
+    # Prepare ARGV so it can be provided as a command line arguments.
+    # Remove bg_command from ARGV to prevent infinite recursion.
+    def RunInBackground.prepare_argv
+      new_argv = Array.new
+      ARGV.each do |arg|
+        # For each argument try splitting to 'name'='value'
+        arg_arr = arg.split '='
+        # If no '=' is argument, just copy paste.
+        if arg_arr.size == 1
+          arg = "\"#{arg}\"" if arg =~ / /
+          new_argv << arg
+        # If it is a 'name'='value' argument add "" so the value can be passed as argument again.
+        elsif arg_arr.size == 2
+          # Skip bg_command flag (remove infinite recursion)!
+          if arg_arr[0] !~ /bg_command/
+            arg_arr[1] = "\"#{arg_arr[1]}\"" if arg_arr[1] =~ / /
+            new_argv << arg_arr.join('=')
+          end
+        else
+          Log.warning("ARGV argument #{arg} wasn't processed")
+          new_argv << arg
+        end
+      end
+      ARGV.clear
+      ARGV.concat new_argv
+    end
+
+    def RunInBackground.run &b
+      case Params['bg_command']
+        when nil
+          yield b
+        when 'start'
+          # To prevent service enter loop cause of background parameter
+          # all options that points to run in background must be disabled
+          # (for more information see documentation for RunInBackground::start!)
+          Params['bg_command'] = nil
+          RunInBackground.prepare_argv
+
+          begin
+            RunInBackground.start! Params['service_name']
+          rescue Exception => e
+            Log.error("Start service command failed: #{e.message}")
+            raise
+          end
+        when 'delete'
+          if RunInBackground.exists? Params['service_name']
+            RunInBackground.delete Params['service_name']
+          else
+            msg = "Can't delete. Service #{Params['service_name']} already deleted"
+            puts msg
+            Log.warning(msg)
+          end
+        else
+          msg = "Unsupported command #{Params['bg_command']}. Supported commands are: start, delete"
+          puts msg
+          Log.error(msg)
+      end
+    end
+
+    private_class_method :start_linux, :start_windows, :wrap_windows, :stop, :get_abs_std_path,\
+      :get_load_path
+  end
+end

data/test/run_in_background/run_in_background_test.rb

@@ -0,0 +1,124 @@
+require 'test/unit'
+require 'run_in_background'
+
+module BBFS
+  # TODO break to number of small tests according to functionality
+  # TODO rewrite with Shoulda/RSpec
+  class TestRunInBackground < Test::Unit::TestCase
+    #include BBFS::RunInBackground
+
+    if RUBY_PLATFORM =~ /linux/ or RUBY_PLATFORM =~ /darwin/
+      OS = :LINUX
+    elsif RUBY_PLATFORM =~ /mingw/ or RUBY_PLATFORM =~ /ms/ or RUBY_PLATFORM =~ /win/
+      require 'sys/uname'
+      OS = :WINDOWS
+    else
+      raise "Unsupported platform #{RUBY_PLATFORM}"
+    end
+
+    def setup
+      @good_daemon = "good_daemon_test"
+      @good_daemonize = "good_daemonize_test"
+      @good_win32daemon = "good_win32daemon_test"
+      @bad_daemon = "bad_daemon_test"
+      @binary = File.join(File.dirname(File.expand_path(__FILE__)), 'test_app')
+      @binary.tr!('/','\\') if OS == :WINDOWS
+      File.chmod(0755, @binary) if OS == :LINUX && !File.executable?(@binary)
+      @absent_binary = File.join(File.dirname(File.expand_path(__FILE__)), "test_app_absent")
+    end
+
+    def test_functionality
+      if OS == :WINDOWS && Sys::Uname.sysname =~ /(Windows 7)/
+        skip "This test shouldn't be run on #{$1}"
+      end
+
+      # test start
+      # test application should actually start here
+      assert_nothing_raised{ RunInBackground.start(@binary, ["1000"], @good_daemon) }
+      assert_raise(ArgumentError) { RunInBackground.start(@absent_binary, ["1000"], @bad_daemon) }
+
+      # start arguments have to be defined
+      assert_raise(ArgumentError) { RunInBackground.start(["1000"], @bad_daemon) }
+      assert_raise(ArgumentError) { RunInBackground.start(nil, ["1000"], @bad_daemon) }
+      assert_raise(ArgumentError) { RunInBackground.start(@absent_binary, nil, @bad_daemon) }
+      assert_raise(ArgumentError) { RunInBackground.start(@absent_binary, ["1000"], nil) }
+
+      # test exists?
+      assert_raise(ArgumentError) { RunInBackground.exists? }
+      assert_equal(false, RunInBackground.exists?(@bad_daemon))
+      assert_equal(true, RunInBackground.exists?(@good_daemon))
+
+      # test running?
+      # if stop method will be public need to add test checks actually stopped daemon
+      assert_raise(ArgumentError) { RunInBackground.running? }
+      assert_raise(ArgumentError) { RunInBackground.running?(@bad_daemon) }
+      assert_equal(true, RunInBackground.running?(@good_daemon))
+
+      # test daemonazing (start!)
+      # from the nature of daemonization need to run it from another process that will be daemonized
+      ruby = (OS == :WINDOWS ? RunInBackground::RUBY_INTERPRETER_PATH : "ruby")
+      cmd = "#{ruby} -Ilib #{@binary} 50 #{@good_daemonize}"
+      pid = spawn(cmd)
+      Process.waitpid pid
+      # checking that it indeed was daemonized
+      # e.i. process was killed and code rerun in background
+      # it takes time to the OS to remove process, so using a timeout here
+      0.upto(RunInBackground::TIMEOUT) do
+        begin
+          Process.kill(0, pid)
+        rescue Errno::ESRCH
+          break
+        end
+        sleep 1
+      end
+      assert_raise(Errno::ESRCH) { Process.kill(0, pid) }
+      assert_equal(true, RunInBackground.exists?(@good_daemonize))
+      assert_equal(true, RunInBackground.running?(@good_daemonize))
+
+      # test running win32 specific daemon (start_win32service)
+      # wrapper script will be run
+      if OS == :WINDOWS
+        win32service_arg = [RunInBackground::RUBY_INTERPRETER_PATH, @binary, 1000]
+        assert_nothing_raised{
+          RunInBackground.start_win32service(RunInBackground::WRAPPER_SCRIPT,
+                                             win32service_arg, @good_win32daemon)
+        }
+        assert_equal(true, RunInBackground.exists?(@good_win32daemon))
+        assert_equal(true, RunInBackground.running?(@good_win32daemon))
+      else
+        assert_raise(NotImplementedError) {
+          RunInBackground.start_win32service(@absent_binary, [], @bad_daemon)
+        }
+      end
+
+      # uncomment following lines if there is a suspicion that something gone wrong
+      # inspired by bug caused by coworking of daemon_wrapper an logger
+      #sleep 10
+      #assert_equal(true, RunInBackground.running?(@good_daemon))
+      #assert_equal(true, RunInBackground.running?(@good_daemonize))
+      #assert_equal(true, RunInBackground.running?(@good_win32daemon))
+
+      # test delete
+      # test application should actually stop here
+      assert_raise(ArgumentError) { RunInBackground.delete }
+      assert_raise(ArgumentError) { RunInBackground.delete(@bad_daemon) }
+      assert_nothing_raised { RunInBackground.delete(@good_daemon) }
+      assert_equal(false, RunInBackground.exists?(@good_daemon))
+
+      assert_nothing_raised { RunInBackground.delete(@good_daemonize) }
+      assert_equal(false, RunInBackground.exists?(@good_daemonize))
+
+      # actuall only for Windows platform
+      if RunInBackground.exists?(@good_win32daemon)
+        assert_nothing_raised { RunInBackground.delete(@good_win32daemon) }
+        assert_equal(false, RunInBackground.exists?(@good_win32daemon))
+      end
+    end
+
+    def teardown
+      RunInBackground.delete @good_daemon if RunInBackground.exists? @good_daemon
+      RunInBackground.delete @good_daemonize if RunInBackground.exists? @good_daemonize
+      RunInBackground.delete @good_win32daemon if RunInBackground.exists? @good_win32daemon
+    end
+  end
+end

data/test/run_in_background/test_app

@@ -0,0 +1,58 @@
+#!/usr/bin/env ruby
+
+# Toy script used for RunInBackground tests.
+# usage: $0 number_of_iterations [daemon_name_if_daemonized]
+
+DBG = false  # NOTE be sure to disable it in production 
+
+begin
+  begin
+    require 'log'
+    require 'params'
+  rescue LoadError
+    $:.unshift(File.join(File.dirname(File.expand_path(__FILE__)), '..', '..', 'lib'))
+    $:.unshift(File.join(File.dirname(File.expand_path(__FILE__)), '..', '..'))
+    require 'log'
+    require 'params'
+  end
+
+  # On WindowsXP log can be found under:
+  # C:/Documents and Settings/NetworkService/.bbfs/test_app_<pid>.log
+  BBFS::Params['log_file_name'] = File.join(Dir.home, '.bbfs', "#{File.basename(__FILE__)}_#{Process.pid}.log")
+  BBFS::Params['log_write_to_console'] = false
+  BBFS::Params['log_param_max_elapsed_time_in_seconds_from_last_flush'] = 1
+  if DBG
+    BBFS::Params['log_debug_level'] = 1
+    BBFS::Log.init
+  end
+
+  # app should be run in background
+  if ARGV.size == 2 
+    begin
+      require 'run_in_background'
+    rescue LoadError
+      $:.unshift(File.join(File.dirname(File.expand_path(__FILE__)), '..', '..', 'lib'))
+      $:.unshift(File.join(File.dirname(File.expand_path(__FILE__)), '..', '..'))
+      require 'run_in_background'
+    end
+
+    BBFS::Log.debug1 "Before run in background: PID #{Process.pid}"
+    # ARGV.pop returns frozen string and thus causes a failure of Service.create
+    # to fix it new string with the same content created.
+    BBFS::RunInBackground.start!(String.new(ARGV.pop))
+    # if got here then error
+    BBFS::Log.error "After run in background: ERROR"
+  end
+
+  max = (ARGV.size > 0 && ARGV[0] != nil && ARGV[0].to_i > 0)? ARGV[0].to_i : 200
+
+  while max > 0
+    BBFS::Log.debug1 "#{max}"
+    sleep 1
+    max -= 1
+  end
+
+rescue Exception => err
+  BBFS::Log.error "Wrapper error: #{err}" 
+  raise
+end

metadata

@@ -0,0 +1,132 @@
+--- !ruby/object:Gem::Specification
+name: run_in_background
+version: !ruby/object:Gem::Version
+  version: 0.0.8
+  prerelease: 
+platform: ruby
+authors:
+- Genady Petelko
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: log
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: params
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: daemons
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: win32-service
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sys-uname
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! 'This library provides a basic cross-platform functionality to runarbitrary
+  ruby scripts in background and control them.Supported platforms: Windows, Linux,
+  Mac.'
+email: nukegluk@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/run_in_background.rb
+- lib/run_in_background/version.rb
+- test/run_in_background/run_in_background_test.rb
+- test/run_in_background/test_app
+homepage: http://github.com/kolmanv/bbfs
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Cross-platform library for daemons management.
+test_files:
+- test/run_in_background/run_in_background_test.rb
+- test/run_in_background/test_app