dctl 1.0.0 → 1.0.1

data/CHANGELOG

@@ -1,3 +1,8 @@
+*1.0.1* (08th April, 2005)		Bruno Carnazzi		<mailto:bcarnazzi@gmail.com>
+	* updated Rakefile (and included gemspec)
+	* added a check on daemon for valid app_path (daemon_test.rb updated)
+	* updated documentation
+
 *1.0.0* (07th April, 2005)		Bruno Carnazzi		<mailto:bcarnazzi@gmail.com>
 	* Full rewrite from scratch
 	* Multiple daemon instances does not exists anymore

data/README

@@ -4,7 +4,7 @@ dctl is a small script for providing daemon functionnalty (start, stop, ...)
 to non-daemon process or script, with automatic handling of pidfiles.
 dctl is mainly an extended rewrite of the daemons[http://rubyforge.org/projects/daemons/]
 project for learning purpose.
-It is designed to be small and smart and I try to apply XP's good practice (unit test)
+It is designed to be small and smart ("less-is-more" philosophy), generic, and well-tested. 
 
 Major features:
 * Convert any executable file with endless lifecycle into a controllable daemon
@@ -14,7 +14,7 @@ Major features:
 
 == Examples
 
-=== Start a daemon with redirection of stdout
+=== Start a daemon with redirection of stdout in file 'out'
   % dctl start -oout test/infinite.sh
 
 === Get the status of a daemon
@@ -32,27 +32,35 @@ The latest version of dctl can be found at :
 
 == Installation
 
-The prefered method of installing dctl is currently through its setup.rb file.
-As dctl stands on cmdparser, you need to have cmdparser installed before.
-I plan to make a GEM for dctl soon.
+As dctl stands on cmdparse[http://rubyforge.org/projects/cmdparse/], you need to have cmdparse[http://rubyforge.org/projects/cmdparse/] installed before.
 
-from dctl distribution directory:
-  % [sudo] ruby setup.rb
+Installation *with* RubyGems:
+  $ su
+  # gem install dctl
+  
+Installation *without* RubyGems:
+  $ tar xfz dctl-x.x.x.tar.gz
+  $ cd dctl-x.x.x
+  $ su
+  # ruby setup.rb
 
-=== Notes
-If you installed cmdparser as a gem, please check your RUBYOPTS which should looks like:
-  % echo $RUBYOPTS
- -rubygems
 
-If not, do the following :
-  % export RUBYOPTS="-rubygems"
+== Notes
+
+Please note that dctl test suite only succeeds if launched by a non-root user !
+
+
+== Future
+
+I'm thinking about dctl as a system service manager...
 
 
 == Author
 
 Written in 2005 by Bruno Carnazzi <mailto:bcarnazzi@gmail.com>
 
-== License
+
+== License and copyright
 
 dctl is free software. You can redistribute it under the terms specified in
 the COPYING file of the Ruby distribution.
@@ -61,3 +69,4 @@ the COPYING file of the Ruby distribution.
 == Feedback and other resources
 
 At http://rubyforge.org/projects/dctl/
+

data/Rakefile

@@ -59,7 +59,7 @@ spec = Gem::Specification.new do |s|
 
   s.files = [ "Rakefile", "setup.rb", "README", "TODO", "CHANGELOG" ]
   dist_dirs.each do |dir|
-    s.files = s.files + Dir.glob( "#{dir}/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
+    s.files = s.files + Dir.glob( "#{dir}/**/*" ).delete_if { |item| item.include?("\.svn") or item.include?("CVS") }
   end
   s.executables = ['dctl']
   s.bindir = 'bin'
@@ -77,7 +77,7 @@ spec = Gem::Specification.new do |s|
 
   s.author = "Bruno Carnazzi"
   s.email = "bcarnazzi@gmail.com"
-  s.homepage = "http://rubyforge.org/project/dctl/"
+  s.homepage = "http://rubyforge.org/projects/dctl/"
   s.rubyforge_project = "dctl"
 end
   

data/TODO

@@ -1,5 +1,5 @@
 - write a *real* todo file -> DONE (05/04/05)
 - write a bit of rdoc -> DONE (05/04/05)
 - write a 'status' command -> DONE (05/04/05)
-- write a 'rakefile'
-- package as a gem
+- write a 'rakefile' -> DONE (08/04/05)
+- package as a gem -> DONE (08/04/05)

data/lib/dctl/daemon.rb

@@ -10,6 +10,9 @@ module Dctl
     def initialize(cmd, pidpath)
       @app_path = Daemon::which cmd
       @app_path = File.expand_path cmd if not @app_path
+      raise Errno::EISDIR, @app_path if File.directory? @app_path
+      raise Errno::ENOENT, @app_path until File.file? @app_path
+      raise Errno::EACCES, @app_path until File.executable? @app_path
       @pidfile = PidFile.new pidpath, File.basename(cmd)
     end
     

data/lib/dctl/metainf.rb

@@ -1,6 +1,6 @@
 # This file contains informations about Dctl current release.
 
 module Dctl
-  VERSION = [1, 0, 0]
+  VERSION = [1, 0, 1]
   RELEASE = 'Leonard release'
 end

data/test/daemon_test.rb

@@ -20,20 +20,19 @@ class DaemonTest < Test::Unit::TestCase
   
   def test_run
     assert_raise(Errno::ENOENT) { Dctl::Daemon.new('idontexist', '.').run }
-    assert_raise(Errno::EACCES) { Dctl::Daemon.new('/bin', '.').run }
+    assert_raise(Errno::EISDIR) { Dctl::Daemon.new('/bin', '.').run }
     assert_raise(Errno::EACCES) { Dctl::Daemon.new('/etc/passwd', '.').run }
   end
   
   def test_stop
-    fork { Dctl::Daemon.new('test/infinite.sh', '.').start }
-    sleep 1
+    fork { Dctl::Daemon.new('test/infinite.sh', '.').start } and sleep 1
     assert_nothing_thrown { Dctl::Daemon.new('test/infinite.sh', '.').stop }
     assert Dir['*.pid'].empty?
     assert_raise(Errno::ENOENT) { Dctl::Daemon.new('test/infinite.sh', '.').stop }    
   end
   
   def test_concurrent
-    puts '1' ; fork { Dctl::Daemon.new('test/infinite.sh', '.').start }
+    puts '1' ; fork { Dctl::Daemon.new('test/infinite.sh', '.').start } and sleep 1
     puts '2' ; assert_raise(Errno::EEXIST) { Dctl::Daemon.new('test/infinite.sh', '.').run }
     puts '3' ; assert_nothing_thrown { Dctl::Daemon.new('test/infinite.sh', '.').stop }
     assert Dir['*.pid'].empty?

metadata

@@ -3,13 +3,13 @@ rubygems_version: 0.8.10
 specification_version: 1
 name: dctl
 version: !ruby/object:Gem::Version 
-  version: 1.0.0
-date: 2005-04-07
+  version: 1.0.1
+date: 2005-04-08
 summary: "dctl - a daemon controller written in Ruby"
 require_paths: 
   - lib
 email: bcarnazzi@gmail.com
-homepage: http://rubyforge.org/project/dctl/
+homepage: http://rubyforge.org/projects/dctl/
 rubyforge_project: dctl
 description: "dctl is a small script for providing daemon functionnalty (start, stop, ...) to
   non-daemon process or script, with automatic handling of pidfiles."