runnable 0.1.2 → 0.2.0

data/README.markdown

@@ -24,32 +24,30 @@ documentation of this gem can be generated using ```yardoc```. To do this use
 ```rake doc```.
 
 ## Return values
-Runnable uses another gems called ```Publisher```. It allow Runnable to fire 
-events that can be processed or ignored. When a command ends its execution, 
-Runnable always fire and event: ```:finish``` if commands finalized in a correct way 
-or ```:fail``` if an error ocurred. In case something went wrong and a ```:fail``` 
-events was fired, Runnable also provide an array containing the command return 
-value as the parameter of a SystemCallError exception and optionally others 
-exceptions ocurred at runtime.
+Runnable has two special methods which are called at the end of a command execution.  
+```:finish``` if commands finalized in a correct way and ```:fail``` if an error 
+ocurred. In case something went wrong and a ```:fail``` method is called, Runnable 
+also provide an array containing the command return value as the parameter of a 
+SystemCallError exception and optionally others exceptions ocurred at runtime.
 
-This is an example of how can we receive the return value of a command:
+This is an example of how we can receive the return value of a command:
 
     class LS < Runnable
-    end
-
-    my_command = LS.new
 
-    my_command.when :finish do
-      puts "Everything went better than expected :)"
-    end
+      def finish
+        puts "Everything went better than expected :)"
+      end
 
-    my_command.when :fail do |exceptions|
-      puts "Something went wrong"
-      exceptions.each do |exception|
-        puts exception.message
+      def failed( exceptions )
+        puts "Something went wrong :("
+        exceptions.each do |exception|
+          puts exception.message
+        end   
       end
+
     end
 
+    my_command = LS.new    
     my_command.run
 
 ## Custom exceptions

data/VERSION

@@ -1 +1 @@
-0.1.2
+0.2.0

data/lib/runnable.rb

@@ -19,8 +19,6 @@
 require 'runnable/gnu'
 require 'runnable/extended'
 
-require 'publisher'
-
 # Convert a executable command in a Ruby-like class
 # you are able to start, define params and send signals (like kill, or stop)
 #
@@ -32,12 +30,7 @@ require 'publisher'
 #   ls = LS.new
 #   ls.alh
 #   ls.run
-class Runnable
-  extend Publisher
-  
-  # Fires to know whats happening inside
-  can_fire :fail, :finish
-
+class Runnable  
   # Process id.
   attr_reader :pid
   # Process owner.
@@ -127,8 +120,6 @@ class Runnable
   
   # Start the execution of the command.
   # @return [nil]
-  # @fire :finish
-  # @fire :fail
   def run
     # Create a new mutex
     @pid_mutex = Mutex.new
@@ -172,11 +163,11 @@ class Runnable
       # In case of error add an Exception to the @excep_array
       @excep_array << SystemCallError.new( exit_status ) if exit_status != 0
       
-      # Fire signals according to the exit code
+      # Call methods according to the exit code
       if @excep_array.empty?
-        fire :finish
+        finish
       else
-        fire :fail, @excep_array
+        failed( @excep_array )
       end
       
       # This instance is finished and we remove it
@@ -343,6 +334,21 @@ class Runnable
     {}
   end
   
+  # @abstract
+  # Method called when command ends with no erros.
+  # This method is a hook so it should be overwritten in child classes.
+  # @return [nil]
+  def finish
+  end
+
+  # @abstract
+  # Method called when command executions fail.
+  # This method is a hook so it should be overwritten in child classes.
+  # @param [Array] exceptions Array containing exceptions raised during the command execution.
+  # @return [nil]
+  def failed( exceptions )
+  end
+
   protected
   
   # Send the desired signal to the command.

data/runnable.gemspec

@@ -0,0 +1,61 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{runnable}
+  s.version = "0.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Rafael García", "Luis Ciudad", "Pedro Navajas", "Javier Aranda"]
+  s.date = %q{2011-08-03}
+  s.description = %q{Convert a executable command in a Ruby-like class you are able to start, define params and send signals (like kill, or stop)}
+  s.email = ["rgarcia@nosolosoftware.biz", "lciudad@nosolosoftware.biz", "pnavajas@nosolosoftware.biz", "jaranda@nosolosoftware.biz"]
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    "COPYING",
+    "README.markdown",
+    "VERSION",
+    "lib/runnable.rb",
+    "lib/runnable/command_parser.rb",
+    "lib/runnable/extended.rb",
+    "lib/runnable/gnu.rb",
+    "runnable.gemspec"
+  ]
+  s.homepage = %q{http://github.com/nosolosoftware/runnable}
+  s.licenses = ["GPL-3"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.7.2}
+  s.summary = %q{A Ruby gem for execute and control system commands}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rake>, [">= 0.8.7"])
+      s.add_development_dependency(%q<yard>, [">= 0.6.8"])
+      s.add_development_dependency(%q<rspec>, [">= 2.5.0"])
+      s.add_development_dependency(%q<cucumber>, [">= 0.10.2"])
+      s.add_development_dependency(%q<jeweler>, [">= 1.6.0"])
+      s.add_development_dependency(%q<bluecloth>, [">= 2.1.0"])
+    else
+      s.add_dependency(%q<rake>, [">= 0.8.7"])
+      s.add_dependency(%q<yard>, [">= 0.6.8"])
+      s.add_dependency(%q<rspec>, [">= 2.5.0"])
+      s.add_dependency(%q<cucumber>, [">= 0.10.2"])
+      s.add_dependency(%q<jeweler>, [">= 1.6.0"])
+      s.add_dependency(%q<bluecloth>, [">= 2.1.0"])
+    end
+  else
+    s.add_dependency(%q<rake>, [">= 0.8.7"])
+    s.add_dependency(%q<yard>, [">= 0.6.8"])
+    s.add_dependency(%q<rspec>, [">= 2.5.0"])
+    s.add_dependency(%q<cucumber>, [">= 0.10.2"])
+    s.add_dependency(%q<jeweler>, [">= 1.6.0"])
+    s.add_dependency(%q<bluecloth>, [">= 2.1.0"])
+  end
+end
+

metadata

@@ -2,7 +2,7 @@
 name: runnable
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors: 
 - "Rafael Garc\xC3\xADa"
@@ -13,85 +13,74 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-05-09 00:00:00 Z
+date: 2011-08-03 00:00:00 Z
 dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: publisher
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        version: 1.1.1
-  type: :runtime
-  prerelease: false
-  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: rake
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
         version: 0.8.7
   type: :development
   prerelease: false
-  version_requirements: *id002
+  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: yard
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
         version: 0.6.8
   type: :development
   prerelease: false
-  version_requirements: *id003
+  version_requirements: *id002
 - !ruby/object:Gem::Dependency 
   name: rspec
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
         version: 2.5.0
   type: :development
   prerelease: false
-  version_requirements: *id004
+  version_requirements: *id003
 - !ruby/object:Gem::Dependency 
   name: cucumber
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
         version: 0.10.2
   type: :development
   prerelease: false
-  version_requirements: *id005
+  version_requirements: *id004
 - !ruby/object:Gem::Dependency 
   name: jeweler
-  requirement: &id006 !ruby/object:Gem::Requirement 
+  requirement: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
         version: 1.6.0
   type: :development
   prerelease: false
-  version_requirements: *id006
+  version_requirements: *id005
 - !ruby/object:Gem::Dependency 
   name: bluecloth
-  requirement: &id007 !ruby/object:Gem::Requirement 
+  requirement: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
         version: 2.1.0
   type: :development
   prerelease: false
-  version_requirements: *id007
+  version_requirements: *id006
 description: Convert a executable command in a Ruby-like class you are able to start, define params and send signals (like kill, or stop)
 email: 
 - rgarcia@nosolosoftware.biz
@@ -112,6 +101,7 @@ files:
 - lib/runnable/command_parser.rb
 - lib/runnable/extended.rb
 - lib/runnable/gnu.rb
+- runnable.gemspec
 homepage: http://github.com/nosolosoftware/runnable
 licenses: 
 - GPL-3
@@ -125,7 +115,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 2247934159745161744
+      hash: -4434214219882422992
       segments: 
       - 0
       version: "0"