daemon-ogre 1.5.0 → 2.0.0

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    ZTliYTU5NmU3YjJjYTI0YzAwYzdjODhiYWZhMzdlMzk5ZmQ5ZGFkOQ==
-  data.tar.gz: !binary |-
-    MGY0M2QzZWZmNjczMTEwOTE5MmRkOWIzMDRmMzFjYWJjYTIzZThjNg==
+SHA1:
+  metadata.gz: b48b7bf70cfcc86e840c955ade329eee5e2c93d9
+  data.tar.gz: 390384cf25cd89b59c855d8a6c53a4fa8ac76a5a
 SHA512:
-  metadata.gz: !binary |-
-    MmE5OGZjMGQxOTIwYzA1MDZiYWU0ZjExNzdmYzJlOWE0NTEyMjUzOTAxOTEy
-    OWMwZGZlYjdkN2NhMTBlMzYxYzhhNTIwYzllZjViMDhjMjgwMGZiMWFjNGJh
-    Nzg0NmMyMTQ3MzM3NjYwMzk5YzgxOWQ2NTJmNDg4NGIzZGU3OWU=
-  data.tar.gz: !binary |-
-    ODVkOTNjOTIxNGMzNjEzYjlmNDhjOGE2ZmUyYzAwODhiZDIwZGE3ZjI1MGE5
-    MmZmMTVmZGQ0ZTkzNWFmYmIwNjdkYzIxMDE3YzZjNTFmNzRlZTQxNmIyN2U5
-    OWQ0ZjM4OTM1YmIzZDcxNTZmYTEzOThhN2JlYTgxNGJhYjkyNTg=
+  metadata.gz: ee07df0736ac91c0b7adc146b5fe8702996dce03935c52cf6ab94ce01a094be7821d626ba4fadc2750d266dd806835b5bb69e4b89f441e31fde5af68ca42d9a7
+  data.tar.gz: 1c4f03bf3b2b86b6c8710f8cf0901b3cf96c4cc6d0825094f91b0807a1370b27451741375876990d2a7f79a5208f392028637e67c4c90eace0c5d08603161983

data/.gitignore

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

data/Gemfile.lock

@@ -1,26 +1,21 @@
+PATH
+  remote: .
+  specs:
+    daemon-ogre (2.0.0)
+      argv (>= 2.0.1)
+      tmp (>= 2.0.1)
+
 GEM
   remote: http://rubygems.org/
   specs:
-    columnize (0.3.6)
-    debugger (1.5.0)
-      columnize (>= 0.3.1)
-      debugger-linecache (~> 1.2.0)
-      debugger-ruby_core_source (~> 1.2.0)
-    debugger-linecache (1.2.0)
-    debugger-ruby_core_source (1.2.0)
-    git (1.2.5)
-    jeweler (1.8.4)
-      bundler (~> 1.0)
-      git (>= 1.2.5)
-      rake
-      rdoc
+    argv (2.0.1)
     rake (10.0.4)
-    rdoc (3.9.5)
+    tmp (2.1.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  debugger
-  jeweler (~> 1.8.4)
-  rdoc
+  bundler
+  daemon-ogre!
+  rake

data/README.md

@@ -4,23 +4,8 @@ daemon-ogre
 Description
 -----------
 
-WARNING!
-The gem will be not updated in the future but redirected to my other project:
-Procemon
-https://github.com/adamluzsi/procemon
-All the functions are implemented and upgraded in all meaning there what you liked in daemon-ogre
-
-
-This gem is made for one purpose. 
-
-Ruby meant to be for easy use, not hardcore coding! 
-And in terms for this, ogre will aid you in the brute way, so you can relax... 
-
-
-so all you need is enjoy your code! 
-Follow me on Github and send request, 
-if you have idea what can be usefull in creating your app :) 
-
+This module made for easy argv based damonize for the app.
+100% compatible with any framework
 
 
 Installation
@@ -31,209 +16,26 @@ Installation
     $ gem install 'daemon-ogre'
 
 
-    require 'daemon-ogre'
-    DaemonOgre.start
-
-
-but we love config our beloved App!
------------------------------------
-
-
-    DaemonOgre.start :name      => "MySuperAppName!",          #this will be the name of the application
-                     :log_path  => "./var/log/log_file_name",  #this will be the logfile place and name
-                     :pid_path  => "./var/pid/pid_file_name",  #this will be the pidfile place and name
-                     :terminate => true                        #this command not let start your code if it's not started
-                                                               # with "start" arguments like :
-                                                               #                  ruby my_awsome_app.rb start
-
-
-In use?
--------
-
-
-you can simply use your terminal with arguments like
-* start - for start the process if you choosed :terminate => true in code like above
-start command will check does the application already running or not, so you dont have to worry about
-
-* stop        - will terminate the running application
-* restart     - will stop the process if that is already running than start again
-* debug or -d - this will show the fancy loadings if you want look busy by coding big stuffs :) (or debug your code)
-* debugger    - this will call the ruby debugger gem to aid you in trouble
-you should use these commands:
-
-
-    set autolist on   #show the code, and the position like and editor, in every step. 
-    s                 #step in any kind of method, beware to use carefully because you end up in really deep somewhere in Alice world
-    n                 #step to next code/codeblock etc, without enter it (usefull when you find the right place)
-    l                 #list your current position
-                      #simply hit enter to repeate the last one
-    
-    
-* daemon       -this will fork a child process by the given parameters
-* log    or -l -you can set the log file position n by terminal for one time run
-* pid    or -p -you can set the pid file position n name by terminal for one time run
-* status or -s -this will tell you ,does your process is running not 
-* help         -this will invoke some help to the terminal if you out of luck and forget everything from this page
-* clear        -this will remove every log by the prev given paths, usefull in debugging
-
-example:
-
-    ruby my_awsome_app.rb start debugger
-    ruby my_awsome_app.rb start clear
-    ruby my_awsome_app.rb status
-    ruby my_awsome_app.rb stop
-    ruby my_awsome_app.rb debug
-   
-   
-or if you dont use terminate command , than you can start simply as how you do normaly
-
-
-
-othere stuffs to use:
----------------------
-everybody love: require_relative...
-so why should not try require_directory instead all the fuss
-you can tell to it if you want some file to be excluded or just delayed loaded,
-because you want them loaded in the last place
-Example:
-
-
-    require_directory "some_dir_name_from_here_where_are_multi_dir_levels"
-
-or
-
-    require_directory "some_dir_name_from_here_where_are_multi_dir_levels",
-                      :delayed  => ["files","to","be","delayed","in","load"],
-                      :excluded => ["files","to","be","excluded","in","load"],
-                      :type     => "rb"
-
-remember, you can use any of those modifier hash-tag by it self only! :)
-by default the type will be .rb files
-
-
-Helpers
--------
-
-and ofc what else what we love if not our beloved yml-s
-we should use a nice Config constant for this(or at least i love to do)
-
-    CONFIG = require_ymls "some_dir_name_from_here_where_are_the_yml_files_in_multi_dir_level"
-
-the file names will be the hash-key and under that , there will be the yml file datas loaded in
-
-And if we are at hashs, than when you need remove an element perm, or not perm you can use
-* remove  will return the hash w/o the the key
-* remove! will delete the key, than return the hash
-example:
-
-    CONFIG.remove  key
-    CONFIG.remove! key
-
-
-
-
-
-if you need get a free port in a range or from, you can use this:
-
-    get_port(from_nmb,to_nmb,host)
-
-or by simply
-
-    get_port(number)
-
-
-and if you hate find all the bugs... you can use error_logger at your command like this if you running your process on
-background and cannot puts on the terminal:
-
-
-    exlogger msg, #anything after this is optionable
-             :path   => "./per_relative-absoluth_path",
-             :prefix => "it's something..."
-
-    
-or with less fuss at the exception handle:
-    
-    
-    begin
-    
-    rescue Exception => ex
-        ex.logger
-    end
-    
-
-or the better way to do Exception handle is to rescue only those exceptions what we are know will be raised! so the app broke if something unexpected stupp come up! (development:)
-
-
-    begin
-      raise ArgumentError, "failed"
-    rescue ArgumentError => ex
-      ex.logger
-    end
-    
-    
-
-
-if you need methods from any kind of class without the object methods, you should try this!
-
-
-    Xyclassname.class_methods
-
-
-you want make some test script with rnd numbers, strings, dates, bools etc? use the Rnd class at your command
-
-
-    Rnd
-    -string
-    -integer
-    -boolean
-    -date
-
-
-examples:
-
-
-    Rnd.number(100)
-    Rnd.string(15,2) #for rnd bla bla names
-    
-
-
-You need get the index of an Array element? you can use:
-
-
-
-    array_variable.index_of("something)
-
-
-Do you wanted to know , does that process running on that pid or not?
-
-
-
-    process_running?(nmbr)
-
-
-
-
-in Short:
----------
+```ruby
 
     require 'daemon-ogre'
-    DaemonOgre.start
-    your_Super_app_code!
+    DaemonOgre.init
 
+```
 
+after this, the app will check for the following tags in the input:
+:d, :daemon, :daemonize for daemonize the app
+:k, :kill,   :terminate for terminate already initialized app instance
 
+you can set the output folder if you dont like the default in the system tmp / "#{your_app_folder_name}_daemon"
 
+```ruby
 
-Contributing to daemon-ogre
----------------------------
+    #> for example
+    DaemonOgre::OPTS.tmp_folder_path File.join(File.dirname(__FILE__),"tmp")
+
+```
 
-* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
-* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
-* Fork the project.
-* Start a feature/bugfix branch.
-* Commit and push until you are happy with your contribution.
-* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
 
 Copyright
 ---------
@@ -242,5 +44,4 @@ Right to copy and use at your service fellow coder
 Copyright (c) 2013 adam.luzsi. See LICENSE.txt for
 further details.
 
-
 daemon-ogre

data/VERSION

@@ -1 +1 @@
-1.5.0
+2.0.0

data/daemon-ogre.gemspec

@@ -1,32 +1,26 @@
 # -*- encoding: utf-8 -*-
 
-require File.expand_path(File.join(File.dirname(__FILE__),"files.rb"))
-
 Gem::Specification.new do |spec|
 
   spec.name           = "daemon-ogre"
-
   spec.version        = File.open(File.join(File.dirname(__FILE__),"VERSION")).read.split("\n")[0].chomp.gsub(' ','')
-
-  spec.authors        = ["Adam.Luzsi"]
-  spec.email          = "adamluzsi@gmail.com"
+  spec.authors        = ["Adam Luzsi"]
+  spec.email          = ["adamluzsi@gmail.com"]
+  spec.homepage       = "http://github.com/adamluzsi/daemon-ogre"
 
   spec.description    = "Simple to use app ARGV based daemonizer"
-  spec.summary        = %q{DSL for helping make file loads and configuration objects }
+  spec.summary        = "Simple to use app ARGV based daemonizer"
 
-  spec.extra_rdoc_files = [
-    "LICENSE.txt",
-    "README.md",
-    "README.rdoc"
-  ]
-
-  spec.files          = SpecFiles
+  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.homepage = "http://github.com/adamluzsi/daemon-ogre"
-  spec.licenses = ["MIT"]
+  spec.add_dependency "argv",">= 2.0.1"
+  spec.add_dependency "tmp",">= 2.0.1"
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
 
 end
 

data/example/daemonizable.rb

@@ -0,0 +1,16 @@
+require 'daemon-ogre.rb'
+
+# start as
+#   ruby sample_daemon_app.rb --daemon
+#
+# to check it's running
+#   `ps aux | grep $0`
+
+DaemonOgre.init
+
+60.times do
+
+  puts Time.now
+  sleep 1
+
+end

data/lib/daemon-ogre/argv.rb

@@ -0,0 +1,29 @@
+module DaemonOgre
+
+  module DARGV
+    class << self
+
+      def check_args_for *args
+
+        ::ARGV.flag_syms.each do |element|
+          if args.include?(element)
+            return true
+          end
+        end
+        return false
+
+      end
+
+      def daemonize?
+        check_args_for( *[:d,:daemon,:daemonize])
+      end
+      alias :daemon? :daemonize?
+
+      def terminate?
+        check_args_for( *[:k,:kill,:terminate])
+      end
+
+    end
+  end
+
+end

data/lib/daemon-ogre/daemon.rb

@@ -1,65 +1,173 @@
-#DaemonOgreBody
-begin
-  module DaemonOgre
-
-    #DaemonEngine
-    begin
-      class Daemon
-        # Checks to see if the current process is the child process and if not
-        # will update the pid file with the child pid.
-        def self.start pid, pidfile, outfile, errfile
-          unless pid.nil?
-            raise "Fork failed" if pid == -1
-            write pid, pidfile #for kill we need a pidfile
-            exit
-          else
-            redirect outfile, errfile
+# use Daemon.daemonize or Process.daemonize
+module DaemonOgre
+
+  module Daemon
+
+    class << self
+
+
+      # Checks to see if the current process is the child process and if not
+      # will update the pid file with the child pid.
+      def start pid
+        unless pid.nil?
+          raise "Fork failed" if pid == -1
+          OPTS.pidfile= pid
+          ::Kernel.exit
+        else
+          redirect
+        end
+      end
+
+      # Attempts to write the pid of the forked process to the pid file.
+      def write pid
+        OPTS.pid= pid
+
+        File.open pidfile, "a+" do |new_line|
+          new_line.write "#{pid}\n"
+        end
+
+      rescue ::Exception => e
+        $stderr.puts "While writing the PID to file, unexpected #{e.class}: #{e}"
+        Process.kill "HUP", pid
+      end
+
+      # Try and read the existing pid from the pid file and signal the
+      # process. Returns true for a non blocking status.
+      def kill
+
+        opid  = OPTS.pidfile.to_i
+        Process.kill 'HUP', opid.to_i
+        true
+      rescue Errno::ENOENT
+        $stdout.puts "#{pidfile} did not exist: Errno::ENOENT"                        if $DEBUG
+        true
+      rescue Errno::ESRCH
+        $stdout.puts "The process #{opid} did not exist: Errno::ESRCH"                if $DEBUG
+        true
+      rescue Errno::EPERM
+        $stderr.puts "Lack of privileges to manage the process #{opid}: Errno::EPERM" if $DEBUG
+        false
+      rescue ::Exception => e
+        $stderr.puts "While signaling the PID, unexpected #{e.class}: #{e}"           if $DEBUG
+        false
+
+      end
+
+      # Send stdout and stderr to log files for the child process
+      def redirect
+
+        $stdin.reopen File.join('','dev','null')
+
+        out = File.new File.join(OPTS.tmp_folder_path, "out"), "a"
+        err = File.new File.join(OPTS.tmp_folder_path, "err"), "a"
+
+        $stdout.reopen out
+        $stderr.reopen err
+        $stdout.sync = $stderr.sync = true
+
+      end
+
+      def term_kill
+        unless OPTS.pidfile.nil?
+
+          begin
+
+            STDOUT.puts("PidFile found, processing...")   if $DEBUG
+            Process.kill('TERM', OPTS.pidfile.to_i)
+            return true
+
+          rescue Exception => ex
+
+            STDOUT.puts "Exception happened on terminating process: #{ex.class}, #{ex}" if $DEBUG
+            return false
+
           end
+
+        end
+      end
+
+      def terminate
+
+        # kill methods
+        app_killed= false
+        [:kill,:term_kill,:kill_by_name].each do |method_name|
+          app_killed= self.__send__ method_name
+          break if app_killed
         end
+        OPTS.pidfile= nil
+
+        return app_killed
+
+      end
+
+      def kill_by_name
+
+        # name switch
+        target_name ||= $0
+        $0 = "ruby_tmp_process"
+
 
-        # Attempts to write the pid of the forked process to the pid file.
-        def self.write pid, pidfile
-          DaemonOgre.create_on_filesystem pidfile
-          File.open pidfile, "a+" do |new_line|
-            new_line.write "#{pid}\n"
+        app_state= false
+
+        start_time= Time.now
+        while `ps aux | grep #{target_name}`.split(' ')[1] != ""  || (Time.now - start_time) < 6
+
+          begin
+
+            Process.kill "TERM",`ps aux | grep #{target_name}`.split(' ')[1].to_i
+
+            app_state= true
+          rescue Errno::ESRCH
+            $stdout.puts "The process #{target_name} did not exist: Errno::ESRCH"                 if $DEBUG
+            break
+          rescue Errno::EPERM
+            $stderr.puts "Lack of privileges to manage the process #{target_name}: Errno::EPERM"  if $DEBUG
+            break
+          rescue ::Exception => e
+            $stderr.puts "While signaling the PID, unexpected #{e.class}: #{e}"                   if $DEBUG
+            break
           end
-        rescue ::Exception => e
-          $stderr.puts "While writing the PID to file, unexpected #{e.class}: #{e}"
-          Process.kill "HUP", pid
+
+        end
+
+
+        # name switch back
+        begin
+          $0 = target_name
         end
 
-        # Try and read the existing pid from the pid file and signal the
-        # process. Returns true for a non blocking status.
-        def self.kill(pidfile)
-          opid = open("./#{pidfile}").read.strip.to_i
-          Process.kill 'HUP', opid.to_i
-          true
-        rescue Errno::ENOENT
-          $stdout.puts "#{pidfile} did not exist: Errno::ENOENT"                        if $DEBUG
-          true
-        rescue Errno::ESRCH
-          $stdout.puts "The process #{opid} did not exist: Errno::ESRCH"                if $DEBUG
-          true
-        rescue Errno::EPERM
-          $stderr.puts "Lack of privileges to manage the process #{opid}: Errno::EPERM" if $DEBUG
-          false
-        rescue ::Exception => e
-          $stderr.puts "While signaling the PID, unexpected #{e.class}: #{e}"           if $DEBUG
-          false
+        return app_state
+      end
+
+      def stop
+
+        self.terminate
+        ::Process.exit!
+
+      end
+
+      def init
+
+        if DARGV.terminate?
+          stop
         end
 
-        # Send stdout and stderr to log files for the child process
-        def self.redirect outfile, errfile
-          $stdin.reopen '/dev/null'
-          out = File.new outfile, "a"
-          err = File.new errfile, "a"
-          $stdout.reopen out
-          $stderr.reopen err
-          $stdout.sync = $stderr.sync = true
+        if DARGV.daemonize?
+          start( ::Kernel.fork )
         end
+
       end
-    end
 
+      alias :new :init
 
+    end
   end
+
+  class << self
+    def init
+      Daemon.init
+    end
+    # alias :new :init
+  end
+
 end