elf 0.0.1.alpha → 0.0.1

data/README.md

@@ -18,7 +18,59 @@ Or install it yourself as:
 
 ## Usage
 
-Elves are creatures to manage background processes.
+This code will run 4 parallel processes and will work about 10 seconds
+
+```ruby
+require 'elf'
+
+Elf.new do |elf|
+  elf.fork("sleep 10")
+  elf.fork("sleep 10")
+  elf.fork("sleep 10")
+  elf.fork("sleep 10")
+end
+```
+
+And this will run each process one by one
+
+```ruby
+require 'elf'
+
+Elf.new do |elf|
+  elf.sync("sleep 10")
+  elf.sync("sleep 10")
+  elf.sync("sleep 10")
+  elf.sync("sleep 10")
+end
+```
+
+So why do we need this?
+
+For example you have got some slow rake tasks, which should be started in particular order. Some of them could be started in parallel, while other shoud work synchronously.
+
+You have got this task:
+
+1. Download few big XML files from some server
+2. Parse them and save to database
+3. Then you need to combine all this new data and get new big XML file
+
+```ruby
+Elf.new do |elf|
+  # let's asynchronously download files and after file is downloaded we will start parse it
+  elf.fork("wget file1.xml") do |f|
+    f.on_success{ elf.fork("rake some_parser_rake_task") }
+  end
+  elf.fork("wget file2.xml") do |f|
+    f.on_success{ elf.fork("rake some_parser_rake_task") }
+  end
+  elf.fork("wget file3.xml") do |f|
+    f.on_success{ elf.fork("rake some_parser_rake_task") }
+  end
+
+  # Here we are waiting while all data downloaded and parsed and then start new rake task for generating new xml
+  elf.sync("rake generate_new_xml")
+end
+```
 
 ## Contributing
 

data/lib/elf/child.rb

@@ -1,31 +1,39 @@
 module Elf
   class Child
+    attr_reader :success
+
     def initialize(cmd)
       @cmd = cmd
-      fire
     end
 
-    def success=(&blk)
+    def on_success(&blk)
       @success = blk
-      success if @status.exitstatus == 0
+      if @status && @status.exitstatus == 0
+        success
+      end
     end
 
-    def success
+    def fire_success
       puts "Success: #{@cmd}"
-      @success.call if @success
+      if @success
+        @success.call
+      end
     end
 
-    def error
+    def fire_error
       puts "Failed: #{@cmd}"
     end
 
     def fire
+      puts "Fired: #{@cmd}"
       fork_pid = ::Process.fork do
-        puts "Fired: #{@cmd}"
         exec @cmd
       end
+      fake = fork{ "sleep 10" }
       pid, @status = ::Process.waitpid2(fork_pid)
-      @status.exitstatus == 0 ? success : error
+      @status.exitstatus == 0 ? fire_success : fire_error
+      ::Process.kill(9, fake) rescue nil
+      ::Process.waitall
     end
   end
 end

data/lib/elf/fork.rb

@@ -1,10 +1,12 @@
 module Elf
   class Fork < Child
-    alias :sync_fire :fire
 
+    #
+    # We can't use Thread's here. because they don't work :)
+    #
     def fire
-      fork do
-        sync_fire
+      pid = fork do
+        super
       end
     end
 

data/lib/elf/process.rb

@@ -1,16 +1,20 @@
 module Elf
   class Process
     def initialize(&blk)
-      blk.call(self)
-      st = ::Process.waitall
+      pid = blk.call(self)
+      ::Process.waitall
     end
 
     def fork(cmd)
-      Elf::Fork.new(cmd)
+      elf = Elf::Fork.new(cmd)
+      yield elf if block_given?
+      pid = elf.fire
     end
 
     def sync(cmd)
-      Elf::Sync.new(cmd)
+      elf = Elf::Sync.new(cmd)
+      yield elf if block_given?
+      elf.fire
     end
   end
 end

data/lib/elf/sync.rb

@@ -1,5 +1,10 @@
 module Elf
   class Sync < Child
 
+    def fire
+      ::Process.waitall
+      super
+    end
+
   end
 end

data/lib/elf/version.rb

@@ -1,3 +1,3 @@
 module Elf
-  VERSION = "0.0.1.alpha"
+  VERSION = "0.0.1"
 end

data/spec/elf/process_spec.rb

@@ -16,8 +16,82 @@ describe Elf::Process do
     start = Time.now
     Elf::Process.new do |elf|
       elf.sync("sleep 1")
-      elf.sync("sleep 2")
-      elf.sync("sleep 3")
+      elf.sync("sleep 1")
+      elf.sync("sleep 1")
+    end
+    (Time.now-start).to_i.must_equal(3)
+  end
+
+  it "should run 4 combined processes" do
+    start = Time.now
+    Elf::Process.new do |elf|
+      elf.fork("sleep 1")
+      elf.fork("sleep 1")
+      elf.sync("sleep 1")
+      elf.sync("sleep 1")
+      elf.fork("sleep 1")
+    end
+    (Time.now-start).to_i.must_equal(4)
+  end
+
+  it "should fire success process" do
+    start = Time.now
+    Elf::Process.new do |elf|
+      elf.fork("sleep 1") do |fork|
+        fork.on_success do
+          elf.fork("sleep 1")
+        end
+      end
+      elf.sync("sleep 1") do |fork|
+        fork.on_success do
+          elf.sync("sleep 1")
+        end
+      end
+      elf.sync("sleep 1")
+    end
+    (Time.now-start).to_i.must_equal(5)
+  end
+
+  it "should work with deep nested success jobs" do
+    start = Time.now
+    Elf::Process.new do |elf|
+      elf.fork("sleep 1") do |f1|
+        f1.on_success do
+          elf.fork("sleep 1") do |f2|
+            f2.on_success do
+              elf.fork("sleep 1") do |f3|
+                f3.on_success do
+                  elf.fork("sleep 1")
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+    (Time.now-start).to_i.must_equal(4)
+  end
+
+  it "should work with deep nested complex sync async success jobs" do
+    start = Time.now
+    Elf::Process.new do |elf|
+      elf.fork("sleep 1") do |f1|
+        f1.on_success do
+          elf.fork("sleep 1") do |f2|
+            f2.on_success do
+              elf.fork("sleep 1") do |f3|
+                f3.on_success do
+                  elf.fork("sleep 1")
+                  elf.fork("sleep 1")
+                  elf.fork("sleep 1")
+                end
+              end
+            end
+          end
+          elf.sync("sleep 1")
+          elf.fork("sleep 1")
+        end
+      end
     end
     (Time.now-start).to_i.must_equal(6)
   end

metadata

@@ -1,8 +1,8 @@
 --- !ruby/object:Gem::Specification
 name: elf
 version: !ruby/object:Gem::Version
-  version: 0.0.1.alpha
-  prerelease: 6
+  version: 0.0.1
+  prerelease: 
 platform: ruby
 authors:
 - Petr Yanovich
@@ -47,9 +47,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>'
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.15